Claude Code es un agente de codificación orientado a la terminal creado por Anthropic. Lee tu código fuente, edita archivos, ejecuta comandos y puede conectarse a backends compatibles con Anthropic en lugar de usar solo la API predeterminada de Anthropic. Esta guía cubre la configuración de la CLI de Claude Code, los comandos de barra, los skills personalizados y cómo enrutar solicitudes a través de Novita AI.
Si necesitas bases de datos, navegadores u otras herramientas externas, combínalo con la guía de configuración de Claude MCP.
Puntos clave
- Claude Code es un agente de línea de comandos, no solo un cuadro de instrucciones.
/compact,/resume,/permissionsy/modelson comandos de sesión, mientras que-py--resumeson banderas de la CLI.- Los comandos de barra personalizados ahora funcionan como skills, por lo que tanto
.claude/skills/como.claude/commands/son importantes. - Novita AI puede actuar como backend compatible con Anthropic mediante
ANTHROPIC_BASE_URL. - Claude Code se adapta tanto a flujos de trabajo tipo IDE como a ejecuciones automatizadas de agentes.
¿Qué es Claude Code?
Claude Code es la herramienta de codificación agente de Anthropic. La CLI se ejecuta en tu terminal, pero el mismo agente también aparece en la aplicación de escritorio, la interfaz del navegador y las integraciones con editores.
La CLI es la superficie más flexible. Sigue las convenciones de Unix, por lo que puedes canalizar archivos hacia ella, ejecutarla de forma no interactiva con -p e integrarla en scripts o CI. La configuración reside en CLAUDE.md, .claude/settings.json y variables de entorno, lo que la convierte en una opción sólida para flujos de trabajo de codificación repetibles. Para obtener una guía más detallada sobre las reglas del proyecto, consulta cómo escribir CLAUDE.md.
Internamente, Claude Code envía solicitudes a un endpoint de API compatible con Anthropic. Por defecto, ese endpoint es el servicio propio de Anthropic, pero puedes redirigirlo a la API LLM de Novita AI con una sola variable de entorno. Para conocer el contexto de precios, consulta precio de la API de Claude vs planes de suscripción.
Configuración de Claude Code
Instalación
Instala la CLI con Node.js 18 o posterior:
npm install -g @anthropic-ai/claude-code
Primer uso
Inicia Claude Code en un directorio de proyecto:
cd tu-proyecto
claude
En el primer uso, Claude Code te pedirá 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, librerías 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 en todas las sesiones.
Referencia de comandos de la CLI
| Comando | Descripción |
|---|---|
claude |
Inicia una sesión interactiva en el directorio actual |
claude "consulta" |
Inicia una sesión con una instrucción inicial |
claude -p "consulta" |
Ejecuta una consulta y finaliza |
cat archivo | claude -p "consulta" |
Canaliza contenido a una consulta |
claude -c |
Continúa la sesión más reciente en el directorio actual |
claude -r "nombre" "consulta" |
Reanuda una sesión por nombre o ID |
claude update |
Actualiza a la versión más reciente |
claude install stable |
Instala o reinstala el binario estable |
claude auth login |
Inicia sesión en tu cuenta de Anthropic |
claude auth login --console |
Inicia sesión con facturación de clave API en lugar de una suscripción |
claude auth status |
Muestra el estado de autenticación |
claude mcp |
Configura servidores MCP |
claude doctor |
Muestra diagnósticos de instalación y configuración |
Referencia de banderas de la CLI
| Bandeja | Función |
|---|---|
-p, --print |
Modo no interactivo; imprime respuesta y finaliza |
-c, --continue |
Carga la conversación más reciente |
-r, --resume |
Reanuda una sesión por ID o nombre |
--model |
Establece el modelo para esta sesión |
--permission-mode |
Inicia en un modo de permisos |
--add-dir |
Concede acceso a archivos a un directorio adicional |
--system-prompt |
Reemplaza el prompt del sistema por completo |
--append-system-prompt |
Añade al final del prompt del sistema predeterminado |
--max-turns |
Limita los turnos del agente en modo -p |
--max-budget-usd |
Limita el gasto de API en modo -p |
--output-format |
Formato de salida para modo -p: text, json, stream-json |
--bg |
Inicia como agente en segundo plano, regresa inmediatamente |
--worktree, -w |
Inicia en un worktree de git aislado |
--bare |
Omite la detección automática de hooks, skills, plugins y MCP para llamadas de script más rápidas |
--verbose |
Muestra la salida completa turno por turno |
--mcp-config |
Carga servidores MCP desde un archivo JSON |
--effort |
Establece el esfuerzo de razonamiento |
La combinación --print + --output-format json es el patrón estándar para scripting. Para canalizaciones de CI con restricciones de presupuesto, combínalo con --max-budget-usd y --max-turns.
Documentación de comandos de barra
Los comandos de barra 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 |
Inicia una nueva conversación; la sesión anterior permanece en /resume |
/compact |
Resume la conversación para liberar espacio en la ventana de contexto |
/context |
Visualiza el uso del contexto y ve sugerencias de optimización |
/resume |
Reabre una sesión anterior por nombre o desde un selector |
/branch |
Bifurca la conversación para probar una dirección diferente |
/rewind |
Revierte el código y la conversación a un punto de control |
Configuración del proyecto
| Comando | Propósito |
|---|---|
/init |
Genera un archivo CLAUDE.md inicial para el proyecto |
/memory |
Edita archivos CLAUDE.md y gestiona la memoria automática |
/mcp |
Gestiona conexiones de servidores MCP de forma interactiva |
/agents |
Configura ajustes de subagentes |
/permissions |
Establece reglas de permitir, preguntar y denegar para herramientas |
/hooks |
Ver configuraciones de hooks |
Flujo de trabajo de desarrollo
| Comando | Propósito |
|---|---|
/plan |
Entra en modo planificación antes de un cambio grande |
/model |
Cambia el modelo activo |
/effort |
Ajusta el nivel de esfuerzo de razonamiento |
/diff |
Abre el visor de diferencias interactivo |
/code-review [--fix] |
Revisa el diff actual; --fix aplica los hallazgos |
/security-review |
Revisión de seguridad profunda en cambios pendientes |
/batch <instrucción> |
Descompone un cambio grande y lo ejecuta en paralelo en worktrees |
/background |
Desacopla la sesión para ejecutarse como agente en segundo plano |
Utilidades
| Comando | Propósito |
|---|---|
/help |
Muestra los comandos disponibles |
/doctor |
Diagnostica problemas de instalación y configuración |
/usage |
Muestra el costo de la sesión y el uso del plan |
/export |
Exporta la conversación como texto plano |
/config |
Abre la configuración o establece un valor directamente |
/skills |
Lista los skills disponibles |
Comandos de barra personalizados
Los comandos de barra personalizados ahora funcionan como skills. Los archivos existentes en .claude/commands/ aún funcionan, pero .claude/skills/ es el formato preferido.
Cómo crear un comando personalizado
Crea un directorio dentro de .claude/skills/ (a nivel de proyecto) o ~/.claude/skills/ (personal):
mkdir -p .claude/skills/review-pr
Crea un archivo SKILL.md dentro de ese directorio:
---
description: Revisa un PR abierto de GitHub en busca de problemas de seguridad y brechas en la cobertura de pruebas.
---
## Instrucciones
Revisa la solicitud de extracción con estas prioridades:
1. Identifica vulnerabilidades de seguridad.
2. Verifica la cobertura de pruebas para nuevas rutas de código.
3. Señala la falta de manejo de errores en los límites del sistema.
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
~/.claude/skills/ → personal, todos los proyectos
.claude/skills/ → solo este proyecto
Los comandos personalizados en .claude/commands/ aún funcionan. Un archivo en .claude/commands/deploy.md y un skill en .claude/skills/deploy/SKILL.md crean ambos /deploy.
Usar Novita AI como backend LLM
Claude Code enruta el tráfico de API a través de ANTHROPIC_BASE_URL. Configurarlo con el endpoint compatible con Anthropic de Novita AI te da acceso a los modelos de Novita sin cambiar el flujo de trabajo de Claude Code.
Obtén tu clave API de Novita AI
Regístrate para obtener una cuenta de Novita AI y recibir créditos de prueba gratuitos. Luego abre la página de gestión de claves, haz clic en Crear nueva clave y copia la clave inmediatamente.
Configura las 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="moonshotai/kimi-k2-instruct"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2-instruct"
En Windows (Command Prompt):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Tu clave API de Novita>
set ANTHROPIC_MODEL=moonshotai/kimi-k2-instruct
set ANTHROPIC_SMALL_FAST_MODEL=moonshotai/kimi-k2-instruct
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.
Inicia Claude Code
cd tu-proyecto
claude
Para scripting y CI, se aplica el mismo enfoque:
cat logs.txt | claude -p "encuentra patrones de error" --output-format json
La API LLM de Novita AI admite el formato de mensajes de Anthropic, incluyendo uso de herramientas, salidas estructuradas y streaming, por lo que Claude Code funciona sin modificaciones.
Agent Sandbox para ejecución aislada
Si estás construyendo canalizaciones automatizadas sobre Claude Code, el Agent Sandbox de Novita AI te proporciona ejecución aislada para ejecuciones de agentes, útil para flujos de trabajo de CI y trabajos de codificación de varios pasos.
Claude Code como herramienta de IDE
A menudo se describe a Claude Code como “un IDE” porque se integra en tu flujo de trabajo existente en lugar de reemplazarlo. Más precisamente, es una capa de agente que funciona con tu terminal, editor y contexto de proyecto.
VS Code y Cursor
Instala la extensión de Claude Code desde el Marketplace de VS Code o desde el marketplace de Cursor. Después de instalarla, abre la Paleta de Comandos, escribe “Claude Code” y selecciona Abrir en nueva pestaña.
La integración con VS Code añade revisión de diferencias en línea, menciones de archivos, 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. 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 te permite revisar diferencias visualmente y ejecutar varias sesiones en paralelo. La interfaz web en claude.ai/code ejecuta sesiones en el navegador sin necesidad de configuración local.
Preguntas frecuentes
¿Qué es ANTHROPIC_BASE_URL y por qué es importante?
ANTHROPIC_BASE_URL le indica a Claude Code a qué endpoint de API enviar las solicitudes. El valor predeterminado es la API de Anthropic. Configurarlo como https://api.novita.ai/anthropic enruta el tráfico al endpoint compatible con Anthropic de Novita AI.
¿Cuál es la diferencia entre las banderas de la CLI y los comandos de barra?
Las banderas de la CLI se configuran al iniciar claude desde tu terminal. Los comandos de barra 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 de clave API de la Consola de Anthropic. Si enrutas a Novita AI mediante ANTHROPIC_BASE_URL, solo necesitas una cuenta de Novita AI.
¿En qué se diferencian los comandos de barra personalizados de CLAUDE.md?
CLAUDE.md se carga al inicio de cada sesión y permanece en el contexto. Los skills se cargan solo cuando se invocan, así que usa CLAUDE.md para hechos del proyecto siempre activos y skills para procedimientos repetibles.
¿Funciona Claude Code en CI?
Sí. Usa claude -p "consulta" --output-format json para modo no interactivo. Agrega --max-budget-usd para limitar el gasto y --max-turns para acotar el tiempo de ejecución.
Novita AI es una plataforma en la nube de IA que ofrece a los desarrolladores una forma sencilla de implementar modelos de IA usando nuestra API simple, además de proporcionar GPU en la nube asequible y confiable para construir y escalar.
Artículos recomendados
- Cómo usar los agentes de Claude Code: Configuración, herramientas, permisos y flujo de trabajo con Sandbox
- Plugins de Claude Code: Cómo las herramientas MCP extienden Claude Code con capacidades externas
- Reglas de Claude Code: Cómo escribir CLAUDE.md y gestionar el contexto de codificación agente
- Claude MCP: Cómo configurar servidores MCP en Claude Code y Claude Desktop
- Cómo usar DeepSeek V4 Flash en Claude Code a través de Novita AI
- Cómo acceder a GLM-4.6 en Claude Code: Guía de configuración completa para desarrolladores
