Tích hợp agent lập trình

Các agent lập trình kết nối tới gateway bằng đúng giao thức chúng vốn dùng: /v1/messages cho agent kiểu Claude, /v1/responses cho Codex, và /v1/chat/completions cho phần còn lại. Trỏ công cụ về ChinaAPI và các request của nó vẫn dùng chung khóa, hạn mức, nhật ký và cách tính phí như lưu lượng API của chính bạn.

Hermes Agent

POST /v1/chat/completions

Trỏ khối model trong ~/.hermes/config.yaml về gateway, hoặc chạy hermes model và chọn Custom endpoint theo cách tương tác. base_url bao gồm hậu tố /v1; Hermes tự nối /chat/completions.

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

Export ba biến môi trường rồi khởi động claude như bình thường. Các biến ANTHROPIC_DEFAULT_*_MODEL ánh xạ các bậc mô hình nội bộ của Claude Code sang mô hình ChinaAPI — đây chính là cách chạy mô hình Trung Quốc bên trong một Claude Code không sửa đổi.

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 dùng giao thức Responses, nên wire_api phải là responses; để nguyên dạng chat sẽ làm hỏng lời gọi công cụ. Đặt khóa của bạn vào biến môi trường được chỉ định bởi env_key. deepseek-v4-pro dùng cùng định dạng, nên chỉ cần đổi tên mô hình là bạn có thể đánh đổi chi phí lấy năng lực.

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

Cả ba dùng chung biểu mẫu nhà cung cấp OpenAI Compatible, giống nhau từng trường. Nhập ID mô hình đúng như hiển thị trong Bảng điều khiển → Mô hình; các công cụ này không tự tải danh sách mô hình cho nhà cung cấp tùy chỉnh.

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

Cursor

POST /v1/chat/completions

Ghi đè base URL tại Settings → Models → OpenAI API Key. Trước tiên hãy thêm tên mô hình ChinaAPI bằng Add model, sau đó chỉ bật các mô hình ChinaAPI, nếu không Cursor sẽ gửi tên mô hình tích hợp sẵn của nó tới URL ghi đè của bạn.

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

OpenClaw

POST /v1/messages

Khai báo ChinaAPI như một nhà cung cấp với "api": "anthropic-messages" và liệt kê những mô hình bạn muốn chọn được trong trình chọn phiê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 định tuyến theo tiền tố tên mô hình, vì vậy hãy giữ tiền tố openai/ ngay cả khi bản thân mô hình là của Trung Quốc.

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

aider --model openai/deepseek-v4-pro

Chọn mô hình: các tên mô hình ở trên là ví dụ đang hoạt động, không phải danh sách cố định. Mở Bảng điều khiển → Mô hình để xem các alias đang bật cho tài khoản của bạn. Với công việc agent, nên đặt mô hình chuyên về lập trình ở bậc mà agent dùng nhiều nhất và một mô hình nhanh, rẻ ở bậc nhẹ — ví dụ Claude Code gửi phần tóm tắt chạy nền xuống bậc Haiku, nên ánh xạ bậc đó sang mô hình nhỏ sẽ tiết kiệm hạn mức nhiều nhất.