FácilGuíaspopular Destacado

Claude Code desde cero — setup en 10 minutos

Instalá Claude Code, configurá tu API key, tu primer proyecto y los settings esenciales que casi nadie te cuenta. Después de esto vas a estar listo para empezar a construir.

10 de mayo de 202610 min de lecturav1.0claude-codeanthropic-api

Qué vas a lograr#

Al final de esta guía vas a tener:

Claude Code instalado y funcionando en tu terminal
Tu API key de Anthropic configurada de forma segura
Un proyecto de prueba corriendo con un CLAUDE.md bien armado
Los 3 settings que más te van a ahorrar tiempo desde el día 1

Si nunca usaste Claude Code, esto es lo más rápido y limpio que vas a encontrar en español.

Requisitos previos#

Paso 1 — Instalación#

Instalar Claude Code

Claude Code se distribuye como un paquete global de npm:

bash

npm install -g @anthropic-ai/claude-code

Verificá que quedó bien:

bash

claude --version

Si te tira error de permisos en macOS/Linux, no uses sudo. Configurá un prefix global para npm en tu home:

bash

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

Después volvé a correr el npm install -g.

Configurar tu API key

Generá una API key en console.anthropic.com/settings/keys.

Exportala como variable de entorno permanente:

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

⚠️ No la pongas en el código

Nunca commitees tu API key. Si usás .env en proyectos, agregalo al .gitignore antes de cualquier cosa.

Probá que Claude Code la lee:

bash

claude --version && claude /status

Paso 2 — Tu primer proyecto#

Andá a un proyecto existente (o creá uno nuevo) y entrá con:

bash

cd mi-proyecto
claude

La primera vez te va a pedir confirmación para algunas operaciones. Aceptá y empezá a explorar:

bash

> /init

El comando /init genera un CLAUDE.md analizando tu codebase. Este archivo es oro: Claude lo lee en cada sesión y le da contexto sobre tu proyecto.

Paso 3 — Los 3 settings que importan#

Editá tu ~/.claude/settings.json (o creá uno si no existe):

json

{
  "permissions": {
    "allow": [
      "Bash(npm:*)",
      "Bash(git diff:*)",
      "Bash(git log:*)",
      "Bash(ls:*)",
      "Read",
      "Edit"
    ]
  },
  "model": "claude-sonnet-4-6",
  "env": {
    "DISABLE_AUTOUPDATER": "0"
  }
}

Por qué cada uno importa:

Setting	Para qué sirve
`permissions.allow`	Evita el prompt de "¿Permitir esto?" en operaciones inocuas. Te ahorra ~30 confirmaciones por sesión.
`model`	Fija el modelo. Si no lo ponés, usa el default que puede cambiar.
`env.DISABLE_AUTOUPDATER`	Mantenelo en `0` (auto-update on). Claude Code se actualiza seguido con mejoras.

💡 El comando /permissions

Adentro de Claude Code, escribí /permissions para ver y editar permisos de forma interactiva. Más fácil que tocar el JSON a mano.

Comandos que vale la pena conocer desde el día 1#

Comando	Qué hace
`/init`	Genera `CLAUDE.md` del proyecto actual
`/clear`	Limpia el contexto de la sesión
`/compact`	Comprime el contexto (útil cuando se llena)
`/help`	Lista todos los comandos disponibles
`/model`	Cambia el modelo (Opus, Sonnet, Haiku)
`/cost`	Te muestra el gasto de la sesión
`/memory`	Edita tu memoria de usuario (preferencias persistentes)

Próximo paso#

Ya estás listo. Lo siguiente que recomiendo:

Probá pedirle a Claude que te explique un archivo de tu proyecto: "Explicame qué hace src/lib/db.ts"
Hacé un cambio chico: "Agregale tipos a las funciones de src/utils/format.ts"
Cuando quieras automatizar, mirá la guía de Hooks de Claude Code.

Si algo no te funcionó, abrí un issue en el repo oficial.

Cargando la bóveda…

Qué vas a lograr#

Al final de esta guía vas a tener:

Claude Code instalado y funcionando en tu terminal
Tu API key de Anthropic configurada de forma segura
Un proyecto de prueba corriendo con un CLAUDE.md bien armado
Los 3 settings que más te van a ahorrar tiempo desde el día 1

Si nunca usaste Claude Code, esto es lo más rápido y limpio que vas a encontrar en español.

Requisitos previos#

Paso 1 — Instalación#

Instalar Claude Code

Claude Code se distribuye como un paquete global de npm:

