Recursos para desarrolladores

Claude Code

Instale Claude Code, conéctelo a RunAPI, elija un modelo y verifique la configuración.

Descripción general

Claude Code es una herramienta de codificación agéntica para la terminal. Esta guía instala la CLI, dirige sus solicitudes compatibles con Anthropic a RunAPI, selecciona un modelo de RunAPI y verifica la conexión.

Antes de comenzar

Use una plataforma compatible con la guía oficial de configuración de Claude Code.
Cree una Clave de API de RunAPI estándar en la Guía de Autenticación. No la confirme en un repositorio.
Copie un identificador de modelo que sea compatible con Anthropic Messages desde el Catálogo de modelos.

Instalar

Usa el instalador nativo oficial en macOS, Linux o WSL y luego confirma que el comando está disponible:

SHELL

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Para Homebrew, WinGet y requisitos específicos de cada plataforma, use la guía de instalación oficial.

Configurar RunAPI

Para una primera prueba, exporte la URL base, la clave de API y el modelo en el shell actual:

SHELL

export ANTHROPIC_BASE_URL=https://runapi.ai
export ANTHROPIC_API_KEY=YOUR_RUNAPI_API_KEY
export ANTHROPIC_MODEL=YOUR_RUNAPI_MODEL_ID

Para aplicar los valores a todas las sesiones de Claude Code de tu usuario, agrégalos en el objeto env de ~/.claude/settings.json:

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

Mantenga la clave real fuera de .claude/settings.json, que está destinado a la configuración del proyecto que puede confirmarse. Para los ámbitos de configuración y la precedencia, use la referencia de configuración de Claude Code.

Elegir un modelo

Reemplace YOUR_RUNAPI_MODEL_ID con el identificador exacto del Catálogo de modelos. ANTHROPIC_BASE_URL cambia el destino de las solicitudes; no selecciona un modelo. También puede iniciar una sesión con claude --model YOUR_RUNAPI_MODEL_ID o ejecutar /model durante una sesión.

Verificar

Ejecute las verificaciones de instalación y configuración y, a continuación, envíe un mensaje breve:

SHELL

claude --version
claude doctor
claude

Dentro de Claude Code, ejecute /status para confirmar la configuración cargada y el modelo activo. Una respuesta normal a Describe this repository in one sentence. confirma que la conexión de RunAPI funciona.

Solución de problemas

claude no se encuentra: vuelve a abrir el terminal y sigue la solución de problemas de instalación oficial.
La configuración no se carga: valida ~/.claude/settings.json con claude doctor y luego usa /status para inspeccionar las fuentes cargadas.
La autenticación falla: confirma que ANTHROPIC_API_KEY contiene una clave RunAPI activa. Crea o rota las claves a través de la Guía de autenticación.
El modelo no está disponible: copia el identificador exacto del Catálogo de modelos y luego inicia una nueva sesión. Las sesiones reanudadas pueden conservar su modelo anterior.
Las solicitudes usan otro endpoint: inicia un terminal nuevo después de cambiar las variables de entorno y verifica si hay una configuración de Claude Code con mayor precedencia.

Próximos pasos

Usa el Inicio rápido de la API LLM para el comportamiento del protocolo y la Referencia de la API de Mensajes de Anthropic para los campos de solicitud. Para agregar herramientas de RunAPI a Claude Code, continúa con la Descripción general de MCP.