ZCode に EastX を接続する方法｜デスクトップ・CLI 設定

ZCode に EastX を接続する

ZCode に EastX を設定すると、コーディング作業に応じてモデルを選びながら、API キー、利用上限と使用量をまとめて確認できます。ZCode 専用キーを用意すれば、他のクライアントで使った費用と分けて管理できます。

デスクトップ版の設定

1. Model Settings でプロバイダーを追加し、API 形式に Chat Completions を選びます。
2. Base URL に https://api.eastx.ai/v1 を入力します。/v1 は残し、チャット用の完全なパスは追加しません。
3. EastX で作成した ZCode 専用 API キーを設定します。
4. EastX のモデル一覧または GET /v1/models から正確なモデル ID をコピーして追加します。
5. 会話画面で追加したモデルを選び、短い関数の説明から試します。

次に範囲を決めたコード変更を依頼し、変更ファイルとテスト結果を確認します。実際のコーディング作業では、会話の応答に加え、ツール呼び出しと複数ターンの文脈も必要です。

CLI の設定例

EastX のドキュメントでは、Windows は %USERPROFILE%\.zcode\cli\config.json、macOS と Linux は ~/.zcode/cli/config.json を設定先として説明しています。既存設定がある場合は必要なフィールドを統合し、プレースホルダーを実際の値に置き換えます。API キーを公開リポジトリに保存しないでください。

{
  "provider": {
    "eastx": {
      "kind": "openai-compatible",
      "name": "EastX",
      "options": {
        "baseURL": "https://api.eastx.ai/v1",
        "apiKey": "YOUR_EASTX_API_KEY",
        "apiKeyRequired": true,
        "includeUsage": true
      },
      "models": {
        "YOUR_MODEL_ID": {"name": "My coding model"}
      }
    }
  },
  "model": {
    "main": "eastx/YOUR_MODEL_ID",
    "lite": "eastx/YOUR_MODEL_ID"
  }
}

モデルの役割と費用を比較する

最初は利用可能な同じモデルで main と lite の動作を確認します。その後、同じ課題でコードの品質、完了時間、作業全体の費用を比較し、複雑な編集と軽い要約などの役割を分けます。ツール実行の信頼性と、修正にかかった手間も確認してください。

エラーが出た場合

• 404：Base URL の /v1 と正確なモデル ID を確認します。
• 403：キーのモデル権限と送信元 IP の制限を確認します。
• 402：アカウント残高とキーの利用上限を両方確認します。

推論レベルの設定によって ZCode が /v1/messages を使用する場合があります。EastX の文書では、この互換エンドポイントはプロトコル変換を行い、thinking パラメーターはそのまま転送されず、推論は上流側で決まると説明されています。モデルごとの実際の挙動は対象タスクで確認してください。

• EastX API ドキュメント
• ZCode 接続ガイド（中国語・英語）
• API エラー対処法