Iniciar sesiónElegir plan
Blog · Guías de configuración

Usar API de terceros en Claude Code: settings.json

Añade dos variables en settings.json, ejecuta /status una vez y confirma que tus peticiones pasan por CodingPass.

Si solo buscas la referencia rápida en tres pasos, consulta la Guía de configuración de Claude Code. Aquí empezamos por qué es Claude Code y luego lo dejamos listo paso a paso.

Qué es Claude Code

Claude Code es el agente de programación propio de Anthropic. Lee el código de tu repositorio, propone un plan de cambios, edita varios archivos, ejecuta las pruebas y analiza la salida de la terminal para seguir depurando. Puedes adaptarlo a cada proyecto con:

  • CLAUDE.md: guarda las convenciones del proyecto
  • Comandos de barra y skills: empaquetan flujos habituales
  • Hooks: ejecutan tus scripts antes o después de cada llamada a herramienta
  • Subagentes: se encargan de tareas paralelas con su propio contexto
  • Servidores MCP: se conectan como de costumbre

Según la documentación oficial, tiene cuatro puntos de entrada: terminal, IDE, app de escritorio y navegador. Estos son los que leen settings.json:

  • Terminal: se lanza con el comando claude
  • IDE: las extensiones de VS Code y JetBrains ejecutan el mismo Claude Code por debajo
  • Scripts y CI: claude -p pasa un prompt puntual sin abrir la interfaz interactiva

La app de escritorio funciona aparte: Claude Desktop no lee settings.json, así que para conectarlo a CodingPass hay que usar el modo Gateway que explicamos en la Guía de configuración de Claude Desktop.

Al conectarlo a CodingPass, Claude Code sigue usando los IDs de modelo oficiales de Anthropic: el nivel Go incluye Sonnet 5.5 (claude-sonnet-5-5) por defecto, desde Plus puedes usar Opus 5.5, desde Pro tienes Fable 5.2 y para cambios menores puedes recurrir a Haiku 5.5. Cada solicitud se descuenta de la cuota de tu plan, sin cargos sorpresa.

Configuración paso a paso

Hemos verificado estos pasos desde cero en una máquina virtual limpia con Claude Code 2.1.327 y sin sesión iniciada en claude.ai.

Preparación

Instala Claude Code, abre la página de claves en el panel de control de CodingPass y crea una clave nueva seleccionando Claude Code como herramienta. La clave empieza por cp-live-.

Edita settings.json

Abre ~/.claude/settings.json (en Windows, %USERPROFILE%\.claude\settings.json) o créalo si no existe:

~/.claude/settings.json
{  "$schema": "https://json.schemastore.org/claude-code-settings.json",  "env": {    "ANTHROPIC_BASE_URL": "https://codingpass.ai",    "ANTHROPIC_AUTH_TOKEN": "cp-live-…"  },  "model": "claude-sonnet-5-5"}
  • Usa https://codingpass.ai como URL, sin /v1 al final.
  • Ajusta model según tu plan: en Go usa claude-sonnet-5-5, y desde Plus puedes cambiarlo a claude-opus-5-5. Si omites este campo, Claude Code usa Opus 5.5 por defecto.
  • El archivo debe ser JSON válido; una coma sobrante al final invalida toda la configuración. La línea $schema permite que tu editor marque los errores al instante.

Si ya tenías una sesión de Claude Code abierta, ciérrala por completo y vuelve a ejecutar claude dentro del directorio de tu proyecto.

Envía un mensaje para comprobarlo

Debajo del logotipo verás el nombre del modelo y API Usage Billing. Envía cualquier mensaje; si responde con normalidad, ya está funcionando.

Pantalla de inicio de Claude Code 2.1.327: debajo del logotipo aparece Sonnet 5.5 · API Usage Billing; al enviar Say hi in five words responde Hello there, nice to meet you!
La etiqueta API Usage Billing en la cabecera confirma que usa la clave API y no una suscripción de claude.ai.

Si prefieres no abrir la interfaz interactiva, ejecuta este comando; debería devolver 2:

Terminal
claude -p "1+1, output only the answer"

Por último, escribe /status para comprobarlo:

  • Anthropic base URL: https://codingpass.ai
  • Auth token: ANTHROPIC_AUTH_TOKEN, lo que confirma que está usando tu clave de CodingPass y no una sesión previa de claude.ai
  • Setting sources: los archivos de configuración cargados; en este caso, User settings
Pestaña Status de /status: Auth token muestra ANTHROPIC_AUTH_TOKEN, Anthropic base URL muestra https://codingpass.ai y Setting sources indica User settings
Las líneas Anthropic base URL y Auth token dentro de /status.
Embarque

Sigue usando Claude Code, con factura mensual fija.

Un archivo settings.json y Sonnet 5.5 desde al mes. Cancela cuando quieras.

  • ID de solicitud en cada respuesta
  • Reembolso total si has usado el 5% o menos
  • Sin cargos sorpresa
Elegir GoGuía de Claude Code

$10/mes hasta que canceles.