Claude Code es un agente de codificación de línea de comandos de Anthropic que lee tu código base, edita archivos, ejecuta comandos y se conecta a APIs de LLM en el backend. Esta guía cubre la configuración, banderas, comandos slash, comandos personalizados y el enrutamiento de llamadas API a Novita AI. Para conectar bases de datos, navegadores o ejecutores de código, usa la guía de configuración de Claude MCP aparte para configuración CLI y JSON.
¿Qué es Claude Code?
Claude Code es una herramienta de codificación agéntica disponible como CLI, una extensión de VS Code, un plugin de JetBrains, una aplicación de escritorio y una interfaz de navegador. Todas las superficies comparten el mismo motor subyacente: Claude Code se conecta a un backend de API de LLM, lee tu proyecto y ejecuta tareas de varios pasos como escribir pruebas, refactorizar entre archivos, crear solicitudes de extracción y gestionar git.
La CLI es la superficie más flexible. Sigue las convenciones de Unix: puedes canalizar registros (logs) hacia ella, ejecutarla en CI con la bandera -p, o encadenarla con otras herramientas. La configuración reside en archivos (CLAUDE.md, .claude/settings.json, variables de entorno), por lo que se comporta de manera predecible en contextos automatizados.
En esencia, Claude Code envía cada solicitud a un punto final de API compatible con Anthropic. Por defecto, ese punto final es api.anthropic.com, pero puedes redirigirlo a cualquier proveedor compatible con Anthropic, incluido Novita AI, con una sola variable de entorno.
Configuración de Claude Code
Instalación
El método recomendado en macOS, Linux y WSL es el instalador nativo:
curl -fsSL https://claude.ai/install.sh | bash
En Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Las instalaciones nativas se actualizan automáticamente en segundo plano.
Si prefieres npm, se requiere Node.js 18 o superior:
node --version # debe ser 18 o superior
npm install -g @anthropic-ai/claude-code
Homebrew (macOS) sigue el canal de versiones estables:
brew install --cask claude-code
Homebrew no se actualiza automáticamente. Ejecuta brew upgrade claude-code cuando quieras la última versión.
Primer uso
Navega a un directorio de proyecto e inicia la sesión interactiva:
cd tu-proyecto
claude
En el primer uso, Claude Code te pide que inicies sesión. Después de la autenticación, lee tu proyecto y espera instrucciones.
Configuración del proyecto
Ejecuta /init en cualquier repositorio nuevo para generar un archivo CLAUDE.md inicial. Claude Code lee CLAUDE.md al inicio de cada sesión, por lo que es el lugar adecuado para estándares de codificación, bibliotecas preferidas, notas de arquitectura y listas de verificación de revisión.
/init
Después de /init, usa /memory para editar el archivo o habilitar la memoria automática, que guarda las observaciones que Claude hace sobre tu proyecto entre sesiones.
Referencia de Comandos CLI
Los comandos de shell de nivel superior de Claude Code inician sesiones, gestionan la autenticación y manejan el trabajo en segundo plano. Una lista parcial de los más útiles:
| Comando | Descripción |
|---|---|
claude |
Iniciar una sesión interactiva en el directorio actual |
claude "consulta" |
Iniciar una sesión con una consulta inicial |
claude -p "consulta" |
Ejecutar una consulta y salir (modo no interactivo / SDK) |
cat archivo | claude -p "consulta" |
Canalizar contenido en una consulta |
claude -c |
Continuar la sesión más reciente en el directorio actual |
claude -r "nombre" "consulta" |
Reanudar una sesión por nombre o ID |
claude update |
Actualizar a la última versión |
claude install stable |
Instalar o reinstalar una versión específica |
claude auth login |
Iniciar sesión en tu cuenta de Anthropic |
claude auth login --console |
Iniciar sesión con facturación por clave API en lugar de una suscripción |
claude auth status |
Mostrar estado de autenticación |
claude agents --json |
Abrir la vista de agente, imprimir sesiones activas como JSON |
claude mcp |
Configurar servidores MCP |
claude daemon status |
Verificar el estado del supervisor de sesiones en segundo plano |
Si escribes mal un subcomando, Claude Code sugiere la coincidencia más cercana: claude udpate imprime ¿Querías decir claude update?.
Referencia de Banderas CLI
Las banderas modifican cómo se comporta Claude Code durante una sesión. Pásalas después de claude en cualquier invocación. Una selección de las banderas más comúnmente necesarias:
| Bandera | Qué hace |
|---|---|
-p, --print |
Modo no interactivo; imprime la respuesta y sale |
-c, --continue |
Cargar la conversación más reciente |
-r, --resume |
Reanudar una sesión por ID o nombre |
--model |
Establecer el modelo para esta sesión (sonnet, opus, haiku o un ID de modelo completo) |
--permission-mode |
Iniciar en un modo de permisos: default, plan, auto, acceptEdits, bypassPermissions |
--add-dir |
Conceder acceso a archivos a un directorio adicional |
--system-prompt |
Reemplazar el prompt del sistema por completo |
--append-system-prompt |
Agregar al prompt del sistema predeterminado |
--max-turns |
Limitar los turnos agénticos en modo -p |
--max-budget-usd |
Limitar el gasto de API en modo -p |
--output-format |
Formato de salida para modo -p: text, json, stream-json |
--bg |
Iniciar como agente en segundo plano, regresar inmediatamente |
--worktree, -w |
Iniciar en un árbol de trabajo git aislado |
--bare |
Omitir el descubrimiento automático de hooks, skills, plugins, MCP para llamadas scripteadas más rápidas |
--verbose |
Mostrar salida completa turno por turno |
--mcp-config |
Cargar servidores MCP desde un archivo JSON |
--effort |
Establecer el esfuerzo de razonamiento: low, medium, high, xhigh, max |
La combinación --print + --output-format json es el patrón estándar para scripting. Para pipelines de CI con restricciones de presupuesto, combínalo con --max-budget-usd y --max-turns.
Documentación de Comandos Slash
Los comandos slash se ejecutan dentro de una sesión activa. Escribe / para ver todo lo disponible, o / seguido de letras para filtrar. Los comandos solo funcionan al inicio de un mensaje.
Gestión de sesión y contexto
| Comando | Propósito |
|---|---|
/clear |
Iniciar una nueva conversación; la sesión anterior permanece en /resume |
/compact |
Resumir la conversación para liberar espacio en la ventana de contexto |
/context |
Visualizar el uso del contexto y ver sugerencias de optimización |
/resume |
Reabrir una sesión anterior por nombre o desde un selector |
/branch |
Bifurcar la conversación para probar una dirección diferente |
/rewind |
Retroceder el código y la conversación a un punto de control |
Configuración del proyecto
| Comando | Propósito |
|---|---|
/init |
Generar un archivo CLAUDE.md inicial para el proyecto |
/memory |
Editar archivos CLAUDE.md y gestionar la memoria automática |
/mcp |
Gestionar conexiones de servidores MCP de forma interactiva |
/agents |
Configurar ajustes de subagentes |
/permissions |
Establecer reglas de permitir, preguntar y denegar para herramientas |
/hooks |
Ver configuraciones de hooks |
Flujo de trabajo de desarrollo
| Comando | Propósito |
|---|---|
/plan |
Entrar en modo planificación antes de un cambio grande |
/model |
Cambiar el modelo activo |
/effort |
Ajustar el nivel de esfuerzo de razonamiento |
/diff |
Abrir el visor de diferencias interactivo |
/code-review [--fix] |
Revisar el diff actual; --fix aplica los hallazgos |
/security-review |
Pase de seguridad profundo en cambios pendientes |
/batch <instrucción> |
Descomponer un cambio grande y ejecutarlo en árboles de trabajo paralelos |
/background |
Desvincular la sesión para ejecutarla como agente en segundo plano |
Utilidades
| Comando | Propósito |
|---|---|
/help |
Mostrar comandos disponibles |
/doctor |
Diagnosticar problemas de instalación y configuración |
/usage |
Mostrar el costo de la sesión y el uso del plan |
/export |
Exportar la conversación como texto plano |
/config |
Abrir configuración o establecer un valor directamente: /config thinking=false |
/skills |
Listar skills disponibles |
Comandos Slash Personalizados
Los comandos slash personalizados (ahora llamados skills) te permiten empaquetar procedimientos repetibles que tu equipo puede compartir.
Cómo crear un comando personalizado
Crea un directorio dentro de .claude/skills/ (a nivel de proyecto) o ~/.claude/skills/ (personal, disponible en todos los proyectos):
mkdir -p .claude/skills/review-pr
Crea un archivo SKILL.md dentro de ese directorio:
---
description: Revisar un PR abierto de GitHub en busca de problemas de seguridad y brechas de cobertura de pruebas. Usar cuando el usuario pida revisar un PR o verificar la calidad de una solicitud de extracción.
---
## Instrucciones
Revisa la solicitud de extracción con estas prioridades:
1. Identificar cualquier vulnerabilidad de seguridad: riesgos de inyección, brechas de autenticación, exposición de datos.
2. Verificar la cobertura de pruebas para nuevas rutas de código.
3. Señalar cualquier manejo de errores faltante en los límites del sistema.
Resume los hallazgos en tres secciones: Seguridad, Cobertura, Otros. Usa ✓ para verificaciones aprobadas y ⚠ para problemas.
Esto crea un comando /review-pr que puedes invocar directamente:
/review-pr
Claude también carga el skill automáticamente cuando preguntas algo que coincida con la descripción.
Ubicaciones de skills y prioridad
Los skills siguen un orden de prioridad: empresarial anula personal, personal anula proyecto. Los skills del proyecto están en .claude/skills/. Los skills personales (disponibles en todos tus proyectos) van en ~/.claude/skills/.
~/.claude/skills/ → personal, todos los proyectos
.claude/skills/ → solo este proyecto
Los comandos personalizados en .claude/commands/ todavía funcionan. Un archivo en .claude/commands/deploy.md y un skill en .claude/skills/deploy/SKILL.md ambos crean /deploy y se comportan de la misma manera.
Inyección de contexto dinámico
Los skills pueden inyectar datos en vivo antes de que Claude vea el prompt. El prefijo ! ejecuta un comando de shell e inserta su salida:
---
description: Resumir cambios no confirmados y señalar riesgos.
---
## Diff actual
!`git diff HEAD`
## Instrucciones
Resume los cambios en viñetas. Señala cualquier riesgo: manejo de errores faltante, valores codificados, rutas no probadas.
Cuando ejecutas este skill, Claude Code ejecuta git diff HEAD y reemplaza esa línea con la salida real del diff. Claude ve el estado real del árbol de trabajo en lugar de tener que solicitarlo a través de llamadas a herramientas.
Usando Novita AI como Backend de LLM
Claude Code enruta todo el tráfico de API a través de la variable de entorno ANTHROPIC_BASE_URL. Configurarla al punto final compatible con Anthropic de Novita AI te da acceso a una amplia gama de modelos, incluidos DeepSeek, Kimi, Qwen y variantes de GLM, a un costo por token sustancialmente menor que el punto final predeterminado de Anthropic.
Obtén tu clave API de Novita AI
Regístrate para una cuenta de Novita AI para recibir créditos de prueba gratuitos. Navega a la página de Gestión de Claves, haz clic en Crear Nueva Clave y copia la clave inmediatamente.
Establecer variables de entorno
En Mac y Linux:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Tu Clave API de Novita>"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"
En Windows (Símbolo del sistema):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Tu Clave API de Novita>
set ANTHROPIC_MODEL=deepseek/deepseek-v4-flash
set ANTHROPIC_SMALL_FAST_MODEL=deepseek/deepseek-v4-flash
Para persistir estas en Mac/Linux, agrega las líneas export a ~/.bashrc o ~/.zshrc.
ANTHROPIC_SMALL_FAST_MODEL controla el modelo ligero que Claude Code usa para tareas internas rápidas como búsquedas de archivos y resúmenes rápidos. Configurarlo al mismo ID de modelo mantiene todo el tráfico en una sola cuenta de facturación.
Iniciar Claude Code
Con las variables de entorno en su lugar, inicia Claude Code normalmente:
cd tu-proyecto
claude
Claude Code se conecta al punto final de Novita AI con el modelo que especificaste. La sesión interactiva funciona de manera idéntica: todas las banderas CLI, comandos slash y skills personalizados se comportan igual independientemente del backend que se esté utilizando.
Para scripting y CI, se aplica el mismo enfoque:
cat logs.txt | claude -p "encuentra cualquier patrón de error" --output-format json
La API de LLM de Novita AI admite el formato completo de mensajes de Anthropic, incluido el uso de herramientas, salidas estructuradas y transmisión, por lo que cada característica de Claude Code funciona sin modificaciones.
Agent Sandbox para ejecución aislada
Si estás construyendo pipelines automatizados sobre Claude Code, el Agent Sandbox de Novita AI proporciona entornos de ejecución aislados respaldados por firecracker para ejecutar agentes programáticamente. Esto es relevante para flujos de trabajo de CI, agentes en segundo plano y cualquier configuración multiagente donde necesites aislamiento de ejecución en lugar de ejecutar directamente en tu máquina de desarrollo.
Claude Code como Herramienta de IDE
Claude Code se integra directamente con los editores, que es lo que la gente quiere decir cuando dice “claude code es un IDE”: no es un IDE independiente, sino un agente de codificación que se integra en tu entorno existente.
VS Code y Cursor
Instala la extensión de Claude Code desde el Marketplace de VS Code (busca “Claude Code”) o desde el marketplace de Cursor. Después de instalar, abre la Paleta de Comandos (Cmd+Shift+P / Ctrl+Shift+P), escribe “Claude Code” y selecciona Abrir en Nueva Pestaña.
La integración de VS Code agrega revisión de diferencias en línea, menciones de archivos con @, revisión de planes antes de ediciones e historial de conversaciones directamente en el panel del editor. También puedes usar Claude Code en la terminal integrada junto con la extensión.
JetBrains
Instala el plugin de Claude Code desde el Marketplace de JetBrains y reinicia tu IDE. El plugin requiere que la CLI esté instalada por separado. Proporciona visualización interactiva de diferencias y uso compartido del contexto de selección en IntelliJ IDEA, PyCharm, WebStorm y otros IDEs de JetBrains.
Aplicación de escritorio y web
La aplicación de escritorio de Claude Code (macOS y Windows) te permite revisar diferencias visualmente, ejecutar múltiples sesiones lado a lado y programar tareas recurrentes. La interfaz web en claude.ai/code ejecuta sesiones en el navegador sin necesidad de configuración local, útil para repositorios que no tienes localmente o para iniciar tareas de larga duración que puedes monitorear de forma remota.
Preguntas Frecuentes
¿Qué es ANTHROPIC_BASE_URL y por qué es importante?
ANTHROPIC_BASE_URL le indica a Claude Code a qué punto final de API enviar las solicitudes. El valor predeterminado es api.anthropic.com. Configurarlo a https://api.novita.ai/anthropic enruta todo el tráfico al punto final compatible con Anthropic de Novita AI, donde puedes usar modelos alternativos a diferentes precios. No se requieren cambios de código ni plugins, solo la variable de entorno.
¿Cuál es la diferencia entre las banderas CLI y los comandos slash?
Las banderas CLI (como --model, --permission-mode, --max-turns) se establecen cuando inicias el binario claude desde tu shell. Configuran la sesión antes de que comience. Los comandos slash (como /model, /plan, /compact) se ejecutan dentro de una sesión activa y cambian el comportamiento a mitad de la conversación.
¿Puedo usar Claude Code sin una suscripción a Claude?
Sí. claude auth login --console te permite iniciar sesión con facturación por clave API de Anthropic Console, que utiliza precios de pago por token en lugar de una suscripción. Si enrutas a Novita AI a través de ANTHROPIC_BASE_URL, solo necesitas una cuenta de Novita AI; tu cuenta de Anthropic no se factura.
¿En qué se diferencian los comandos slash personalizados de CLAUDE.md?
El contenido de CLAUDE.md se carga al inicio de cada sesión y permanece en contexto durante toda la sesión. Los skills (comandos personalizados) se cargan solo cuando se invocan, por lo que el material de referencia extenso no añade costo de token hasta que realmente lo necesitas. Usa CLAUDE.md para hechos del proyecto que Claude siempre debe conocer: estándares de codificación, comandos de compilación, notas de arquitectura. Usa skills para procedimientos que ejecutas bajo demanda: listas de verificación de revisión de PR, pasos de implementación, flujos de trabajo de generación de pruebas.
¿Funciona Claude Code en CI?
Sí. Usa claude -p "consulta" --output-format json para modo no interactivo con salida estructurada. Agrega --max-budget-usd para limitar el gasto y --max-turns para acotar el tiempo de ejecución. La bandera --bare omite el descubrimiento automático de hooks, skills y plugins para un inicio más rápido en contextos scripteados. Claude Code también se integra con GitHub Actions y GitLab CI/CD a través de plantillas de flujo de trabajo oficiales.
Novita AI es una plataforma en la nube de IA que ofrece a los desarrolladores una forma fácil de implementar modelos de IA usando nuestra API simple, al tiempo que proporciona GPU en la nube asequible y confiable para construir y escalar.
