Claude Code · En China

Cómo usar Claude Code en China

Usar Claude Code en China: la dificultad no está en la instalación, sino en la red, el pago y las cuentas. Esta página explica, en orden: cómo instalarlo, cómo conectarte a una API accesible directamente desde China, cómo solucionar problemas cuando está instalado pero no funciona y cómo elegir entre una suscripción de Claude (Pro / Max) y un relay de API.

Última comprobación 2026-10-14

Obtener clave de API Guía de integración de Claude Code

3 obstáculos para usar Claude Code en China

Obstáculo	Síntoma	Solución
Red	No se puede conectar al endpoint de Anthropic; las solicitudes agotan el tiempo de espera	Configura ANTHROPIC_BASE_URL con un endpoint accesible directamente desde China
Pago	Tanto la suscripción de Claude como la API de Anthropic requieren una tarjeta de crédito extranjera	Usa un servicio de API que acepte métodos de pago de China y ofrezca saldo prepago
Cuenta	Registro de cuenta de Claude y restricciones por región	Usa acceso con clave de API; no hace falta iniciar sesión con una cuenta de Claude

Instalación (npm y registro de China)

1. Instala Node.js 22 o superior
Ejecuta node -v para comprobar tu versión.
2. (Opcional) Cambia a un registro npm de China
Si las descargas de npm van lentas, puedes cambiar el registro primero.
Terminal
```
npm config set registry https://registry.npmmirror.com
```
3. Instala Claude Code
Tras una instalación global, ejecuta claude --version para verificarlo.
Terminal
```
npm install -g @anthropic-ai/claude-code
```

Si ves command not found, lo más probable es que el directorio global de npm no esté en tu PATH. Ejecuta npm config get prefix, añade el directorio bin de la ruta que se muestra a tu PATH y vuelve a abrir la terminal.

Conéctate a una API disponible en China

Crea una clave de API en la consola de AICodeWith y añádela a ~/.claude/settings.json. Vuelve a abrir la terminal, ejecuta claude y escribe /status para confirmar que el endpoint de la API es api.aicodewith.ai.

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的_API_KEY",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
  }
}

Guía de relay de Claude Code Obtener clave de API

Solución de problemas: cuando no funciona

Ejecuta /status y confirma que el endpoint es api.aicodewith.ai, no el endpoint predeterminado de Anthropic.
En una terminal nueva, ejecuta echo $ANTHROPIC_API_KEY. Si aparece un valor antiguo, elimínalo de ~/.zshrc o ~/.bashrc; ANTHROPIC_API_KEY debe quedar vacío.
Si la primera ejecución se queda atascada en la pantalla de inicio de sesión: añade "hasCompletedOnboarding": true a ~/.claude.json.
Tiempo de espera agotado: desactiva temporalmente tu proxy o VPN local y vuelve a intentarlo. La red en China puede conectarse directamente.
Si recibes 401 / 429 / overloaded: consulta la guía de errores.

Errores comunes de Claude Code y cómo solucionarlos Regiones compatibles

Comparación de planes (suscripción de Claude vs. relay de API)

	Suscripción de Claude (Pro / Max)	Relay de API (AICodeWith)
Pago	Tarjeta de crédito extranjera, precio mensual fijo	Métodos de pago de China; saldo prepago, pago por uso
Red	Tienes que gestionarla tú	Accesible directamente desde China
Cuenta	Requiere una cuenta de Claude	Solo se necesita una clave de API
Cuota	Límites de 5 horas y semanales	Se cobra contra tu saldo prepago; se aplican límites de velocidad y concurrencia
Ideal para	Uso intensivo diario sin problemas de red ni de pago	Redes de China, uso variable, equipos que gestionan claves de API separadas

Límites de uso de Claude Code Recarga y planes

FAQ

¿Se puede usar Claude Code directamente en China?

Sí. La instalación en sí no tiene restricciones. Cuando cambias el endpoint a una API accesible directamente desde China (por ejemplo, api.aicodewith.ai), puedes usarlo directamente.

¿Necesito un proxy?

No necesitas proxy después de conectarte a AICodeWith. Si tienes un proxy local en ejecución y las solicitudes agotan el tiempo de espera, desactívalo y vuelve a intentarlo.

¿Y si no tengo una tarjeta de crédito extranjera?

AICodeWith acepta métodos de pago de China para recargar. El saldo prepago se cobra por uso, es válido durante 12 meses y no se reinicia cada mes.

¿Qué hago si la instalación falla o aparece command not found?

Primero asegúrate de que tu versión de Node.js sea 22 o superior. Si las descargas de npm van lentas, cambia a un registro de China. command not found significa que el directorio bin global de npm no está en tu PATH; añádelo y vuelve a abrir la terminal.

¿Listo para probarlo?

El cobro es por token desde un saldo prepago. Se aplican límites de velocidad y concurrencia, y puedes establecer topes de gasto diarios, mensuales o totales en cada clave de API.

Obtener clave de API Ver precios de los modelos

Relacionado

Relay de Claude Code Guía de integración de Claude Code Errores comunes de Claude Code Regiones compatibles Límites de uso de Claude Code

AICodeWith es un servicio de API independiente de terceros y no tiene afiliación con Anthropic ni con OpenAI. Claude, Claude Code, Codex y otros nombres pertenecen a sus respectivos propietarios. Los precios se basan en datos en tiempo real de la página del modelo; se aplican límites de velocidad y concurrencia; las devoluciones están sujetas a una comisión de gestión del 10%. Consulta la política de devoluciones para más detalles.