[{"data":1,"prerenderedAt":718},["ShallowReactive",2],{"biblioteca-\u002Fbiblioteca\u002Fclaude-code-setup-inicial":3},{"id":4,"title":5,"author":6,"body":7,"cover":701,"description":702,"extension":703,"meta":704,"navigation":705,"nivel":706,"path":707,"publishedAt":708,"seo":709,"stem":710,"tags":711,"__hash__":717},"biblioteca\u002Fbiblioteca\u002Fclaude-code-setup-inicial.md","Claude Code recién instalado, la configuración que uso yo","Miguel Santa",{"type":8,"value":9,"toc":681},"minimark",[10,17,35,40,43,46,49,52,55,59,64,67,72,94,99,113,117,131,134,138,141,152,155,167,243,254,292,294,298,305,308,312,325,338,347,371,373,377,384,387,396,413,422,438,452,480,491,493,501,504,510,513,517,547,551,557,563,566,573,588,591,601,603,607,610,616,622,644,654,658,661,664,667,677],[11,12],"youtube-cta",{"channel":13,"subtitle":14,"title":15,"url":16},"@Santa_lA","Míralo mientras lees. Te ahorra tiempo y vas viendo cada paso del setup.","Esta guía va con video en el canal","https:\u002F\u002Fwww.youtube.com\u002F@Santa_lA",[18,19,22,26,32],"callout",{"title":20,"type":21},"¿Apurado? Que Claude te haga un resumen rápido.","claude",[23,24,25],"p",{},"Copia el link de esta página y pégalo en Claude (claude.ai, el escritorio o la app). Le pides algo así:",[23,27,28],{},[29,30,31],"strong",{},"\"Resúmeme esta guía en 5 puntos. Dime qué de este setup debería aplicar primero si recién instalé Claude Code.\"",[23,33,34],{},"En 30 segundos tienes la lectura corta. Después te devuelves a la sección que te llame.",[36,37,39],"h2",{"id":38},"por-qué-esta-guía-existe","Por qué esta guía existe",[23,41,42],{},"Acabas de instalar Claude Code. Abres la terminal. Aparece un cursor parpadeando. Ya está.",[23,44,45],{},"Funciona. Pero no te dice nada. No sabes en qué modelo estás, en qué carpeta, en qué branch. No sabes cuánto va costando la sesión. No sabes si la ventana de contexto se está llenando. Trabajas a ciegas.",[23,47,48],{},"Esta guía cierra esa brecha. Cuatro cambios en orden. Veinte minutos. Pensada para gente que acaba de llegar y todavía no quiere meterse con cosas más finas como skills, MCPs o subagentes.",[23,50,51],{},"Al final tienes una terminal que sí te informa.",[53,54],"hr",{},[36,56,58],{"id":57},"_1-el-statusline-la-barra-que-sí-te-informa","1 · El statusline (la barra que sí te informa)",[60,61,63],"h3",{"id":62},"qué-vas-a-ver-al-final-de-esta-sección","Qué vas a ver al final de esta sección",[23,65,66],{},"El statusline es una barra de dos líneas que aparece en la parte de abajo de tu terminal. Vive ahí, todo el rato, mientras trabajas con Claude. Te muestra:",[23,68,69],{},[29,70,71],{},"Línea 1",[73,74,75,79,82,85,88,91],"ul",{},[76,77,78],"li",{},"Modelo activo (Opus, Sonnet, Haiku)",[76,80,81],{},"Carpeta donde estás",[76,83,84],{},"Branch de git",[76,86,87],{},"Líneas añadidas y borradas en la sesión",[76,89,90],{},"Costo en USD acumulado",[76,92,93],{},"Duración de la sesión",[23,95,96],{},[29,97,98],{},"Línea 2",[73,100,101,104,107,110],{},[76,102,103],{},"Barra de progreso del contexto (verde abajo de 60%, amarilla entre 60 y 85, roja arriba de 85)",[76,105,106],{},"Tokens usados sobre el límite",[76,108,109],{},"Hora actual en Bogotá, Santiago y Madrid",[76,111,112],{},"Tasa USD a COP del día",[60,114,116],{"id":115},"por-qué-importa","Por qué importa",[73,118,119,122,125,128],{},[76,120,121],{},"Evitas commitear en la branch equivocada.",[76,123,124],{},"Te das cuenta cuando estás gastando Opus en una tarea que merecía Haiku.",[76,126,127],{},"Ves la ventana de contexto llenándose antes de que el agente empiece a olvidar.",[76,129,130],{},"Tienes a la vista cuánto va costando la sesión, sin abrir el dashboard de Anthropic.",[132,133],"diagram-statusline-live",{},[60,135,137],{"id":136},"cómo-lo-instalas","Cómo lo instalas",[23,139,140],{},"Le pasas este prompt a Claude Code. Tal cual. Él te crea el script.",[142,143,148],"pre",{"className":144,"code":146,"language":147},[145],"language-text","Quiero un statusline custom para Claude Code en mi Mac. Que sea un script bash en `~\u002F.claude\u002Fstatusline.sh` y se registre en `~\u002F.claude\u002Fsettings.json` en `statusLine.command`.\n\nQue muestre 2 líneas:\n\nLínea 1: modelo actual, nombre de la carpeta donde estoy, branch git, líneas añadidas y borradas en la sesión, costo USD acumulado, duración de la sesión. Separados por `|` en gris.\n\nLínea 2: barra de progreso del contexto (verde \u003C60%, amarillo 60-85%, rojo >85%), tokens usados sobre límite, hora actual en Bogotá, Santiago y Madrid, tasa USD→COP del día (cacheada 1 hora desde open.er-api.com).\n\nColores ANSI 24-bit. Iconos emoji para cada campo (🤖 modelo, 🌿 branch, 💰 costo, etc.). Detecta automáticamente si el modelo es de 1M de contexto y ajusta el límite a 1.000.000, si no, 200.000.\n\nLéeme el script entero y déjamelo listo para probar.\n","text",[149,150,146],"code",{"__ignoreMap":151},"",[23,153,154],{},"Pasos después de pegar el prompt:",[156,157,160],"step-card",{"number":158,"title":159},"1","Claude te crea el script",[23,161,162,163,166],{},"Te lo escribe en ",[149,164,165],{},"~\u002F.claude\u002Fstatusline.sh",". Te muestra el contenido entero antes de guardarlo. Léelo. Si entiendes 70% de lo que hace, está bien.",[156,168,171,178],{"number":169,"title":170},"2","Registras la ruta en settings.json",[23,172,173,174,177],{},"Claude lo hace en el mismo paso, pero verifica. Abre ",[149,175,176],{},"~\u002F.claude\u002Fsettings.json"," y asegúrate de que aparece algo así:",[142,179,183],{"className":180,"code":181,"language":182,"meta":151,"style":151},"language-json shiki shiki-themes github-light github-dark","{\n  \"statusLine\": {\n    \"type\": \"command\",\n    \"command\": \"~\u002F.claude\u002Fstatusline.sh\"\n  }\n}\n","json",[149,184,185,194,204,220,231,237],{"__ignoreMap":151},[186,187,190],"span",{"class":188,"line":189},"line",1,[186,191,193],{"class":192},"sVt8B","{\n",[186,195,197,201],{"class":188,"line":196},2,[186,198,200],{"class":199},"sj4cs","  \"statusLine\"",[186,202,203],{"class":192},": {\n",[186,205,207,210,213,217],{"class":188,"line":206},3,[186,208,209],{"class":199},"    \"type\"",[186,211,212],{"class":192},": ",[186,214,216],{"class":215},"sZZnC","\"command\"",[186,218,219],{"class":192},",\n",[186,221,223,226,228],{"class":188,"line":222},4,[186,224,225],{"class":199},"    \"command\"",[186,227,212],{"class":192},[186,229,230],{"class":215},"\"~\u002F.claude\u002Fstatusline.sh\"\n",[186,232,234],{"class":188,"line":233},5,[186,235,236],{"class":192},"  }\n",[186,238,240],{"class":188,"line":239},6,[186,241,242],{"class":192},"}\n",[156,244,247],{"number":245,"title":246},"3","Reinicias Claude Code",[23,248,249,250,253],{},"Cierras y abres. La barra aparece abajo. Si no aparece, le dices a Claude \"el statusline no se ve, qué falló\" y él revisa permisos del script (",[149,251,252],{},"chmod +x",") y rutas.",[255,256,261,278],"compare-grid",{"bad-label":257,"bad-title":258,"good-label":259,"good-title":260},"Statusline default","Lo que viene de fábrica","Statusline custom","Lo que tienes después",[262,263,264],"template",{"v-slot:bad":151},[73,265,266,269,272,275],{},[76,267,268],{},"Una sola línea minimalista",[76,270,271],{},"Modelo y poco más",[76,273,274],{},"No ves contexto, costo ni branch",[76,276,277],{},"Trabajas sin tablero",[262,279,280,283,286,289],{"v-slot:good":151},[76,281,282],{},"Dos líneas con todo lo que importa",[76,284,285],{},"Costo, contexto, branch y modelo al frente",[76,287,288],{},"Tres husos horarios visibles",[76,290,291],{},"Tasa COP del día como bonus",[53,293],{},[36,295,297],{"id":296},"_2-los-3-modos-de-operación","2 · Los 3 modos de operación",[23,299,300,301,304],{},"El atajo más infrautilizado de Claude Code es ",[149,302,303],{},"Shift+Tab",". Cicla entre tres modos. Cada uno cambia cómo se comporta el agente con tus archivos.",[306,307],"diagram-modos-claude-code",{},[60,309,311],{"id":310},"cuándo-usar-cuál","Cuándo usar cuál",[156,313,315,318],{"number":158,"title":314},"Default mode · te pregunta antes de actuar",[23,316,317],{},"Es el de fábrica. Antes de tocar un archivo o ejecutar un comando, te pide permiso. Lento, pero seguro.",[23,319,320,321,324],{},"Lo uso para: repos delicados, código de cliente, cuando estoy aprendiendo una herramienta nueva y quiero ver cada paso. También cuando Claude está trabajando con ",[149,322,323],{},"git"," en algo que no quiero perder.",[156,326,328,331],{"number":169,"title":327},"Auto mode · ejecuta directo",[23,329,330],{},"Mi modo del día a día. Claude crea archivos, los modifica, corre comandos sin pedirte permiso cada vez.",[23,332,333,334,337],{},"Lo uso para: refactors pequeños, escribir componentes, generar contenido, mover archivos. Cualquier cosa donde el daño máximo posible es un ",[149,335,336],{},"git reset --hard",".",[156,339,341,344],{"number":245,"title":340},"Plan mode · te muestra el plan antes de tocar nada",[23,342,343],{},"Claude escribe el plan en bloques. Lo lees. Lo apruebas o lo ajustas. Recién ahí ejecuta.",[23,345,346],{},"Lo uso para: refactors grandes, migraciones, cuando voy a tocar varios archivos a la vez, cuando estoy explorando un repo nuevo y quiero entender antes de mover. Hace lento el arranque, pero te salva de tareas mal escopadas.",[18,348,351],{"title":349,"type":350},"Regla mental que uso","tip",[73,352,353,359,365],{},[76,354,355,356],{},"¿La tarea es chiquita y reversible? ",[29,357,358],{},"Auto.",[76,360,361,362],{},"¿La tarea cruza varios archivos o módulos? ",[29,363,364],{},"Plan.",[76,366,367,368],{},"¿Estoy trabajando en código que no es mío? ",[29,369,370],{},"Default.",[53,372],{},[36,374,376],{"id":375},"_3-comandos-que-uso-todos-los-días","3 · Comandos que uso todos los días",[23,378,379,380,383],{},"Tecleas ",[149,381,382],{},"\u002F"," dentro de Claude Code y se despliega un menú. Estos son los 7 que más uso. Los otros casi no los toco.",[385,386],"diagram-comando-slash-en-vivo",{},[156,388,390,393],{"number":158,"title":389},"\u002Fmodel · cambiar de modelo sin cerrar la sesión",[23,391,392],{},"Opus para tareas pesadas (plan grande, decisión arquitectónica). Sonnet para el día a día (escribir código con un buen plan). Haiku para tareas mecánicas (búsquedas, renames, leer muchos archivos rápido).",[23,394,395],{},"Lo lanzo cuando arranco una tarea distinta. Empezar Opus, terminar Haiku.",[156,397,399,406],{"number":169,"title":398},"\u002Frewind · devolverte a un punto anterior",[23,400,401,402,405],{},"Claude se metió en un camino malo. Borró algo que no debía, o reescribió mal un archivo. ",[149,403,404],{},"\u002Frewind"," te deja volver tres turnos atrás sin perder la sesión.",[23,407,408,409,412],{},"Es como ",[149,410,411],{},"Ctrl+Z"," pero para tu chat entero. El que más me ha salvado de pánicos.",[156,414,416,419],{"number":245,"title":415},"\u002Feffort · ajustar profundidad de pensamiento",[23,417,418],{},"Sube el effort cuando el problema requiere pensar (deuda técnica, debugging raro, decisión de arquitectura). Bájalo cuando la tarea es trivial (rename, mover archivos, escribir un README).",[23,420,421],{},"Effort alto gasta más tokens pero piensa más. Effort bajo va al grano.",[156,423,426,429],{"number":424,"title":425},"4","\u002Fclear · limpiar el contexto sin cerrar",[23,427,428],{},"La conversación se enredó. Cambiaste de tarea. Quieres arrancar fresco pero sin reabrir Claude.",[23,430,431,434,435,337],{},[149,432,433],{},"\u002Fclear"," borra el historial de la sesión actual y te deja con el contexto vacío. Es el comando que más uso después de ",[149,436,437],{},"\u002Fmodel",[156,439,442,449],{"number":440,"title":441},"5","\u002Fcompact · comprimir el contexto",[23,443,444,445,448],{},"La barra del statusline está en rojo. Llevas una hora en la misma sesión y no quieres perder el hilo. ",[149,446,447],{},"\u002Fcompact"," resume todo lo que llevas y arranca con el resumen.",[23,450,451],{},"Pierdes detalle. Mantienes la dirección. Útil cuando vas a la mitad de un refactor largo y todavía falta.",[156,453,456,459],{"number":454,"title":455},"6","\u002Fpermissions · qué tools corren sin pedir permiso",[23,457,458],{},"Acá decides qué comandos puede ejecutar Claude en automático y cuáles te tiene que preguntar.",[23,460,461,462,465,466,469,470,469,473,469,476,479],{},"Lo abro la primera vez que instalo Claude Code en una máquina nueva, configuro los ",[149,463,464],{},"Bash"," permitidos que uso a diario (",[149,467,468],{},"git status",", ",[149,471,472],{},"git diff",[149,474,475],{},"npm install",[149,477,478],{},"ls","), y lo dejo así.",[156,481,484],{"number":482,"title":483},"7","\u002Fagents · ver agentes disponibles",[23,485,486,487,490],{},"Lista los agentes que tienes definidos en ",[149,488,489],{},".claude\u002Fagents\u002F",". Si estás arrancando, esto va a salir vacío. Es ok. Más adelante, cuando empieces a crear agentes pre-definidos, los ves todos acá.",[53,492],{},[36,494,496,497,500],{"id":495},"_4-background-agents-bg","4 · Background agents (",[149,498,499],{},"\u002Fbg",")",[23,502,503],{},"A veces necesitas que Claude haga tres cosas a la vez. Investigar una librería, refactorizar un componente y generar copy para un post. Si las haces en serie, te bloqueas. Si las mandas en paralelo, sigues conversando en el chat principal mientras los otros trabajan.",[23,505,506,507,509],{},"Eso es ",[149,508,499],{},". Lanza la tarea a un agente nuevo, en background, y tu sesión principal queda libre.",[511,512],"diagram-bg-agents-parallel",{},[60,514,516],{"id":515},"cuándo-lo-uso","Cuándo lo uso",[73,518,519,525,531,537],{},[76,520,521,524],{},[29,522,523],{},"Investigación larga."," \"Lee la documentación de Nuxt 4 y resume los breaking changes vs Nuxt 3.\" Tres minutos de lectura mía esperando, vs cinco segundos de pasarlo al background.",[76,526,527,530],{},[29,528,529],{},"Refactor pesado."," \"Migra estos 8 componentes a la nueva API.\" Lo mando al background y sigo escribiendo la guía mientras tanto.",[76,532,533,536],{},[29,534,535],{},"Generación que tarda."," \"Genera 5 versiones de copy para este hero.\" Lo dejo trabajando y reviso cuando vuelve.",[76,538,539,542,543,546],{},[29,540,541],{},"Búsquedas en bibliotecas grandes."," \"Encuentra todas las referencias a ",[149,544,545],{},"oldFunction"," y lista archivos.\" Background. Sigo en lo mío.",[60,548,550],{"id":549},"cómo-se-invoca","Cómo se invoca",[23,552,553,554,556],{},"Dentro de una sesión de Claude Code, escribes ",[149,555,499],{}," y le pides la tarea:",[142,558,561],{"className":559,"code":560,"language":147},[145],"> \u002Fbg investiga las 3 librerías más usadas para validación de formularios en Vue 3 y resume pros\u002Fcontras\n",[149,562,560],{"__ignoreMap":151},[23,564,565],{},"Claude lo dispara a un agente nuevo. Tú sigues chateando.",[23,567,568,569,572],{},"Para ver el estado de los agentes que tienes corriendo, abres el ",[29,570,571],{},"panel de agentes"," (Agent View). Desde una terminal normal:",[142,574,578],{"className":575,"code":576,"language":577,"meta":151,"style":151},"language-bash shiki shiki-themes github-light github-dark","claude agents\n","bash",[149,579,580],{"__ignoreMap":151},[186,581,582,585],{"class":188,"line":189},[186,583,21],{"class":584},"sScJk",[186,586,587],{"class":215}," agents\n",[23,589,590],{},"Te muestra todos los agentes activos, cuánto llevan corriendo, y cuáles ya entregaron resultado.",[18,592,595],{"title":593,"type":594},"Versión mínima","info",[23,596,597,598,337],{},"Agent View viene en Claude Code 2.1.142 o superior. Si tu versión es anterior, actualiza con ",[149,599,600],{},"npm install -g @anthropic-ai\u002Fclaude-code",[53,602],{},[36,604,606],{"id":605},"cierre","Cierre",[23,608,609],{},"Si llegaste hasta acá, tu Claude Code ya no te deja a ciegas. Checklist final:",[156,611,613],{"number":158,"title":612},"Statusline visible al final de tu terminal",[23,614,615],{},"Dos líneas, todo el rato. Modelo, branch, costo, contexto, husos horarios, tasa COP.",[156,617,619],{"number":169,"title":618},"Sabes ciclar entre los 3 modos con Shift+Tab",[23,620,621],{},"Default, Auto, Plan. Cada uno con su caso.",[156,623,625],{"number":245,"title":624},"Conoces los 7 comandos slash que más se usan",[23,626,627,469,629,469,631,469,634,469,636,469,638,469,641,337],{},[149,628,437],{},[149,630,404],{},[149,632,633],{},"\u002Feffort",[149,635,433],{},[149,637,447],{},[149,639,640],{},"\u002Fpermissions",[149,642,643],{},"\u002Fagents",[156,645,647],{"number":424,"title":646},"Sabes lanzar tareas en background con \u002Fbg",[23,648,649,650,653],{},"Y abrir Agent View con ",[149,651,652],{},"claude agents"," desde una terminal normal.",[60,655,657],{"id":656},"sigue-leyendo","Sigue leyendo",[23,659,660],{},"Esta es la base. Si te sirvió, en la biblioteca hay tres guías que continúan justo desde acá:",[662,663],"diagram-proximas-guias",{},[11,665],{"channel":13,"subtitle":666,"title":15,"url":16},"Te muestro statusline, modos, comandos y background en una sola sentada. Suscríbete y la próxima sale ahí primero.",[23,668,669,670,337],{},"¿Algo no te funcionó? ¿Tu setup quedó distinto y quieres contarme? Escríbeme por DM en ",[671,672,676],"a",{"href":673,"rel":674},"https:\u002F\u002Finstagram.com\u002Fsantaia.lab",[675],"nofollow","@santaia.lab",[678,679,680],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}",{"title":151,"searchDepth":196,"depth":196,"links":682},[683,684,689,692,693,698],{"id":38,"depth":196,"text":39},{"id":57,"depth":196,"text":58,"children":685},[686,687,688],{"id":62,"depth":206,"text":63},{"id":115,"depth":206,"text":116},{"id":136,"depth":206,"text":137},{"id":296,"depth":196,"text":297,"children":690},[691],{"id":310,"depth":206,"text":311},{"id":375,"depth":196,"text":376},{"id":495,"depth":196,"text":694,"children":695},"4 · Background agents (\u002Fbg)",[696,697],{"id":515,"depth":206,"text":516},{"id":549,"depth":206,"text":550},{"id":605,"depth":196,"text":606,"children":699},[700],{"id":656,"depth":206,"text":657},null,"Lo que cambio el primer día en Claude Code. Statusline, modos de operación, comandos y background agents. El setup mínimo para que la terminal no te deje a ciegas.","md",{},true,"intermedio","\u002Fbiblioteca\u002Fclaude-code-setup-inicial","2026-05-20",{"title":5,"description":702},"biblioteca\u002Fclaude-code-setup-inicial",[712,713,714,715,716],"claude-code","terminal","setup","configuracion","productividad","0qHOMK-hZ7MKEGEZp0MICef5n_KAdl9zyZdIHlHqlds",1780668175294]