ZCode のカスタムモデル設定：自分の API キーで Claude・GPT・中国系モデルを使う（2026 年 11 月）

使えます。ZCode 公式の「Connect Models」ページには、Anthropic / OpenAI プロトコル互換のモデルサービスをカスタムプロバイダーとして追加できると書かれています。Add Provider でエンドポイントと API キーを入力し、Add Model でモデル ID を手動で追加します。2026-11-10 時点で ZCode CLI 0.17.1 で確認したところ、QCode の三つのプロトコルをそのまま呼び出せました。Anthropic は https://api.qcode.cc/api、OpenAI Chat と Responses は https://api.qcode.cc/openai/v1、キーは cr_ で始まる QCode キーです。課金はトークン単位で、モデルごとの単価は /models にあります。

デスクトップ版：チャット欄のモデル名をクリックし、モデル選択欄の下部にある Manage Models で Settings -> Model Settings を開き、左側のプロバイダー一覧の下部にある Add Provider をクリックします。使えるモデルがない初回起動時は、ようこそ画面の Use API Key からもモデル設定に進めます。CLI：デスクトップ版の ~/.zcode/v2/config.json ではなく ~/.zcode/v2/provider_config.json を編集し、URL は options.baseURL ではなく api.baseUrl に書きます。公式の CLI ドキュメントによると ZCODE_BASE_URL は製品自体のサービスエンドポイントに関わる変数なので、モデル API の URL は入れません。

ZCode のカスタムプロバイダーは Anthropic プロトコルに対応しているので、QCode の Anthropic ベース URL https://api.qcode.cc/api を入力して Claude モデルを呼び出せます。2026-11-10 時点で ZCode CLI 0.17.1 では claude-haiku-5-5 がそのまま応答し、claude-sonnet-5-5、claude-opus-5-5 も /models に掲載されています。Claude モデルはこの URL でのみ提供され、GPT モデルは OpenAI ベース URL https://api.qcode.cc/openai/v1 を使います。

Anthropic には不要、OpenAI には必要です。ZCode のソースコードは、Anthropic のベース URL が /v1 で終わっていなければ /v1 を補い、その後 SDK が /messages を付けるので、https://api.qcode.cc/api と入力します（ソース上は https://api.qcode.cc/api/v1 でも同じ /api/v1/messages に届きます）。OpenAI Chat と Responses は URL の後ろに /chat/completions、/responses を直接付けるので、https://api.qcode.cc/openai/v1 と入力します。2026-11-10 時点で ZCode CLI 0.17.1 で三つとも動作を確認しました。末尾のスラッシュは付けないでください。

CLI は Responses に対応しています。api.type を openai-responses、api.baseUrl を https://api.qcode.cc/openai/v1 にすると、2026-11-10 時点で ZCode CLI 0.17.1 で動作を確認できました（gpt-6.1-terra）。デスクトップ版の設定ページに挙がっているのは Anthropic と OpenAI の二つのプロトコルで、Responses だけの項目はありません。デスクトップ版で GPT モデルを使うときは OpenAI エンドポイント https://api.qcode.cc/openai/v1 を入力します。ZCode のドキュメントにある API タイプに Gemini はありません。QCode で使えるのは Claude、GPT と GLM、Kimi、DeepSeek、Qwen の各ファミリーで、モデル ID は /models にあります。

エラーごとに対処します。model_not_available_on_endpoint：Claude モデルが OpenAI の URL のプロバイダーに追加されています。claude-… のモデルは URL が https://api.qcode.cc/api のプロバイダーに入れてください。最上位の思考レベルで 400 のパラメータエラー：一部のサードパーティのデプロイは xhigh までしか受け付けないと公式に書かれているので、high を選びます。404：よくある原因は末尾のスラッシュで、パスが //v1/messages になります。上記のとおり /api と /openai/v1 を正確に入力してください。画像が送られない：公式の例では、同じ GLM モデルでも Anthropic 互換エンドポイントでは画像が保持され、OpenAI Chat 互換エンドポイントでは画像非対応として扱われます。カスタムモデルでは、モデル設定で画像対応を明示してください。