ZCode のカスタムモデル：Claude と GPT

ZCode は智譜のデスクトップ coding agent です。1 つの OpenAI 互換プロバイダーを Code By AI に向ければ、Claude と GPT モデルを実行できます。

ZCode は Agentic Development Environment で、単なるターミナルのラッパーではありません。Agent がチャットからファイル、ターミナル、Git、ブラウザプレビューを操作します。Model Settings パネルはカスタムプロバイダーを受け付けるので、モデルの接続先だけを差し替えられます。

コマンド 1 つで設定（macOS / Linux）

先に ZCode を完全に終了してください。ZCode はプロバイダー一覧をメモリに保持し、保存時や終了時に ~/.zcode/v2/config.json を書き戻すため、起動中の編集は失われます。

Copy
1
curl -fsSL https://www.codebyai.net/setup.sh | sh -s -- --zcode

スクリプトは API キーを非表示入力で尋ね、codebyai プロバイダーと gpt-5.6-terra、claude-sonnet-5 を追加し、元ファイルをバックアップして所有者のみ読み書きできる権限にします。再実行でキーを更新でき、| sh -s -- --uninstall で元のファイルに戻せます。以下の手順は同じことを手作業で行います。

1. Code By AI API キーを作成する

Code By AI にサインインし、API Keys ページでキーを作成します。形式は sk-proj-... です。

2. モデル設定を開く

ZCode のチャット入力欄の下にあるモデル選択を開き、Manage models をクリックします。Settings → Model Settings が開き、ここでプロバイダーを追加します。

3. プロバイダーを追加する

1. 左側のプロバイダー一覧の下にある Add Provider をクリックします。
2. 名前を Code By AI にします。
3. OpenAI API base URL に https://www.codebyai.net/api/agent/v1 を設定します。
4. Code By AI の API キーを貼り付けます。
5. 保存後、Add Model をクリックして gpt-5.6-terra を入力します。もう一度 Add Model をクリックし、claude-sonnet-5 を追加します。
6. プロバイダーの有効スイッチをオンにします。

両方のモデルファミリーで OpenAI プロトコルを使います。ZCode の Anthropic-messages モードは旧式の thinking パラメーターを送るため、現在の Claude モデルは拒否します。ゲートウェイの Chat Completions 経路は claude-* の ID を Claude チャネルへ転送し、Claude の料金で課金するので、1 つのプロバイダーで両方を扱えます。

4. モデルを選んでテストする

セッションを開き、モデル選択からどちらかのモデルを選んで短い質問を送ります。正常な返答が来れば、エンドポイント、キー、モデル ID がすべて一致しています。

モデル ID とコンテキストウィンドウ

モデル ID は Model Plaza に載っているものを使ってください。上の 2 つはこのガイド執筆時の例です。カスタムプロバイダーに追加したモデルは、ZCode では 200,000 トークンのコンテキストウィンドウで始まります。Settings → Model Providers → Advanced でモデルを開くと、ウィンドウと最大出力トークンを変更できます。どちらも保存後の新しいセッションから適用されます。

トラブルシューティング

• 404 page not found — base URL が不完全か、余分なパスが付いています。https://www.codebyai.net/api/agent/v1 を使い、/chat/completions を付けたり /v1 を重ねたりしないでください。
• 401 / キーが無効 — キーの前後に空白があるか、削除・失効しています。API Keys ページで新しいキーを作り、貼り直してください。
• 残高不足 — Wallet ページでチャージします。
• 400 で reasoning level が話題に出る — カスタムプロバイダーが ZCode の最高思考レベルを受け付けないことがあります。そのモデルの effort を下げてください。ゲートウェイは ZCode が送ったレベルをそのまま転送します。
• プロバイダーのモデル一覧が空 — 有効スイッチがオフか、Add Model が保存されていません。
• ZCode を再起動するとプロバイダーが消える — スクリプトが書き込んだときアプリが起動していました。完全に終了してからコマンドを再実行し、その後で開き直してください。