bash

npm install -g @anthropic-ai/claude-code

Verificá que quedó bien:

bash

claude --version

Si te tira error de permisos en macOS/Linux, no uses sudo. Configurá un prefix global para npm en tu home:

bash

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

Después volvé a correr el npm install -g.

Configurar tu API key

Generá una API key en console.anthropic.com/settings/keys.

Exportala como variable de entorno permanente:

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

⚠️ No la pongas en el código

Nunca commitees tu API key. Si usás .env en proyectos, agregalo al .gitignore antes de cualquier cosa.

Probá que Claude Code la lee:

bash

claude --version && claude /status

Paso 2 — Tu primer proyecto#

Andá a un proyecto existente (o creá uno nuevo) y entrá con:

bash

cd mi-proyecto
claude

La primera vez te va a pedir confirmación para algunas operaciones. Aceptá y empezá a explorar:

bash

> /init

El comando /init genera un CLAUDE.md analizando tu codebase. Este archivo es oro: Claude lo lee en cada sesión y le da contexto sobre tu proyecto.

Paso 3 — Los 3 settings que importan#

Editá tu ~/.claude/settings.json (o creá uno si no existe):

json

{
  "permissions": {
    "allow": [
      "Bash(npm:*)",
      "Bash(git diff:*)",
      "Bash(git log:*)",
      "Bash(ls:*)",
      "Read",
      "Edit"
    ]
  },
  "model": "claude-sonnet-4-6",
  "env": {
    "DISABLE_AUTOUPDATER": "0"
  }
}

Por qué cada uno importa:

Setting	Para qué sirve
`permissions.allow`	Evita el prompt de "¿Permitir esto?" en operaciones inocuas. Te ahorra ~30 confirmaciones por sesión.
`model`	Fija el modelo. Si no lo ponés, usa el default que puede cambiar.
`env.DISABLE_AUTOUPDATER`	Mantenelo en `0` (auto-update on). Claude Code se actualiza seguido con mejoras.

💡 El comando /permissions

Adentro de Claude Code, escribí /permissions para ver y editar permisos de forma interactiva. Más fácil que tocar el JSON a mano.

Comandos que vale la pena conocer desde el día 1#

Comando	Qué hace
`/init`	Genera `CLAUDE.md` del proyecto actual
`/clear`	Limpia el contexto de la sesión
`/compact`	Comprime el contexto (útil cuando se llena)
`/help`	Lista todos los comandos disponibles
`/model`	Cambia el modelo (Opus, Sonnet, Haiku)
`/cost`	Te muestra el gasto de la sesión
`/memory`	Edita tu memoria de usuario (preferencias persistentes)

Próximo paso#

Ya estás listo. Lo siguiente que recomiendo:

Probá pedirle a Claude que te explique un archivo de tu proyecto: "Explicame qué hace src/lib/db.ts"
Hacé un cambio chico: "Agregale tipos a las funciones de src/utils/format.ts"
Cuando quieras automatizar, mirá la guía de Hooks de Claude Code.

Si algo no te funcionó, abrí un issue en el repo oficial.

Claude Code desde cero — setup en 10 minutos

Qué vas a lograr#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Requisitos previos#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Paso 1 — Instalación#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Paso 2 — Tu primer proyecto#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Paso 3 — Los 3 settings que importan#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Comandos que vale la pena conocer desde el día 1#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Próximo paso#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Recursos relacionados

Hooks de Claude Code — automatizá lo que haces 10 veces al día

Agente PagoKit

Claude Code desde cero — setup en 10 minutos

Qué vas a lograr#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Requisitos previos#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Paso 1 — Instalación#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Paso 2 — Tu primer proyecto#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Paso 3 — Los 3 settings que importan#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Comandos que vale la pena conocer desde el día 1#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Próximo paso#.heading-anchor:hover { opacity: 1 !important; } *:hover > .heading-anchor { opacity: 0.5; }

Recursos relacionados

Hooks de Claude Code — automatizá lo que haces 10 veces al día

Agente PagoKit

Qué vas a lograr#

Requisitos previos#

Paso 1 — Instalación#

Paso 2 — Tu primer proyecto#

Paso 3 — Los 3 settings que importan#

Comandos que vale la pena conocer desde el día 1#

Próximo paso#

Qué vas a lograr#

Requisitos previos#

Paso 1 — Instalación#

Paso 2 — Tu primer proyecto#

Paso 3 — Los 3 settings que importan#

Comandos que vale la pena conocer desde el día 1#

Próximo paso#