VS Code
Usa la extensión Claude Code para VS Code con OneProvider: añade el endpoint y la clave a settings.json, reinicia, omite el inicio de sesión y prueba.
La extensión de Claude Code para VS Code lee las variables de entorno de un settings.json junto a tu directorio personal. Añade el endpoint y la clave de OneProvider y reinicia.
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 . Presiona “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 . Instalación
Busca “Claude Code” en el VS Code Marketplace (editor anthropic.claude-code) e instálala. La extensión incluye su propio entorno de ejecución: no hace falta instalar una CLI aparte para el editor.
Configuración
Crea un settings.json en la ruta de tu sistema operativo que aparece abajo. La extensión lee este archivo al arrancar y usa el bloque env en todas las solicitudes salientes.
Ruta: ~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.oneprovider.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
} Crea el archivo si no existe y reinicia VS Code por completo para que se cargue el nuevo bloque env.
Si la extensión te pide iniciar sesión
La extensión comprueba las credenciales antes de arrancar y puede mostrar una pantalla de inicio de sesión si no tienes una cuenta de Claude. La solución fiable es definir la dirección y la clave en los ajustes de usuario propios de VS Code: abre la Command Palette (Paleta de comandos, ⌘⇧P / Ctrl+Shift+P ) → Preferences: Open User Settings (JSON) y añade (igual en macOS, Linux y Windows):
{
"claudeCode.disableLoginPrompt": true,
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.oneprovider.dev" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-your-key-here" }
]
} Reinicia VS Code. Una clave de OneProvider funciona tanto como ANTHROPIC_AUTH_TOKEN (Bearer) como ANTHROPIC_API_KEY.
Verificación
Abre el panel de Claude Code ( ⌘⇧P / Ctrl+Shift+P → Claude Code: Focus), escribe ping y envía. Una respuesta en pocos segundos confirma que el cambio de endpoint está activo.
Qué modelo elegir
La extensión ejecuta el mismo motor de Claude Code, así que elige los modelos de la misma forma. Mantén claude-sonnet-5-5 como opción por defecto para las ediciones diarias, cambia a claude-opus-5-5 para refactorizaciones grandes y usa claude-haiku-5-5 para preguntas rápidas y baratas. Cambia el modelo con /model en el panel. Los ID y las tarifas están en la página de modelos y en la página de precios ; un límite de gasto en la clave hace predecible la factura.
Errores frecuentes y soluciones
La extensión muestra una pantalla de inicio de sesión
La extensión comprueba las credenciales antes de arrancar. Añade claudeCode.disableLoginPrompt y el bloque claudeCode.environmentVariables de la sección anterior a los ajustes de usuario (JSON) de VS Code y reinicia VS Code por completo.
401 Invalid API key
El valor tiene una comilla o un espacio de más, o un ANTHROPIC_AUTH_TOKEN ajeno de otro servicio tiene prioridad sobre tu clave. Define la clave completa de OneProvider, sin comillas, en un solo lugar.
404 o un endpoint incorrecto
La base URL es https://api.oneprovider.dev sin /v1. La extensión añade la ruta por sí misma.
No cambió nada tras editar los ajustes
Cierra VS Code por completo (no basta con recargar la ventana) para que se cargue el nuevo bloque env. En una ventana de Remote-SSH, WSL o dev-container, la extensión suele leer los ajustes en el lado remoto, así que ponlos allí.
Los flujos se cortan
Desactiva las VPN o los proxies VLESS en la máquina que ejecuta la extensión: almacenan SSE en búfer y rompen HTTP/2.
Pegué el bloque en settings.json y no cambió nada
Son dos archivos distintos. El bloque env va en ~/.claude/settings.json; los ajustes de usuario propios de VS Code (JSON) solo admiten las claves claudeCode.disableLoginPrompt y claudeCode.environmentVariables de la sección anterior. Comprueba que ~/.claude/settings.json no tenga una coma tras su último elemento y cierra VS Code por completo.
Preguntas frecuentes
¿Necesito también la CLI de Claude Code?
No. La extensión incluye su propio entorno de ejecución. Si usas también la CLI, ambas leen el mismo ~/.claude/settings.json; consulta Claude Code .
¿Necesito una suscripción de Claude?
No, la clave de OneProvider basta.
¿Qué formato de clave acepta?
La clave sk-… tal cual, como ANTHROPIC_AUTH_TOKEN (Bearer) o ANTHROPIC_API_KEY.
¿Dónde veo el costo?
En la página Consumo del Dashboard de la clave. Añade un límite de gasto cuando emitas la clave.
¿Puedo usar en la extensión un id de GPT u otro del catálogo?
Sí, un id de texto del catálogo : nuestro endpoint de Anthropic también los responde. Pon "model": "gpt-6.1-terra" en ~/.claude/settings.json; las llamadas a herramientas dependen del modelo.
¿Puedo usar GitHub Copilot Chat o Continue en su lugar?
Sí, ambos aceptan un endpoint de estilo OpenAI. Copilot Chat: paleta de comandos → Chat: Manage Language Models → Add Models → Custom Endpoint y, en chatLanguageModels.json, define "apiType": "chat-completions", id gpt-6.1-terra, url https://api.oneprovider.dev/v1/chat/completions y "toolCalling": true (un modelo sin llamadas a herramientas queda oculto), además de maxInputTokens y maxOutputTokens de la fila del catálogo. En las sesiones del arnés de Copilot activa también chat.agentHost.byokModels.enabled. Cubre chat y agente, no las sugerencias en línea. Continue: añade a config.yaml un modelo con provider: openai, apiBase: https://api.oneprovider.dev/v1, tu clave y el id del modelo.
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 presiona “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-17 ¿Encontraste un error? @Oneproviderhelpbot