Configurar Claude Code

Conecta Claude Code a OneProvider en minutos con dos variables de entorno: base URL y clave de API. Pago por uso. Con llamada de prueba y soluciones.

La CLI de Anthropic sobre el endpoint de OneProvider. La configuración se reduce a dos variables de entorno y una llamada de verificación.

Todos los modelos, capacidades y precios Índice de la documentación para agentes de IA: https://oneprovider.dev/docs/llms.txt Sistema operativo Antes de empezar: una clave de tu panel Abre tu panel: el bot de Telegram @oneprovider_robot (Panel) o app.oneprovider.dev . Pulsa “Emitir una clave”, ponle un nombre (por ejemplo, este cliente) y un límite de gasto, y copia la clave. El saldo se recarga en el mismo lugar. Más sobre el panel y las claves . ¿Usas la app Claude Desktop? La pestaña Code de Claude Desktop se configura de otra forma, mediante el modo gateway integrado de la app: guía de Claude Desktop . Esta página es para la línea de comandos claude.

Instalación

bash

curl -fsSL https://claude.ai/install.sh | bash
# or:
brew install --cask claude-code

Opción 1: variables de entorno (sesión actual)

La forma más rápida es definir las variables solo en la terminal actual. No se conservan entre sesiones: si quieres que sobrevivan a un reinicio, consulta “Hacerlo permanente” al final.

bash

export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here

Opción 2: ajustes permanentes

Claude Code lee los ajustes de usuario de settings.json. El modelo por defecto y los alias de familia que aparecen abajo salen de los modelos activos actuales del catálogo.

Ruta del archivo: ~/.claude/settings.json

json

{
"env": {
"ANTHROPIC_BASE_URL": "https://api.oneprovider.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
"ANTHROPIC_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
},
"model": "claude-sonnet-5-5"
}

Verificación

bash

claude -p "say hi in one sentence"

Deberías ver una respuesta de una sola frase en un segundo o dos. Si ves 401, la clave es incorrecta; 400 invalid_request_error significa que el nombre del modelo no coincide con la lista canónica (la respuesta incluye los ID admitidos).

Problemas frecuentes

Claude Code me pide iniciar sesión o muestra “Auth conflict”: ¿qué hago? No necesitas iniciar sesión. La clave de OneProvider funciona sin una cuenta de Claude. ANTHROPIC_AUTH_TOKEN se envía como Authorization: Bearer, tiene prioridad sobre un inicio de sesión de claude.ai guardado y no requiere confirmación. Si aún queda un inicio de sesión de claude.ai guardado y Claude Code muestra la pantalla de inicio de sesión o una advertencia Auth conflict, ejecuta /logout dentro de Claude Code: tus variables se conservan y desaparece el inicio de sesión sobrante. Revisa /status: debe mostrar Auth token: ANTHROPIC_AUTH_TOKEN y Anthropic base URL: https://api.oneprovider.dev. No ejecutes unset ANTHROPIC_AUTH_TOKEN: eso elimina tu clave y Claude Code vuelve al inicio de sesión. Explicación completa: Solución de problemas · inicio de sesión en Claude Code . JSON parse error en settings.json (o un 429 sin explicación) La causa más habitual son las comillas “tipográficas” (“ ”) en ~/.claude/settings.json. Aparecen al pegar desde apps de mensajería o Notion, y el analizador de JSON las rechaza. A veces una configuración rota se manifiesta como un 429, porque el cliente interpreta la falta de respuesta como un límite de frecuencia. Solución en una línea: bash

# validate the file
jq . ~/.claude/settings.json
# auto-replace smart quotes with ASCII
sed -i.bak $'s/[\u201c\u201d]/"/g' ~/.claude/settings.json

