Punto final de API personalizada de Claude Code: Configuración de puerta de enlace de modelos de código abierto chino

Claude Code puede configurarse para comunicarse con un endpoint compatible con Anthropic en lugar de usar directamente el endpoint del proveedor. Esto permite probar un flujo de trabajo gestionado por un gateway con IDs de modelo expuestos por el gateway, incluyendo modelos de código abierto chino disponibles en el catálogo actual de modelos de ECAIX.

Este guía se centra en un flujo de trabajo de compatibilidad específico del proveedor con terceros. La documentación oficial de la puerta de enlace de Claude Code de Anthropic explica que Anthropic no soporta redirigir Claude Code a modelos no Claude a través de una puerta de enlace. ECAIX no afirma que este flujo de trabajo esté oficialmente respaldado por Anthropic, y un modelo no Claude podría no ofrecer todas las capacidades de Claude Code.

Inicio rápido

Si ya entiende los límites de compatibilidad, utilice primero este camino corto:

1. Abra el catálogo actual de modelos de ECAIX y elija una ID de modelo activa.
2. Cree una clave de API de ECAIX y guárdala fuera del control de versiones.
3. Establezca ANTHROPIC_BASE_URL en https://ecaix.com/api/ai/v1/anthropic.
4. Envía la solicitud de diagnóstico a continuación y registra el código de estado HTTP.
5. Ejecuta Claude Code en un proyecto de prueba en solo lectura con claude -p.
6. Prueba herramientas, flujo de datos en tiempo real, límites de contexto y permisos por separado.

Estado de validación en la publicación

Esta tabla es intencional: un ejemplo de configuración no es lo mismo que un resultado de compatibilidad medido.

Qué cambia esta configuración

La configuración tiene cuatro partes separadas:

1. Claude Code es el cliente que crea tareas de programación y envía solicitudes.
2. La puerta de enlace compatible con Anthropic recibe solicitudes en un endpoint de estilo Anthropic.
3. La ID de modelo selecciona el modelo de origen expuesto por la puerta de enlace.
4. La clave de API autentica la solicitud y determina el cuenta, la cuota y los permisos.

Cambiar el endpoint no convierte un modelo no Claude en Claude. Solo cambia qué superficie API compatible recibe la solicitud. El uso de herramientas, manejo de contexto, alias de modelos, comportamiento de flujo de datos y flujos de permisos pueden variar según la versión del cliente y la implementación de la puerta de enlace.

Antes de empezar

Necesitas:

• Una instalación de Claude Code que soporte la configuración del endpoint mediante variables de entorno o configuraciones.
• Una clave de API de ECAIX.
• Una ID de modelo que actualmente existe en el catálogo de modelos de ECAIX.
• Un terminal donde puedas ejecutar una pequeña solicitud de prueba sin colocar la clave de API en el control de versiones.

El catálogo cambia con el tiempo. Antes de copiar una ID de modelo en un archivo de configuración, abre la dirección de los modelos de ECAIX y confirma que el modelo está activo y disponible para el estilo de API que planeas usar.

Configurar el endpoint de la puerta de enlace

Claude Code almacena configuraciones en ~/.claude/settings.json en muchas instalaciones. El esquema de configuraciones exacto puede cambiar, por lo que trate lo siguiente como un patrón inicial y compárelo con la documentación de su versión instalada.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ecaix.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "YOUR_ECAIX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT": "1"
  },
  "model": "deepseek-v4.1-flash"
}

No cometa este archivo en un repositorio público si contiene una clave de API real. Prefiera una variable de entorno local, un gestor de secretos o el mecanismo de credenciales recomendado por su instalación de Claude Code.

También puede configurar el endpoint en una sesión de shell mientras prueba:

export ANTHROPIC_BASE_URL="https://ecaix.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="YOUR_ECAIX_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"

Los nombres de variables y las configuraciones soportadas por una versión particular de Claude Code pueden cambiar. Si el cliente ignora ANTHROPIC_MODEL, utilice el campo de modelo o el mecanismo de alias de modelos documentado por su versión. La puerta de enlace sigue necesitando reconocer la ID de modelo final.

Verificar el endpoint compatible con Anthropic primero

Antes de iniciar una sesión interactiva de programación, envía una pequeña solicitud. Esto separa los problemas del endpoint, la autenticación y la ID de modelo de los comportamientos específicos de Claude Code.

El comando a continuación guarda los encabezados de respuesta y el cuerpo de la respuesta por separado, y luego imprime el código de estado HTTP. Utilice una clave autorizada real solo en su shell local; nunca pegue una clave en un artículo, un problema, un registro compartido o la historia de shell.

curl -sS -D /tmp/ecaix-anthropic-headers.txt \
  -o /tmp/ecaix-anthropic-response.json \
  -w '\nHTTP %{http_code}\n' \
  "${ANTHROPIC_BASE_URL}/messages" \
  -H "x-api-key: ${ANTHROPIC_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ]
  }'

