CodeBuddy カスタムモデル：models.json の書き方と url の指定（2026 年 11 月）

models.json で設定します。ユーザーレベルの ~/.codebuddy/models.json はすべてのプロジェクトに適用され、プロジェクトルート直下の .codebuddy/models.json のほうが優先されます。IDE と CLI は同じパスを読みます。2026-11-10 時点、全フィールドは公式の「models.json Configuration Guide」に載っています。ファイルはホットリロード（1 秒のデバウンス）に対応しているので、保存後に再起動する必要はありません。

Chat 項目には必要です。公式の記載は「url フィールドはインターフェースの完全なパスでなければならず、通常は /chat/completions で終わる」で、https://api.openai.com/v1 は誤った例です。そのため QCode では https://api.qcode.cc/openai/v1/chat/completions と書きます。api: openai-responses を付けた項目は逆で、url はベース（https://api.qcode.cc/openai/v1）、リクエストは {url}/responses に送られ、末尾の /responses は付けても付けなくても構いません。404 が返る場合は、まず Chat 項目の url が /chat/completions まであるか確認してください。

必要ありません。2026-11-10 時点、CodeBuddy Code 2.182.0 で確認したところ、Tencent アカウントにサインインしなくても、models.json と CODEBUDDY_BASE_URL のどちらからも QCode を呼び出して応答を得られました。IDE の設定は公式の IDE ドキュメントに基づきます。また v2.180.0 のリリースノートによると、カスタムモデルはプラットフォームの識別リクエストヘッダーを付けなくなりました。

GPT と中国系モデルを使えます。CodeBuddy のカスタムモデルは OpenAI インターフェースを使い、QCode ではこのプロトコルで GPT と DeepSeek、GLM、Kimi、Qwen を利用できます。Chat 項目には gpt-6.1-sol、deepseek-v4-flash、glm-5.3、kimi-k3、qwen3.8-max、CLI の Responses 項目には gpt-6.1-terra を指定できます。Claude モデルは QCode の Anthropic エンドポイント https://api.qcode.cc/api で提供されています。Claude が必要な場合は、Claude Code、ZCode、Qoder など、このエンドポイントに対応したツールで同じキーを使ってください。

https://api.qcode.cc/openai/v1 を設定し、CODEBUDDY_API_KEY に cr_ で始まる QCode のキー、--model に GPT か中国系モデルの ID を指定します。2026-11-10 時点、CodeBuddy Code 2.182.0 で確認したところ、この変数は OpenAI Chat のベースとして扱われ、CLI が /chat/completions を付けます。この方法なら models.json は不要です。https://api.qcode.cc/api を指定するとリクエストは /api/chat/completions に送られ、QCode は HTTP 400 を返します。公式の説明では、CODEBUDDY_BASE_URL は API エンドポイントのアドレスを上書きし、通常は CODEBUDDY_API_KEY と組み合わせて使います。CODEBUDDY_MODEL はデフォルトのエージェントモデルを上書きします。

ファイルの場所が違います。WorkBuddy の公式説明によると、WorkBuddy はコーディング向けの CodeBuddy と同じ基盤を共有しています。中国本土版は設定をローカルの workbuddy/models.json に保存し、~/.codebuddy/models.json で設定済みのカスタムモデルは UI の更新後も使えると説明しています。国際版の既定ファイルは ~/.workbuddy-ai/models.json です。WorkBuddy のカスタムモデルも OpenAI Chat Completions を使うため、手で書く場合の url は同じ完全なパス https://api.qcode.cc/openai/v1/chat/completions です。メニューと手順は /workbuddy-guide をご覧ください。