코딩 에이전트 통합

검색 /

코딩 에이전트는 이미 사용하고 있는 프로토콜 그대로 게이트웨이에 연결합니다. Claude 계열 에이전트는 /v1/messages, Codex는 /v1/responses, 그 외에는 /v1/chat/completions를 사용합니다. 도구가 ChinaAPI를 가리키도록 설정하면, 해당 요청도 여러분의 API 트래픽과 동일한 키·쿼터·로그·과금을 그대로 사용합니다.

Base URL 형태 Claude Code는 전달받은 값 뒤에 /v1/messages를 스스로 붙이므로, 호스트만 있는 https://api.chinaapi.ai를 사용합니다. 이 페이지의 다른 모든 도구는 /v1 접미사를 명시적으로 요구합니다. /v1이 중복되거나 빠지는 것이 여기서 404가 발생하는 가장 흔한 원인입니다.

Hermes Agent

POST /v1/chat/completions

~/.hermes/config.yaml의 model 블록을 게이트웨이로 향하게 하거나, hermes model을 실행해 대화형으로 Custom endpoint를 선택하세요. base_url에는 /v1 접미사까지 포함하며, /chat/completions는 Hermes가 자동으로 붙입니다.

yaml · ~/.hermes/config.yaml

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한 뒤 평소처럼 claude를 실행하세요. ANTHROPIC_DEFAULT_*_MODEL 변수는 Claude Code 내부의 모델 등급을 ChinaAPI 모델에 매핑하며, 이를 통해 수정하지 않은 Claude Code에서도 중국 모델을 실행할 수 있습니다.

shell · 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도 같은 형식을 사용하므로, 모델 이름만 바꾸면 비용과 성능을 맞바꿀 수 있습니다.

toml · ~/.codex/config.toml

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 제공업체 양식을 항목별로 그대로 사용합니다. 모델 ID는 콘솔 → 모델에 표시된 그대로 정확히 입력하세요. 이 도구들은 커스텀 제공업체의 모델 목록을 자동으로 가져오지 않습니다.

Settings → API Provider → OpenAI Compatible

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가 내장 모델 이름을 재정의한 URL로 그대로 전송합니다.

Settings → Models → Override Base URL

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

OpenClaw

POST /v1/messages

"api": "anthropic-messages"로 ChinaAPI를 제공업체로 선언하고, 세션 선택기에 표시할 모델을 나열하세요.

json · ~/.openclaw/openclaw.json

{
  "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/ 접두사는 그대로 유지하세요.

shell · Aider

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

aider --model openai/deepseek-v4-pro

모델 선택: 위의 모델 이름은 동작 예시일 뿐 고정된 목록이 아닙니다. 계정에서 활성화된 별칭은 콘솔 → 모델에서 확인하세요. 에이전트 용도로는 가장 많이 쓰이는 등급에 코딩 특화 모델을, 가벼운 등급에는 저렴하고 빠른 모델을 배치하는 것이 좋습니다. 예를 들어 Claude Code는 백그라운드 요약을 Haiku 등급으로 보내므로, 이 등급을 작은 모델에 매핑하면 쿼터를 가장 많이 절약할 수 있습니다.