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

Агенты для кода обращаются к шлюзу по тому протоколу, на котором они уже говорят: /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-v4-pro использует тот же формат, поэтому достаточно поменять имя модели, чтобы обменять стоимость на возможности.

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

Все три используют одну и ту же форму провайдера 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-v4-pro

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-v4-pro

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