Integración de agentes de código

Los agentes de código acceden al gateway mediante el protocolo que ya utilizan: /v1/messages para agentes de estilo Claude, /v1/responses para Codex y /v1/chat/completions para el resto. Apunte la herramienta a ChinaAPI y sus solicitudes seguirán usando la misma clave, cuota, registros y facturación que su propio tráfico de API.

Hermes Agent

POST /v1/chat/completions

Apunte el bloque model de ~/.hermes/config.yaml al gateway, o ejecute hermes model y elija Custom endpoint de forma interactiva. base_url incluye el sufijo /v1; Hermes añade /chat/completions por su cuenta.

model:
  default: kimi-k2.7-code
  provider: custom
  base_url: https://api.chinaapi.ai/v1
  api_key: <your ChinaAPI key>

Claude Code

POST /v1/messages

Exporte las tres variables de entorno e inicie claude como de costumbre. Las variables ANTHROPIC_DEFAULT_*_MODEL asignan los niveles internos de modelo de Claude Code a modelos de ChinaAPI, lo que permite ejecutar modelos chinos dentro de un Claude Code sin modificar.

export ANTHROPIC_BASE_URL=https://api.chinaapi.ai
export ANTHROPIC_AUTH_TOKEN=$CHINAAPI_KEY
export ANTHROPIC_DEFAULT_OPUS_MODEL=kimi-k3
export ANTHROPIC_DEFAULT_SONNET_MODEL=kimi-k2.7-code
export ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-5-turbo

claude

Codex

POST /v1/responses

Codex habla el protocolo Responses, por lo que wire_api debe ser responses; dejarlo en el formato chat rompe las llamadas a herramientas. Coloque su clave en la variable de entorno indicada por env_key. deepseek-v4-pro habla el mismo formato, así que basta con cambiar el nombre del modelo para cambiar coste por capacidad.

model = "deepseek-v4-flash"
model_provider = "chinaapi"

[model_providers.chinaapi]
name = "ChinaAPI"
base_url = "https://api.chinaapi.ai/v1"
wire_api = "responses"
env_key = "CHINAAPI_KEY"

Cline, Roo Code, Kilo Code

POST /v1/chat/completions

Los tres usan el mismo formulario de proveedor OpenAI Compatible, campo por campo. Introduzca el ID de modelo exactamente como aparece en Consola → Modelos; estas herramientas no obtienen automáticamente la lista de modelos para proveedores personalizados.

Base URL   https://api.chinaapi.ai/v1
API Key    <your ChinaAPI key>
Model ID   glm-5.2

Cursor

POST /v1/chat/completions

Sustituya el base URL en Settings → Models → OpenAI API Key. Primero añada el nombre del modelo de ChinaAPI con Add model, y deje activados solo los modelos de ChinaAPI, porque de lo contrario Cursor enviará sus nombres de modelo integrados a la URL sustituida.

Base URL   https://api.chinaapi.ai/v1
API Key    <your ChinaAPI key>
Model      deepseek-v4-pro

OpenClaw

POST /v1/messages

Declare ChinaAPI como proveedor con "api": "anthropic-messages" y enumere los modelos que desee que aparezcan en el selector de sesión.

{
  "models": {
    "providers": {
      "chinaapi": {
        "baseUrl": "https://api.chinaapi.ai",
        "apiKey": "<your ChinaAPI key>",
        "api": "anthropic-messages",
        "models": ["kimi-k3", "glm-5.2"]
      }
    }
  }
}

Aider

POST /v1/chat/completions

Aider enruta según el prefijo del nombre del modelo, así que conserve el prefijo openai/ en el nombre del modelo aunque el modelo en sí sea chino.

export OPENAI_API_BASE=https://api.chinaapi.ai/v1
export OPENAI_API_KEY=$CHINAAPI_KEY

aider --model openai/deepseek-v4-pro

Elegir modelos: los nombres de modelo anteriores son ejemplos funcionales, no una lista fija. Abra Consola → Modelos para ver los alias habilitados en su cuenta. Para tareas de agentes, es mejor usar un modelo especializado en código en el nivel que el agente use con más frecuencia, y un modelo rápido y económico en su nivel ligero; Claude Code, por ejemplo, envía los resúmenes en segundo plano a su nivel Haiku, así que asignar ese nivel a un modelo pequeño es lo que más cuota ahorra.