Configuración y proxy de Claude Code (2026): uso en China, dirección API personalizada, variables de entorno y ajustes de modelos y red

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

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 Ver planes

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.

Configuración de Claude Code: cómo usarlo en China, proxy y dirección API, variables de entorno habituales

Puntos clave