---
title: "Usar API de terceros en Claude Code: settings.json"
description: "Conecta Claude Code a CodingPass: añade ANTHROPIC_BASE_URL y tu clave en ~/.claude/settings.json y comprueba con /status adónde van las peticiones."
url: https://codingpass.ai/es/blog/use-custom-api-in-claude-code-settings-json
language: es
updated: 2026-11-19
---
# 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.

[Equipo de CodingPass](https://codingpass.ai/es/about) Publicado 19 nov 2026 Actualizado 19 nov 2026 8 min de lectura

Si solo buscas la referencia rápida en tres pasos, consulta la [Guía de configuración de Claude Code](https://codingpass.ai/es/tools/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](https://codingpass.ai/es/tools/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!](https://codingpass.ai/assets/img/tools/claude-code/header-api-billing.webp)

*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](https://codingpass.ai/assets/img/tools/claude-code/status.webp)

*Las líneas Anthropic base URL y Auth token dentro de /status.*

Escrito por Equipo de CodingPass

Operamos CodingPass y probamos cada guía con la última versión estable de la herramienta antes de publicarla. ¿Ves algo desactualizado? Escribe a [support@codingpass.ai](mailto:support@codingpass.ai).

## Lecturas relacionadas.

Guía

### [Guía de configuración de Claude Code](https://codingpass.ai/es/tools/claude-code)

Conecta Claude Code en tres pasos, con modelos predeterminados y cuotas por nivel.

Guía

### [Guía de configuración de Claude Desktop](https://codingpass.ai/es/tools/claude-desktop)

La app de escritorio no lee settings.json; usa el modo Gateway.

Reglas

### [Cómo funcionan las cuotas y los límites](https://codingpass.ai/es/usage-limits)

Cuotas y límites por plan y modelo, además de la respuesta 429.
