# AI コーディングエージェントとハーネス - GateLLM

> Claude Code、Codex CLI、OpenClaw、Cline、Cursor、Zed、Goose、Aider など 25+ のコーディングエージェントを GateLLM に接続。各ハーネスの base URL、設定対象、ハマりどころをひとまとめに。

正規 URL: https://www.gatellm.io/ja/coding-agents/

## AI コーディングエージェントとハーネス
Claude Code、Codex CLI、OpenClaw、Cline、Cursor など 25+ のコーディングエージェントを、同じ 3 ステップでゲートウェイに向けられます。それぞれの正確な設定対象とキー名も掲載しています。
すべての AI コーディングエージェントは、どこかから base URL と API キーを読み取ります。環境変数、設定ファイル、設定パネルのいずれかです。本ページでは、各ハーネスがどこから読むか、どのプロトコルを話すか、実際につまずきやすいハマりどころを 1 つ挙げます。コピーして使える完全な設定はドキュメントにあります。
## ゲートウェイのモデルに付ける名前
一部のハーネスは独自のモデル ID を固定してそのまま送信します。ゲートウェイのモデル名が異なると、最初の呼び出しが 404 になります。合わせる方法は 2 つです。
ゲートウェイのモデルに、ハーネスが要求する名前をそのまま付ける。追加設定は不要です。
または、ハーネスのモデル環境変数（例：ANTHROPIC_MODEL）でゲートウェイの名前に上書きする。
## 任意の AI コーディングエージェントをゲートウェイに向ける
```
# Every agent is one base_url + one access key away
export ANTHROPIC_BASE_URL="https://your-gateway.gatellm.io"   # Anthropic agents: root (no /v1)
export ANTHROPIC_API_KEY="<gateway access key>"

export OPENAI_API_BASE="https://your-gateway.gatellm.io/v1"   # OpenAI-compatible agents: /v1
export OPENAI_API_KEY="<gateway access key>"

# Codex CLI (~/.codex/config.toml) speaks the Responses protocol
# [model_providers.gatellm]
# base_url = "https://your-gateway.gatellm.io/v1"
# wire_api = "responses"
```
### `Authorization: Bearer <key>`
- SDK / フレームワーク: OpenAI · DashScope · 汎用
- Bearer プレフィックスは大文字小文字を区別しません

### `x-api-key: <key>`
- SDK / フレームワーク: Anthropic SDK
- Authorization も使用可能

### `x-goog-api-key: <key>`
- SDK / フレームワーク: Gemini SDK
- Authorization も使用可能

## ハーネス互換性マトリクス

### ターミナルエージェント
Claude Code、Codex CLI、Gemini CLI、OpenClaw、opencode、Crush、Droid、Goose、Aider、Qwen Code、OpenHands、Kimi Code、Plandex、SWE-agent、Grok Build、Mistral Vibe、MiMo Code、ForgeCode、Codebuff
| ハーネス | プロトコル | 対応状況 | 設定対象 | キー名 / 設定 | ドキュメント |
| --- | --- | --- | --- | --- | --- |
| Claude Code | Anthropic | ネイティブ | env vars | ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY, ANTHROPIC_MODEL | https://docs.gatellm.io/en/quickstart/claude-code-via-gateway |
| Codex CLI | OpenAI Responses | ネイティブ | ~/.codex/config.toml | base_url, env_key, wire_api | https://docs.gatellm.io/en/reference/clients-and-gateway-diffs |
| Gemini CLI | Gemini | ネイティブ | env vars | GOOGLE_GEMINI_BASE_URL, GEMINI_API_KEY | https://docs.gatellm.io/en/reference/clients-and-gateway-diffs |
| OpenClaw | OpenAI / Anthropic-compatible | OpenAI 互換 | openclaw.json | models.providers.<id>.baseUrl, models.providers.<id>.apiKey | https://docs.gatellm.io/en/quickstart/anthropic-interop |
| opencode | OpenAI-compatible | OpenAI 互換 | opencode.json | provider.<id>.options.baseURL | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Crush | OpenAI / Anthropic-compatible | OpenAI 互換 | crush.json | providers.<id>.base_url, providers.<id>.type | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Factory Droid | OpenAI / Anthropic-compatible | OpenAI 互換 | ~/.factory/settings.json | customModels[].baseUrl, customModels[].provider | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Goose | OpenAI-compatible | OpenAI 互換 | env vars | OPENAI_HOST, OPENAI_BASE_PATH, OPENAI_API_KEY | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Aider | OpenAI-compatible (LiteLLM) | OpenAI 互換 | env vars | OPENAI_API_BASE | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Qwen Code | OpenAI-compatible | OpenAI 互換 | env vars | OPENAI_BASE_URL, OPENAI_API_KEY, OPENAI_MODEL | https://docs.gatellm.io/en/quickstart/openai-compatible |
| OpenHands | OpenAI-compatible (LiteLLM) | OpenAI 互換 | ~/.openhands/settings.json | base_url, model openai/ prefix | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Kimi Code CLI | OpenAI / Anthropic | OpenAI 互換 | config.toml | providers | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Plandex | OpenAI-compatible | OpenAI 互換 | custom models JSON | baseUrl | https://docs.gatellm.io/en/quickstart/openai-compatible |
| SWE-agent | OpenAI-compatible (LiteLLM) | OpenAI 互換 | env vars | OPENAI_BASE_URL | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Grok Build | OpenAI-compatible | OpenAI 互換 | config.toml | custom models | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Mistral Vibe | OpenAI-compatible | OpenAI 互換 | ~/.vibe/config.toml | providers | https://docs.gatellm.io/en/quickstart/openai-compatible |
| MiMo Code | OpenAI-compatible | OpenAI 互換 | /connect custom provider | base URL, API key | https://docs.gatellm.io/en/quickstart/openai-compatible |
| ForgeCode | OpenAI / Anthropic | OpenAI 互換 | setup wizard | base URL | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Codebuff | OpenAI-compatible | OpenAI 互換 | settings | base URL, API key | https://docs.gatellm.io/en/quickstart/openai-compatible |

