编程 Agent 接入

编程 Agent 通过各自原本使用的协议接入网关：Claude 类 Agent 使用 /v1/messages，Codex 使用 /v1/responses，其余工具使用 /v1/chat/completions。把工具指向 ChinaAPI 后，它发出的请求与你自己的 API 流量共用同一套 API Key、额度、日志和计费。

Hermes Agent

POST /v1/chat/completions

把 ~/.hermes/config.yaml 中的 model 配置块指向网关，或运行 hermes model，在交互式菜单中选择 Custom endpoint。base_url 要带上 /v1 后缀；/chat/completions 由 Hermes 自行追加。

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

导出下面这些环境变量，然后照常启动 claude。ANTHROPIC_DEFAULT_*_MODEL 这组变量把 Claude Code 内部的模型档位映射到 ChinaAPI 的模型上，正因如此，你才能在未经改动的 Claude Code 里运行中国模型。

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 使用 Responses 协议，所以 wire_api 必须设为 responses；如果保留 chat 传输格式，工具调用会出错。把你的 API Key 放进 env_key 所指定的环境变量中。新接入请使用 deepseek-flash；已退役的 DeepSeek 模型 ID 仅为兼容而保留，不再出现在模型目录中。

model = "deepseek-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

这三款工具使用同一个 OpenAI Compatible 提供商表单，字段逐一对应。模型 ID 请严格按照控制台 → 模型广场中的写法填写；对于自定义提供商，这些工具不会拉取模型列表。

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

Cursor

POST /v1/chat/completions

在 Settings → Models → OpenAI API Key 下覆盖 Base URL。先用 Add model 添加 ChinaAPI 的模型名，再只保留 ChinaAPI 模型处于启用状态，否则 Cursor 会把它内置的模型名发到你覆盖后的地址。

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

OpenClaw

POST /v1/messages

用 "api": "anthropic-messages" 把 ChinaAPI 声明为一个提供商，并列出你希望在会话模型选择器中可选的模型。

{
  "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 按模型名前缀决定路由，所以即使模型本身是中国模型，也要在模型名上保留 openai/ 前缀。

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

aider --model openai/deepseek-flash

如何选择模型：上面的模型名是可用的示例，并非固定清单。打开控制台 → 模型广场，查看你的账户已启用的别名。用于 Agent 时，建议在 Agent 最常用的档位上配置针对编程调优的模型，在轻量档位上配置便宜、快速的模型——例如 Claude Code 会把后台摘要任务发往 Haiku 档位，把这一档映射到小模型最能节省额度。