Интеграция агентов для кода

Агенты для кода обращаются к шлюзу по тому протоколу, на котором они уже говорят: /v1/messages для агентов в стиле Claude, /v1/responses для Codex и /v1/chat/completions для всех остальных. Направьте инструмент на ChinaAPI — и его запросы сохранят тот же ключ, квоту, журналы и тарификацию, что и ваш собственный трафик API.

Hermes Agent

POST /v1/chat/completions

Направьте блок model в ~/.hermes/config.yaml на шлюз или запустите 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 ломает вызовы инструментов. Поместите ключ в переменную окружения, указанную в env_key. Для новых интеграций используйте deepseek-flash; снятые с публикации ID DeepSeek сохранены только для совместимости и больше не отображаются в каталоге моделей.

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, поле в поле. Вводите идентификатор модели ровно так, как он показан в разделе Консоль → Модели: для пользовательских провайдеров эти инструменты не запрашивают список моделей.

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

Cursor

POST /v1/chat/completions

Переопределите базовый URL в Settings → Models → OpenAI API Key. Сначала добавьте имя модели ChinaAPI через Add model, затем оставьте включёнными только модели ChinaAPI, иначе Cursor будет отправлять на ваш URL свои встроенные имена моделей.

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

OpenClaw

POST /v1/messages

Объявите ChinaAPI как провайдера с "api": "anthropic-messages" и перечислите модели, которые должны быть доступны для выбора в сессии.

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

Выбор моделей: имена моделей выше — рабочие примеры, а не фиксированный список. Откройте Консоль → Модели, чтобы увидеть псевдонимы, включённые для вашей учётной записи. Для работы с агентами возьмите модель, настроенную под код, на тот уровень, который агент использует чаще всего, и дешёвую быструю модель — на его лёгкий уровень: например, Claude Code отправляет фоновое реферирование на уровень Haiku, поэтому привязка этого уровня к небольшой модели экономит больше всего квоты.