### IDE / 拡張機能
Cline、Roo Code、Kilo Code、Continue、Zed、Cursor、Windsurf、GitHub Copilot（BYOK）
| ハーネス | プロトコル | 対応状況 | 設定対象 | キー名 / 設定 | ドキュメント |
| --- | --- | --- | --- | --- | --- |
| Cline | OpenAI-compatible | OpenAI 互換 | Settings → OpenAI Compatible | Base URL, API Key, Model ID | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Roo Code | OpenAI-compatible | OpenAI 互換 | Settings → OpenAI Compatible | Base URL, API Key, Model ID | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Kilo Code | OpenAI-compatible | OpenAI 互換 | Settings → OpenAI Compatible | Base URL, API Key, Model ID | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Continue | OpenAI-compatible | OpenAI 互換 | config.yaml | models[].apiBase | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Zed | OpenAI-compatible | OpenAI 互換 | settings.json | language_models.openai_compatible.<id>.api_url | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Cursor | OpenAI | 一部対応 | Settings → Models → Override OpenAI Base URL | Override OpenAI Base URL | https://docs.gatellm.io/en/quickstart/openai-compatible |
| Windsurf | OpenAI-compatible | OpenAI 互換 | Settings → Models → BYOK / custom | Base URL, API Key | https://docs.gatellm.io/en/quickstart/openai-compatible |
| GitHub Copilot (BYOK) | OpenAI-compatible | OpenAI 互換 | Manage Models → OpenAI-compatible | Base URL, API Key | https://docs.gatellm.io/en/quickstart/openai-compatible |

### マネージドプラットフォーム
Warp（BYOK キーのみ）、Amazon Q Developer CLI、Devin。エンドポイントが固定、または上書き不可
| ハーネス | プロトコル | 対応状況 | 設定対象 | キー名 / 設定 | ドキュメント |
| --- | --- | --- | --- | --- | --- |
| Warp | OpenAI / Anthropic / Gemini (BYOK) | 一部対応 | Settings → BYOK | BYOK API keys | https://docs.gatellm.io/en/reference/supported-models-and-sdks |
| Amazon Q Developer CLI | MCP | カスタムエンドポイント不可 | MCP server | — | https://docs.gatellm.io/en/reference/supported-models-and-sdks |
| Devin | — | カスタムエンドポイント不可 | — | — | https://docs.gatellm.io/en/reference/supported-models-and-sdks |

## ハマりどころ
### ハーネスは独自のモデル ID を固定して送信します
Claude Code は設定済みの既定モデル（例：claude-opus-5 や claude-sonnet-5）を送信し、ゲートウェイ側の名前では送りません。ゲートウェイのモデル名をハーネスが要求する名前と完全に一致させるか、モデル環境変数（例：ANTHROPIC_MODEL）をゲートウェイの名前に設定してください。不一致だと最初のメッセージで 404 model_not_found になります。

