Zoo Code

継続的にメンテナンスされている VS Code コーディングエージェントを TokenMix に接続します。

Zoo Code とは

Zoo Code は VS Code 内で動く AI コーディングエージェントです。ファイルの説明、コード生成、リファクタリング、デバッグに使えます。Code、Architect、Ask、Debug、Custom Modes に対応しています。初めて使う場合は、まず質問し、次に計画を出させ、最後に小さな変更だけ許可する流れが安全です。

Zoo Code は OpenAI Compatible プロバイダーで TokenMix に接続できます。Zoo Code を自分でデプロイする必要はありません。拡張機能の API 接続先を TokenMix に変更するだけです。

TokenMix 情報を準備する

最初に次の値を用意します:

• Provider: OpenAI Compatible
• Base URL: https://api.tokenmix.ai/v1
• API Key: TokenMix API Key
• Model: TokenMix model ID, for example <your-model-short-id>

Base URL には必ず /v1 を含めます。OpenAI のデフォルト URL や https://api.tokenmix.ai だけを入れないでください。

Zoo Code をインストールする

1. VS Code を開きます。
2. Extensions を開きます。
3. Zoo Code を検索します。
4. Extension ID が ZooCodeOrganization.zoo-code であることを確認します。
5. Install をクリックします。
6. Zoo Code パネル、または command palette から Zoo Code settings を開きます。

他の VS Code コーディングエージェントから移行する場合も、最初はモデル設定だけを移します。チャットとコード生成が動作してから、MCP、コマンド実行権限、プロジェクトルールを移してください。

TokenMix API を設定する

1. Zoo Code の Settings または Provider settings を開きます。
2. API Provider または Model Provider を探します。
3. OpenAI Compatible を選択します。
4. Base URL に https://api.tokenmix.ai/v1 を入力します。
5. API Key に TokenMix Key を入力します。
6. Model に TokenMix model ID を入力します。
7. Reasoning、Responses API、Embedding、Code Index、Context Window などの高度な項目は、最初はデフォルトのままにします。
8. 設定を保存します。

API Key は通常 VS Code Secret Storage に保存されます。.env、README、プロジェクト設定ファイル、スクリーンショットに入れないでください。

最初のテスト

一時プロジェクト、またはテストブランチで試してください。本番リポジトリをすぐに変更させないでください。

Ask mode で始めます:

Explain what the current file does. Do not modify any files.

次に Architect mode を試します:

Create a plan for a classic frontend-backend separated architecture diagram, including frontend, backend, database, cache, and object storage. Do not modify files.

問題なければ、小さな Code mode タスクを試します:

Create a small TypeScript function that validates an email string and add one simple usage example.

この 3 つが動けば、TokenMix の Base URL、API Key、Model ID はおおむね正しく設定されています。

おすすめの順序

1. Ask: ファイルを編集せず、コードを説明させます。
2. Architect: 実装前に計画を書かせます。
3. Code: 小さな範囲だけ変更します。
4. Debug: 明確なエラーを 1 つ調査します。
5. Custom Modes: チームの定型作業を固定します。
6. MCP Servers: モデル接続が安定してから外部ツールを追加します。

IDE エージェントはファイルの読み書きやコマンド実行が可能です。最初は小さな作業で権限表示に慣れてから、大きな作業を任せてください。

MCP

Zoo Code は MCP Servers に対応しています。MCP を使うと、外部ドキュメントの参照、設計ツール、読み取り専用データベースクエリ、社内サービス呼び出しなどを Agent から利用できます。

推奨手順:

1. まず TokenMix モデルだけを設定します。
2. 通常のチャットが動くことを確認します。
3. シンプルな MCP Server を 1 つ追加します。
4. Agent が tool list を認識できるか確認します。
5. 最初の MCP 呼び出しは読み取り専用タスクにします。
6. ファイル変更、コマンド実行、DB 変更は別途権限を確認します。

最初の設定でモデルと MCP を同時に追加しないでください。分けて設定すると、問題の原因を見つけやすくなります。

Code Index と Embedding

Code Index やリポジトリ検索を有効にする場合、embedding モデルの設定が必要になることがあります。

• チャットモデルと embedding モデルは別々に設定できます。
• OpenAI Compatible embedding に対応していれば、TokenMix の embedding モデルを使えます。
• Embedding Base URL も https://api.tokenmix.ai/v1 です。
• Model には TokenMix embedding model ID を入力します。
• dimension が必要な場合は、選択した embedding モデルの説明に合わせます。

初心者は最初に Code Index をオフにしても問題ありません。通常のチャット、短い編集、コード説明を先に動かしてください。

トラブルシューティング

• 401 / unauthorized: API Key が間違っている、期限切れ、または余分な空白があります。
• model not found: TokenMix model ID ではない、またはアカウントに権限がありません。
• Base URL error: /v1 がありません。https://api.tokenmix.ai/v1 を使ってください。
• OpenAI に送信される: Provider が OpenAI Compatible ではない、または Base URL がデフォルトのままです。
• 出力が途中で止まる: context の大きいモデルに変えるか、一度に渡すファイル数を減らします。
• tool call が拒否される: Zoo Code の権限プロンプトと VS Code workspace trust を確認します。
• MCP が動かない: まず通常チャットを確認し、次に MCP Server の起動状態と設定パスを確認します。

初心者向けの注意

Zoo Code はコードを書ける助手ですが、最終確認はユーザーが行います。まず説明、次に計画、最後に編集という順序で使ってください。決済、ログイン、DB、本番設定、秘密情報のファイルは特に慎重に扱います。変更後は必ず diff を確認し、テストまたは build を実行してください。