Interpretación esperada:

• 200: inspeccione la forma de la respuesta y confirme los campos de modelo o uso devueltos.
• 401 o 403: verifique la clave, los encabezados, el alcance de la cuenta y el alcance de los permisos antes de cambiar el prompt.
• 404: verifique la URL base, el sufijo /messages y la implementación del endpoint.
• 400: reduzca la solicitud a la forma más pequeña válida y verifique los campos específicos del modelo.
• 5xx o timeout: registre el tiempo de solicitud y el cuerpo de la respuesta, luego separa el comportamiento de la puerta de enlace, el proveedor de origen y el timeout del cliente.

Una respuesta exitosa confirma que la clave, el endpoint, la forma de la solicitud y la ID de modelo funcionaron juntos para esa solicitud. No prueba que todas las características de Claude Code funcionen.

Elegir una ID de modelo

El catálogo de ECAIX contiene familias de modelos de proveedores chinos. La ID de modelo correcta inicial depende de la tarea, no solo del nombre del modelo.

Programación y desarrollo general

Empiece con un modelo actual de DeepSeek, Qwen, GLM o Seed que tenga capacidad de programación y esté visible en el catálogo. Por ejemplo, un catálogo puede exponer IDs como deepseek-v4.1-flash, qwen3.8-flash, glm-5.3 o seed-2.0-code. La disponibilidad y capacidades pueden cambiar, así que verifique siempre la página actual del modelo antes de publicar una configuración.

Trabajo con repositorios y documentos técnicos largos

Para grandes repositorios o documentos técnicos largos, compare la longitud de contexto mostrada en la página del modelo. Una ventana de contexto más grande no significa automáticamente mejores resultados para repositorios: la estructura del prompt, el soporte de herramientas, los límites de salida y los límites de solicitud de la puerta de enlace también importan.

Llamadas a herramientas y flujos de trabajo de agente

Si el flujo de trabajo necesita llamadas a funciones o herramientas, verifique la documentación del modelo y el endpoint. Algunos proveedores exponen llamadas a herramientas a través de APIs compatibles con OpenAI, mientras que otros exponen nombres de campos diferentes o solo soportan un subconjunto del comportamiento de herramientas. Empiece con una prueba de llamada a herramientas pequeña antes de dar acceso al modelo a un repositorio real o un sistema externo.

Trabajo de desarrollo con lenguaje chino

Los modelos de código abierto chino pueden ser útiles cuando el código base, la documentación, el seguimiento de problemas o el flujo de trabajo de la equipo contiene material en chino. Evalúe el modelo con sus propios prompts y muestras de repositorio en lugar de basarse únicamente en rankings generales.

Prueba de Claude Code después de que la solicitud de API funcione

Una vez que la solicitud directa tenga éxito, comience con una orden de solo lectura o de bajo riesgo:

claude -p "Explain what this repository does without editing files."

Luego, pruebe una tarea estrechamente definida. Por ejemplo:

claude -p "List the likely entry points for the web application. Do not modify files."

Utilice pruebas progresivamente más exigentes:

1. Respuesta de texto plana.
2. Explicación corta de código.
3. Navegación de repositorio.
4. Edición controlada en una rama desechable.
5. Uso de herramientas o tarea multicapa.
6. Comportamiento de flujo de datos y contexto largo.

No asuma que una respuesta de texto exitosa prueba que los flujos de permisos, las llamadas a herramientas, el flujo de datos, los límites de contexto o la edición de archivos se comportan de manera idéntica a una sesión basada en Claude.

Elegir la ruta de API correcta

Claude Code es solo un flujo de trabajo de cliente. La ruta de API correcta depende del cliente y del conjunto de características que necesite:

Para ECAIX, utilice la documentación de Anthropic Messages para la ruta de estilo Anthropic y la documentación de Chat Completions para clientes compatibles con OpenAI. Utilice la página de modelos para confirmar el modelo actual y la página de precios para los precios mostrados actualmente.

Matriz de compatibilidad

La siguiente matriz es un límite de evidencia en el momento de la publicación, no una afirmación de que todas las características están soportadas:

Esta distinción evita presentar una solicitud mínima exitosa como una certificación completa de compatibilidad de Claude Code.

Páginas de detalles de modelos y IDs actuales

Utilice las páginas de detalles de modelos en lugar de copiar una antigua ID de modelo de un artículo de blog:

• DeepSeek v4.1 Flash
• Qwen 3.8 Flash
• GLM 5.3
• Kimi K3

Estas enlaces son puntos de entrada para verificar la ID de modelo actual, la información de contexto y los detalles de nivel de página. La disponibilidad puede cambiar después de la publicación.

Después de un error, utilice este orden en lugar de cambiar varias variables a la vez:

1. Guarde el código de estado HTTP y el cuerpo de la respuesta.
2. Confirme la URL base y el suf