### Anthropic プロトコルのハーネスは /v1 ではなくルートを指定します
Anthropic 形式クライアントの base URL はゲートウェイのルート（/v1 なし）です。クライアント自身が /v1/messages を付加します。ここで /v1 を付けるとパスセグメントが二重になります。

### Codex のカスタムプロバイダーには wire_api="responses" が必要です
Codex CLI ではカスタムの [model_providers.*] ブロックに wire_api = "responses" が必須です。ゲートウェイは /v1/responses をネイティブに実装しているため、base_url をそこに向け、env_key にゲートウェイのアクセスキーを設定してください。

### LiteLLM ベースのハーネスは openai/ モデルプレフィックスを要求します
Aider、OpenHands、SWE-agent は LiteLLM 上に構築されています。OPENAI_API_BASE をゲートウェイに設定し、モデル名に openai/ プレフィックス（例：openai/gateway-model-name）を付けると、LiteLLM が OpenAI 互換エンドポイントとしてルーティングします。

### 既定はサブスクリプションの OAuth で、お客様のキーではありません
Codex、Gemini CLI、Qwen Code は既定でベンダーの OAuth / サブスクリプションログインを使います。ゲートウェイ経由にするには API キー認証へ切り替える（キーと base URL を明示的に設定する）必要があります。そうしないとエージェントはゲートウェイを完全に迂回します。

### IDE はモデル ID からツール / ビジョン対応を推測します
Cline / Roo / Kilo などはモデル名からツール呼び出しとビジョンの対応可否を判断します。ゲートウェイのカスタム名では関数呼び出しが無効になることがあります。ツール呼び出しが失敗する場合は、クライアントのケイパビリティ検出ルールを確認するか、既知のファミリー名に合わせてモデルを命名してください。

### 長時間の推論では :keep-alive と _gateway_warning が付与されます
アップストリームの推論が長引くと、ゲートウェイは SSE の :keep-alive コメント行を出力します（無害です。: で始まる行はスキップしてください）。ストリームが途中で切れた場合はエラーにせず _gateway_warning フィールドを挿入するため、Claude Code のようなハーネスが会話全体を中断しません。

### Claude Code の auto モード：安全判定に誰が答えるかを決めます
auto モードでは、Claude Code は潜在的に危険な操作の前にサーバー側の判定（リクエスト内の safeguards フィールド）を待ちます。アップストリームが Anthropic 公式の場合、判定は同じリクエスト内で生成され、ゲートウェイはそれをそのまま通します。このフィールドを無視する第三者アップストリームの場合、代わりにゲートウェイが判定を返します。出荷時の既定（allow_all）はあらゆる操作を許可するため、呼び出しをそのまま通すより緩くなります。そのアップストリームの extra_config に "anthropic_server_safeguards": "upstream" と書けば、ルートをアップストリーム側に戻せます。コンソールの設定は管理者のみが変更できます。

## FAQ
### Claude Code を GateLLM 経由で使えますか？
はい。ANTHROPIC_BASE_URL をゲートウェイのルート（/v1 なし）に、ANTHROPIC_API_KEY をゲートウェイのアクセスキーに設定します。ゲートウェイのモデル名は Claude Code が要求する ID（例：claude-opus-5 や claude-sonnet-5）と完全に一致させるか、ANTHROPIC_MODEL で合わせてください。
### Codex CLI をゲートウェイに向けるには？
~/.codex/config.toml に [model_providers.<id>] ブロックを追加し、base_url = "https://your-gateway.gatellm.io/v1"、env_key にアクセスキーの環境変数、wire_api = "responses" を設定します。ゲートウェイは /v1/responses をネイティブに実装しています。
### カスタムエンドポイントを使えないコーディングエージェントは？
Devin や Amazon Q Developer CLI のようなホスト型プラットフォームはカスタム base URL を公開しないため、ゲートウェイ経由にはできません。Warp は BYOK キーに対応しますが、エンドポイントは公式プロバイダーに固定されています。それ以外は本ページのもので base URL を上書きできます。
### IDE 拡張機能（Cline / Roo / Kilo）は動きますか？
はい。設定で「OpenAI Compatible」プロバイダーを選び、ゲートウェイの /v1 URL、アクセスキー、モデル名を貼り付けます。ケイパビリティ検出に注意してください。モデル ID からツール呼び出し対応を推測するものがあります。
### なぜモデル名がそれほど重要なのでしょうか？
ハーネスは固定のモデル ID（独自の既定値か、お客様が設定した名前）を送信します。ゲートウェイはその正確な文字列でルーティングするため、不一致は無視できるタイポではなく 404 model_not_found になります。
### LiteLLM ベースのエージェント（Aider / OpenHands / SWE-agent）は？
これらは OPENAI_API_BASE を読み、モデル名に openai/ プレフィックスを要求します。LiteLLM がゲートウェイを OpenAI 互換エンドポイントとして扱うためです。

