Integração de agentes de código

Os agentes de código acessam o gateway pelo protocolo que já utilizam: /v1/messages para agentes do estilo Claude, /v1/responses para o Codex e /v1/chat/completions para os demais. Aponte a ferramenta para a ChinaAPI e as requisições continuam usando a mesma chave, cota, logs e cobrança do seu próprio tráfego de API.

Hermes Agent

POST /v1/chat/completions

Aponte o bloco model de ~/.hermes/config.yaml para o gateway, ou execute hermes model e escolha Custom endpoint interativamente. base_url inclui o sufixo /v1; o Hermes adiciona /chat/completions automaticamente.

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 as três variáveis de ambiente e inicie o claude normalmente. As variáveis ANTHROPIC_DEFAULT_*_MODEL mapeiam os níveis internos de modelo do Claude Code para modelos da ChinaAPI, o que permite rodar modelos chineses dentro de um Claude Code não modificado.

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

O Codex fala o protocolo Responses, então wire_api deve ser responses; deixá-lo no formato chat quebra as chamadas de ferramentas. Coloque sua chave na variável de ambiente indicada por env_key. O deepseek-v4-pro fala o mesmo formato, então basta trocar o nome do modelo para trocar custo por capacidade.

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

Os três usam o mesmo formulário de provedor OpenAI Compatible, campo a campo. Digite o ID do modelo exatamente como aparece em Console → Modelos; essas ferramentas não buscam automaticamente a lista de modelos para provedores personalizados.

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

Cursor

POST /v1/chat/completions

Substitua a base URL em Settings → Models → OpenAI API Key. Primeiro adicione o nome do modelo ChinaAPI usando Add model, depois deixe apenas os modelos ChinaAPI ativados, pois do contrário o Cursor enviará os nomes de modelo embutidos para sua URL substituída.

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

OpenClaw

POST /v1/messages

Declare a ChinaAPI como um provedor com "api": "anthropic-messages" e liste os modelos que deseja disponibilizar no seletor de sessão.

{
  "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

O Aider roteia pelo prefixo do nome do modelo, então mantenha o prefixo openai/ no nome do modelo mesmo que o modelo em si seja chinês.

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

aider --model openai/deepseek-v4-pro

Escolhendo modelos: os nomes de modelo acima são exemplos funcionais, não uma lista fixa. Abra Console → Modelos para ver os aliases habilitados na sua conta. Para uso com agentes, prefira um modelo voltado a código no nível mais usado pelo agente e um modelo rápido e barato no nível leve — o Claude Code, por exemplo, envia resumos em segundo plano para seu nível Haiku, então mapear esse nível para um modelo pequeno é o que mais economiza cota.