AI Coding Agent 與 Harness
把 Claude Code、Codex CLI、OpenClaw、Cline、Cursor 等 25+ coding agent 按同樣的三步指到閘道器 —— 每條都給出確切的設定落點與關鍵設定項。
每個 AI coding agent 都從某個地方讀 base URL 與 API key —— 環境變數、設定檔案或設定面板。本頁列出每個 harness 從哪裡讀、說哪種協議、以及真正會絆倒人的那條坑。完整可複製的設定教程在文件網站。
base_url 指向閘道器
預設 https://your-gateway.gatellm.io —— 是否含 /v1 因 SDK 而異（每個示例給出確切值）。
換成閘道器 access key
不是上游的 sk-… 金鑰 —— 同一把 access key 裝進你 SDK 期望的任意 header。
模型名用閘道器設定名
是你在控制台設定的名字 —— 不是廠商官方名。
Authorization: Bearer <key>x-api-key: <key>x-goog-api-key: <key>Harness 相容矩陣
| Harness | 協議 | 支援度 | 設定落點 | 關鍵設定項 | 文件 |
|---|---|---|---|---|---|
| 終端 agent | |||||
| Claude Code | Anthropic | 原生 | env vars | ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY, ANTHROPIC_MODEL | GitHub 設定檔 ↗ · 文件 |
| Codex CLI | OpenAI Responses | 原生 | ~/.codex/config.toml | base_url, env_key, wire_api | GitHub 設定檔 ↗ · 文件 |
| Gemini CLI | Gemini | 原生 | env vars | GOOGLE_GEMINI_BASE_URL, GEMINI_API_KEY | GitHub 設定檔 ↗ · 文件 |
| OpenClaw | OpenAI / Anthropic-compatible | OpenAI 相容 | openclaw.json | models.providers.<id>.baseUrl, models.providers.<id>.apiKey | 文件 |
| opencode | OpenAI-compatible | OpenAI 相容 | opencode.json | provider.<id>.options.baseURL | 文件 |
| Crush | OpenAI / Anthropic-compatible | OpenAI 相容 | crush.json | providers.<id>.base_url, providers.<id>.type | 文件 |
| Factory Droid | OpenAI / Anthropic-compatible | OpenAI 相容 | ~/.factory/settings.json | customModels[].baseUrl, customModels[].provider | 文件 |
| Goose | OpenAI-compatible | OpenAI 相容 | env vars | OPENAI_HOST, OPENAI_BASE_PATH, OPENAI_API_KEY | 文件 |
| Aider | OpenAI-compatible (LiteLLM) | OpenAI 相容 | env vars | OPENAI_API_BASE | 文件 |
| Qwen Code | OpenAI-compatible | OpenAI 相容 | env vars | OPENAI_BASE_URL, OPENAI_API_KEY, OPENAI_MODEL | 文件 |
| OpenHands | OpenAI-compatible (LiteLLM) | OpenAI 相容 | ~/.openhands/settings.json | base_url, model openai/ prefix | 文件 |
| Kimi Code CLI | OpenAI / Anthropic | OpenAI 相容 | config.toml | providers | 文件 |
| Plandex | OpenAI-compatible | OpenAI 相容 | custom models JSON | baseUrl | 文件 |
| SWE-agent | OpenAI-compatible (LiteLLM) | OpenAI 相容 | env vars | OPENAI_BASE_URL | 文件 |
| Grok Build | OpenAI-compatible | OpenAI 相容 | config.toml | custom models | 文件 |
| Mistral Vibe | OpenAI-compatible | OpenAI 相容 | ~/.vibe/config.toml | providers | 文件 |
| MiMo Code | OpenAI-compatible | OpenAI 相容 | /connect custom provider | base URL, API key | 文件 |
| ForgeCode | OpenAI / Anthropic | OpenAI 相容 | setup wizard | base URL | 文件 |
| Codebuff | OpenAI-compatible | OpenAI 相容 | settings | base URL, API key | 文件 |
| IDE / 編輯器外掛 | |||||
| Cline | OpenAI-compatible | OpenAI 相容 | Settings → OpenAI Compatible | Base URL, API Key, Model ID | 文件 |
| Roo Code | OpenAI-compatible | OpenAI 相容 | Settings → OpenAI Compatible | Base URL, API Key, Model ID | 文件 |
| Kilo Code | OpenAI-compatible | OpenAI 相容 | Settings → OpenAI Compatible | Base URL, API Key, Model ID | 文件 |
| Continue | OpenAI-compatible | OpenAI 相容 | config.yaml | models[].apiBase | 文件 |
| Zed | OpenAI-compatible | OpenAI 相容 | settings.json | language_models.openai_compatible.<id>.api_url | 文件 |
| Cursor | OpenAI | 部分支援 | Settings → Models → Override OpenAI Base URL | Override OpenAI Base URL | 文件 |
| Windsurf | OpenAI-compatible | OpenAI 相容 | Settings → Models → BYOK / custom | Base URL, API Key | 文件 |
| GitHub Copilot (BYOK) | OpenAI-compatible | OpenAI 相容 | Manage Models → OpenAI-compatible | Base URL, API Key | 文件 |
| 託管平台 | |||||
| Warp | OpenAI / Anthropic / Gemini (BYOK) | 部分支援 | Settings → BYOK | BYOK API keys | 文件 |
| Amazon Q Developer CLI | MCP | 無自訂端點 | MCP server | — | 文件 |
| Devin | — | 無自訂端點 | — | — | 文件 |
閘道器模型該叫什麼名字
有些 harness 釘死了自己的模型 ID、原樣傳送。如果你的閘道器模型名不一樣，第一次呼叫就會 404。兩種對齊方式：
把閘道器模型名取成 harness 實際請求的 ID —— 零額外設定。
或用它的模型環境變數（如 ANTHROPIC_MODEL）指到你的閘道器名。
接入坑
Claude Code 傳送的是它自己設定的預設 ID（如 claude-opus-5 或 claude-sonnet-5），不是你的閘道器名。要麼把閘道器模型名取成 harness 實際請求的 ID，要麼用它的模型環境變數（如 ANTHROPIC_MODEL）指到你的閘道器名。名字不對 → 第一條訊息就 404 model_not_found。
Anthropic 風格客戶端的 base URL 要指向閘道器根（不帶 /v1）—— 客戶端自己拼 /v1/messages。這裡多寫一個 /v1 會讓路徑段疊一層。
Codex CLI 的 [model_providers.*] 設定塊要求 wire_api = "responses"。閘道器原生實現 /v1/responses —— 把 base_url 指過來、env_key 指向閘道器 access key 即可。
Aider、OpenHands、SWE-agent 底層是 LiteLLM：把 OPENAI_API_BASE 設成閘道器，模型名帶 openai/ 字首（如 openai/閘道器模型名），LiteLLM 才按 OpenAI 相容端點路由。
Codex、Gemini CLI、Qwen Code 預設走廠商的 OAuth / 訂閱登入。要經閘道器必須顯式切到 API key 認證（同時設 key 與 base URL）—— 否則會直接繞過閘道器。
Cline / Roo / Kilo 等按模型名判斷工具呼叫與視覺能力。自訂閘道器名可能關掉函式呼叫 —— 工具呼叫失敗時，檢查客戶端的能力檢測規則，或把模型名取成它認識的家族名。
上游長推理期間閘道器會發 SSE 的 :keep-alive 註釋行（無害，跳過以 : 開頭的行即可）；中途斷流時會插入 _gateway_warning 欄位而不是直接報錯 —— 設計目標就是避免 Claude Code 這類 harness 因流錯誤中斷整段會話。
auto mode 下，Claude Code 在執行可能有危險的動作前，會等一份伺服器端裁決（請求體裡的 safeguards 欄位）。上游是官方 Anthropic 時，裁決在同一次請求裡由上游給出，閘道器原樣透通、不加干預。上游是忽略該欄位的第三方時，改由閘道器應答 —— 出廠預設（allow_all）放行全部動作，比不介入更寬鬆。要把某條上游上的這個判斷交回給它自己，就在該上游的 extra_config 裡寫 "anthropic_server_safeguards": "upstream"；控制台裡這項設定僅 admin 可改。
# 每個 agent 都只是「一個 base_url + 一把 access key」
export ANTHROPIC_BASE_URL="https://your-gateway.gatellm.io" # Anthropic 系 agent：根（不帶 /v1）
export ANTHROPIC_API_KEY="<閘道器 access key>"
export OPENAI_API_BASE="https://your-gateway.gatellm.io/v1" # OpenAI 相容 agent：帶 /v1
export OPENAI_API_KEY="<閘道器 access key>"
# Codex CLI（~/.codex/config.toml）走 Responses 協議
# [model_providers.gatellm]
# base_url = "https://your-gateway.gatellm.io/v1"
# wire_api = "responses"