## 関連ページ
- [ホーム](https://www.gatellm.io/ja/index.md)
- [料金](https://www.gatellm.io/ja/pricing.md)
- [コスト計算ツール](https://www.gatellm.io/ja/calculator.md)
- [会社概要](https://www.gatellm.io/ja/about.md)
- [デモを予約](https://www.gatellm.io/ja/demo.md)
- [FAQ](https://www.gatellm.io/ja/faq.md)
- [AI ゲートウェイ比較](https://www.gatellm.io/ja/compare.md)
- [LiteLLM 比較](https://www.gatellm.io/ja/compare/litellm.md)
- [OpenRouter 比較](https://www.gatellm.io/ja/compare/openrouter.md)
- [Alibaba Cloud AI Gateway 比較](https://www.gatellm.io/ja/compare/alibaba-cloud.md)
- [Azure API Management 比較](https://www.gatellm.io/ja/compare/azure-apim.md)
- [Apigee 比較](https://www.gatellm.io/ja/compare/apigee.md)
- [Cloudflare AI Gateway 比較](https://www.gatellm.io/ja/compare/cloudflare.md)
- [Kong AI Gateway 比較](https://www.gatellm.io/ja/compare/kong.md)
- [Portkey 比較](https://www.gatellm.io/ja/compare/portkey.md)
- [LiteLLM vs Kong AI Gateway](https://www.gatellm.io/ja/compare/litellm-vs-kong.md)
- [LiteLLM vs OpenRouter](https://www.gatellm.io/ja/compare/litellm-vs-openrouter.md)
- [LiteLLM vs Portkey](https://www.gatellm.io/ja/compare/litellm-vs-portkey.md)
- [ユースケース](https://www.gatellm.io/ja/use-cases.md)
- [LLM コスト削減](https://www.gatellm.io/ja/use-cases/reduce-cost.md)
- [高可用性](https://www.gatellm.io/ja/use-cases/high-availability.md)
- [マルチテナント分離](https://www.gatellm.io/ja/use-cases/multi-tenant.md)
- [コンプライアンスと監査](https://www.gatellm.io/ja/use-cases/compliance-audit.md)
- [症状別トラブルシューティング](https://www.gatellm.io/ja/use-cases/troubleshooting.md)
- [マルチベンダー混合モデル構成](https://www.gatellm.io/ja/use-cases/mixed-model-stack.md)
- [Office 内での AI セルフホスト](https://www.gatellm.io/ja/use-cases/self-hosted-office-ai.md)
- [Token 使用量の可視化と帰属](https://www.gatellm.io/ja/use-cases/token-ops.md)
- [Token FinOps：AI コストの配賦と統制](https://www.gatellm.io/ja/use-cases/token-finops.md)
- [MCP ツールガバナンス](https://www.gatellm.io/ja/use-cases/mcp-tool-governance.md)
- [すべてのモデルに Web 検索を追加](https://www.gatellm.io/ja/use-cases/web-search-grounding.md)
- [マルチキーのローテーションと待機系](https://www.gatellm.io/ja/use-cases/multi-key-pooling.md)
- [接続クライアントの受付制御](https://www.gatellm.io/ja/use-cases/client-admission-control.md)
- [モデル利用ポリシーの強制](https://www.gatellm.io/ja/use-cases/enforce-model-policy.md)
- [クライアントにモデル選択を公開しない](https://www.gatellm.io/ja/use-cases/automatic-model-tiering.md)
- [1 つのプロトコルで、あらゆるモデル](https://www.gatellm.io/ja/use-cases/one-protocol-any-model.md)
- [Office / Microsoft 365 アドイン](https://www.gatellm.io/ja/office-addin.md)
- [用語集](https://www.gatellm.io/ja/glossary.md)
- [モデルカタログ](https://www.gatellm.io/ja/models.md)
- [SDK・フレームワーク連携](https://www.gatellm.io/ja/integrations.md)
- [セキュリティとコンプライアンス](https://www.gatellm.io/ja/security.md)