Source: https://aiprimetech.io/es/guides/claude-code-configuration-network/ [Inicio](/es/) › [Claude Code](/es/claude-code/) › [Guía en chino](/es/claude-code/) › Configuración y proxy [Descripción general](/es/claude-code/)[Instalación](/es/claude-code/install/)[referencia de la CLI](/es/claude-code/cli/)[Precios y límites](/es/claude-code/pricing/)[Agent SDK](/es/claude-code/sdk/)[Habilidades y plugins](/es/claude-code/skills/)[GitHub](/es/claude-code/github/)[Web, escritorio e IDE](/es/claude-code/web-and-desktop/)[Modelos](/es/claude-code/models/)[Errores](/es/claude-code/errors/)[¿Código abierto?](/es/claude-code/open-source/)[Tutorial](/es/claude-code/tutorial/)[Para estudiantes](/es/claude-code/for-students/)[Automatización de QA](/es/claude-code/qa-automation/)[Comparación con Cursor](/es/claude-code/vs-cursor/)[Comparación con Codex y OpenCode](/es/claude-code/vs-codex/)[Subagentes](/es/claude-code/subagents/)[Hooks](/es/claude-code/hooks/)[MCP](/es/claude-code/mcp/)[Ecosistema](/es/claude-code/ecosystem/)[VS Code](/es/claude-code/vscode/)[OpenRouter](/es/claude-code/openrouter/)[Límites de solicitudes](/es/claude-code/rate-limits/)[Guía en chino](/es/claude-code/) Actualizado el 11 de octubre de 2026 # Configuración de Claude Code: cómo usarlo en China, proxy y dirección API, variables de entorno habituales Toda la configuración de Claude Code se concentra en unas pocas variables de entorno y dos archivos. Lo más importante para los usuarios en China: permite personalizar la dirección de la API, por lo que no se necesita VPN ni una cuenta extranjera; basta con apuntar a una pasarela compatible con la interfaz de Anthropic para usarlo. ## Puntos clave - ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY: apunta a la pasarela; basta con dos líneas y no se necesita VPN. - HTTPS_PROXY / HTTP_PROXY: configúralo solo si tu red realmente necesita un proxy. - ANTHROPIC_DEFAULT_SONNET_MODEL y otras variables asignan un modelo concreto a cada nivel. - /status muestra la dirección, la clave y el modelo activos: consúltalo primero al diagnosticar problemas de configuración. ## Uso en China: apunta a la pasarela sin VPN ``` # ~/.zshrc / ~/.bashrc / PowerShell 配置文件 export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=你的网关密钥 claude ``` Claude Code lee estas dos variables igual que el SDK oficial. Las solicitudes se envían a la pasarela en lugar de a api.anthropic.com, por lo que las redes de China pueden conectarse directamente. Introduce solo el dominio, sin /v1. Tras configurarlo, vuelve a abrir el terminal y, dentro de la sesión, usa /status para comprobarlo. La extensión de VS Code y la aplicación de escritorio leen el entorno del shell desde el que se iniciaron; tras cambiar la configuración, cierra completamente el editor y vuelve a iniciarlo desde un terminal nuevo. ## Cuándo se necesita un proxy Solo se necesita si la conexión de tu red con la propia pasarela es inestable. Se configura igual que en otras herramientas de línea de comandos: ``` export HTTPS_PROXY=http://127.0.0.1:7890 export HTTP_PROXY=http://127.0.0.1:7890 ``` Si /login agota el tiempo de espera al iniciar sesión mediante OAuth («timeout of 15000ms exceeded»), lo más probable es que haya un problema con el proxy o el DNS; iniciar sesión con una clave API permite omitir OAuth por completo. ## Configuración de modelos ``` export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5 export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 ``` Claude Code trabaja con niveles (Sonnet / Opus / Haiku), y estas tres variables determinan qué modelo concreto corresponde a cada nivel. El nivel Haiku es más importante de lo que parece: Claude Code lo usa para pequeñas tareas en cada sesión, y asignarle un modelo económico permite ahorrar bastante. La pasarela ofrece actualmente 33 identificadores de modelos Claude, todos seleccionables en/model . ## Dónde están los archivos de configuración - CLAUDE.md(raíz del proyecto): memoria del proyecto, con comandos de compilación y pruebas y convenciones;CLAUDE.local.md contiene notas personales y no se incorpora al repositorio. - .claude/settings.json(proyecto) / ~/.claude/settings.json(global): permisos, hooks, variables de entorno y statusLine. - .claude/agents/ — definiciones de subagentes;.claude/skills/ y ~/.claude/skills/ — habilidades. - .mcp.json — configuración de servidores MCP compartida por el proyecto. ## Solución de errores de configuración - 404 y en los registros aparece /v1/v1/messages → en BASE_URL se ha añadido de más /v1。 - 401 / clave no válida → la clave y la dirección no coinciden: la dirección de la pasarela debe usarse con una clave de la pasarela. - Has iniciado sesión en Max, pero se te cobra por token → todavía hay ANTHROPIC_API_KEY en el entorno; la clave tiene prioridad sobre el inicio de sesión. Si no quieres usarla, elimínala con unset. - El modelo no existe → ese identificador no está en la lista de /v1/models del endpoint actual. - Tras modificar settings.json, la aplicación se cierra al iniciarse → error de sintaxis de JSON (una coma de más); compruébalo con una herramienta de validación. ## Coste Al apuntar a la pasarela, también cambia la facturación: el crédito se vende a 7.69231 veces su valor nominal; por $13 obtienes $100 de crédito. Para un uso intensivo, puedes elegir planes ilimitados desde $0.80. Consulta los detalles en la página de precios. ## Pruébalo gratis primero Las cuentas nuevas que utilicen el código promocional CLAUDECODE al registrarse recibirán $5 de saldo API, sin necesidad de vincular una tarjeta: suficiente para usar Claude Code durante toda una noche. Los mismos modelos de Claude, con solo dos líneas de variables de entorno para cambiar. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Registrarse con el código promocional CLAUDECODE](/register?promo=CLAUDECODE) ## Preguntas frecuentes ¿Se puede usar Claude Code en China? Sí. Claude Code admite una dirección API personalizada (ANTHROPIC_BASE_URL). Al apuntar a nuestra pasarela, las redes de China se conectan directamente, sin necesidad de VPN, cuenta extranjera ni tarjeta bancaria extranjera.¿Cómo se configura un proxy en Claude Code? Basta con configurar las variables de entorno HTTPS_PROXY / HTTP_PROXY. Sin embargo, al apuntar a la pasarela, la mayoría de los usuarios no necesitan un proxy.¿Hay que añadir /v1 a ANTHROPIC_BASE_URL? No. El SDK añade /v1/messages automáticamente; añadir un nivel extra provoca 404. ## Ejecuta Claude Code a través de la pasarela Los mismos modelos, dos líneas de variables de entorno y recargas de créditos a 7.69231 veces su valor nominal, o la opción de elegir un plan ilimitado. Las cuentas nuevas pueden obtener $5 de saldo API con el código promocional CLAUDECODE.[Obtener una clave API](/register?promo=CLAUDECODE) [Ver planes](/es/plans/) AI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela. ## Más guías de Claude Code [Cómo usar Claude Code: desde la instalación hasta el uso diario](/es/claude-code/)[Guía de instalación de Claude Code: descarga, instalación y verificación; elige entre tres métodos](/es/claude-code/install/)[Cómo usar Claude Code: desde la primera sesión hasta el flujo de trabajo diario](/es/claude-code/tutorial/)[Precios de Claude Code: cómo se cobra, si se puede usar gratis, cómo registrarse y ahorrar](/es/claude-code/pricing/)