Mejor prevención: copia la configuración directamente de esta documentación; aquí las comillas ya son correctas. Explicación completa: Solución de problemas · JSON parse / 429 . Se cortan las conexiones: ¿necesito una VPN? No hace falta VPN, y una VPN suele perjudicar. OneProvider no bloquea tráfico por región; las VPN o los proxies VLESS rompen con frecuencia el streaming SSE (la respuesta se corta a mitad) y el ALPN de HTTP/2. Si Claude Code se interrumpe a mitad de la salida sin motivo aparente, desactiva la VPN y reintenta. Explicación completa: Solución de problemas · VPN .

La lista completa de síntomas → causas → soluciones de 400 / 401 / 403 / 404 / 429 / 503 / 504 está en la página de solución de problemas .

Uso de herramientas

Claude Code usa el esquema de herramientas nativo de Anthropic. La API acepta cualquier nombre de herramienta (Read, Write, Edit, Bash, Grep, Glob, TodoWrite, etc.) con tool_choice: auto, que es lo que emite la CLI por defecto. No hace falta la cabecera anthropic-beta.

Si tu orquestador propio define tool_choice: {"type": "any"} o tool_choice: {"type": "tool", "name": "X"}, la API los reescribe como auto más una indicación en el prompt del sistema. Consulta Uso de herramientas para ver la tabla completa.

Dónde se envía la cabecera de autenticación ANTHROPIC_AUTH_TOKEN se envía como Authorization: Bearer y ANTHROPIC_API_KEY como x-api-key. La API acepta ambas, pero Claude Code toma primero ANTHROPIC_AUTH_TOKEN, así que no dejes ahí un token ajeno.

Hacerlo permanente

Cuando todo funcione y quieras que las variables sobrevivan entre sesiones de terminal, añádelas al archivo rc de tu shell (macOS / Linux) o al registro de variables de entorno del usuario (Windows). Las terminales nuevas las tomarán automáticamente.

bash

# append to ~/.zshrc (default macOS shell)
cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF
# apply to the current session:
source ~/.zshrc

Qué modelo elegir

Claude Code habla el protocolo de Anthropic, así que funciona mejor con la familia Claude. Usa claude-sonnet-5-5 como opción diaria por defecto: precio y calidad equilibrados para ediciones, pruebas y explicaciones. Cambia a claude-opus-5-5 para decisiones de arquitectura, refactorizaciones grandes y errores que no logras localizar; cuesta más por token. Usa claude-haiku-5-5 para preguntas rápidas, mensajes de commit y tareas en segundo plano donde importa más la velocidad que la profundidad. Dentro de una sesión ejecuta /model para cambiar, o empieza con claude --model claude-opus-5-5. Los ajustes de arriba asignan los alias sonnet, opus y haiku a estos ID. Los ID actuales están en la página de modelos y las tarifas en la página de precios . Los precios son por millón de tokens, así que pon un límite de gasto en la clave y vigila Consumo en tu Dashboard.

Errores frecuentes y soluciones

Aparece “claude: command not found” tras instalar

Abre primero una terminal nueva: el instalador deja el binario en ~/.local/bin. Si sigue sin aparecer, añádelo con export PATH="$HOME/.local/bin:$PATH" en el archivo rc de tu shell. Con Homebrew, comprueba que brew install --cask claude-code terminó sin errores.

400 invalid_request_error sobre el modelo

El ID del modelo no está en el catálogo, a menudo por un alias antiguo como claude-3-5-sonnet. Define ANTHROPIC_MODEL y las tres variables ANTHROPIC_DEFAULT_*_MODEL como en el settings.json de arriba, o lista los ID válidos con curl -s https://api.oneprovider.dev/v1/models -H "x-api-key: $KEY".

404 o “The requested API endpoint does not exist”

ANTHROPIC_BASE_URL debe ser exactamente https://api.oneprovider.dev: sin /v1 ni /v1/messages al final. Claude Code añade la ruta por sí mismo.

429 “Insufficient balance on this API key”

Se agotó el saldo del panel o el límite de gasto de la clave. Reintentar no ayuda: recarga el saldo o sube el límite en el panel y vuelve a enviar la solicitud.

La respuesta se detiene a mitad o se reinicia la conexión

Desactiva cualquier VPN o proxy VLESS: almacenan los flujos en búfer y rompen HTTP/2. OneProvider no bloquea por región ni almacena los flujos en búfer. Una solicitud debe empezar a responder en un máximo de 6 minutos y se corta a los 10 minutos en total; consulta los códigos de error .

Cambié settings.json pero no cambió nada

Claude Code lee el bloque env al arrancar, así que ciérralo y vuelve a iniciar claude. Mantén las variables en ~/.claude/settings.json o en tu shell: el .claude/settings.json de un proyecto se lee después de la configuración del primer arranque y puede ser demasiado tarde.

Preguntas frecuentes

¿Necesito una cuenta o suscripción de Claude?

No. La clave de OneProvider basta. Claude Code nunca tiene que iniciar sesión en claude.ai; si muestra una pantalla de inicio de sesión, sigue los pasos de Auth conflict de arriba.

¿Puedo usar GPT u otros modelos en Claude Code?

Claude Code envía solicitudes Messages de Anthropic, así que usa ID de Claude. Para los modelos GPT usa Codex , Cursor o Cline .

¿Cómo vuelvo a mi inicio de sesión de Anthropic?

Elimina las variables ANTHROPIC_* que definiste arriba del bloque env de settings.json y del archivo rc de tu shell, abre una terminal nueva y ejecuta /login.

¿Dónde veo cuánto costó una sesión?

En la página Consumo del Dashboard de la clave: cada solicitud con su modelo y su número de tokens. Un límite de gasto por clave detiene a un agente descontrolado.

¿Funciona en Windows?

Sí. Elige Windows en el selector de sistema operativo de arriba: las mismas dos variables se definen con PowerShell, y settings.json está en tu perfil de usuario, dentro de .claude.

¿Es lo mismo la extensión de Claude Code para VS Code?

Comparte el archivo de ajustes. Consulta Claude Code en VS Code .

Respuestas rápidas

¿Qué base URL uso?

Claude Code y los SDK de Anthropic usan https://api.oneprovider.dev. Los SDK de OpenAI y los clientes compatibles con OpenAI usan https://api.oneprovider.dev/v1. Una misma clave funciona con ambas; la lista de modelos está en la página de modelos y las tarifas, en la página de precios .

¿Cómo me autentico?

Envía la clave sk-… tal cual en x-api-key o en Authorization: Bearer: en uno de los dos, nunca en ambos. Guarda la clave en una variable de entorno, no en un archivo que se suba al repositorio. Más sobre la autenticación .

¿Dónde obtengo una clave?

Abre tu panel en el bot de Telegram @oneprovider_robot o en app.oneprovider.dev, recarga el saldo y pulsa “Emitir una clave”. Cada clave puede tener su propio límite de gasto. Panel y claves de API .

¿Qué significan 401, 404 y 429?

401: falta la clave, está mal escrita o se envió en un encabezado equivocado; pega la clave completa, sin comillas ni espacios. 404: casi siempre es una base URL incorrecta, por ejemplo con /v1 ausente o duplicado. 429 con “Insufficient balance”: se agotó el saldo del panel o el límite de gasto de la clave, así que recarga en lugar de reintentar; cualquier otro 429 es un límite de frecuencia, así que espera según Retry-After. Detalles: códigos de error y solución de problemas .

¿Por qué se cortan o se reinician los streams?

Las VPN y los proxies VLESS suelen almacenar SSE en búfer o romper la negociación de HTTP/2. OneProvider no tiene restricciones regionales y no almacena los streams en búfer: desactiva el proxy y reintenta.

¿Dónde pregunto si esto no basta?

Escribe a @Oneproviderhelpbot en Telegram o abre “Soporte” en el panel web, con el código de estado HTTP y el mensaje de error exacto. Cómo funciona el soporte .

Última actualización: 2026-11-08 ¿Encontraste un error? @Oneproviderhelpbot