Z Code で Wokey API を使う

1. 1

   モデル設定を開く

   チャット欄のモデル名 → Manage Models をクリックするか、Settings → Model Settings を開きます。

2. 2

   プロバイダーを追加する

   Add Provider をクリックし、名前を Wokey にします。Anthropic 形式では Base URL を https://api.wokey.ai に、OpenAI 形式では https://api.wokey.ai/v1 に設定します。API Key に Wokey の API キーを貼り付けます。

3. 3

   モデルを追加して有効にする

   プロバイダーの下で Add Model をクリックし、claude-opus-5-5 などのモデル ID を入力して、有効化スイッチをオンにします。

4. 4

   モデルを切り替える

   チャット欄に戻り、モデル一覧から追加したモデルを選んで、短いメッセージを送って確認します。

Provider name: Wokey
API format: Anthropic
Base URL: https://api.wokey.ai
API Key: YOUR_API_KEY
Model ID: claude-opus-5-5

設定場所: Settings → Model Settings（ファイル ~/.zcode/v2/config.json）

Z Code はデフォルトで Anthropic Messages 形式を使います。このリクエストで 200 が返れば、API キーと Base URL は正しく設定されています。送信前に YOUR_API_KEY をご自身のキーに置き換えてください。

curl https://api.wokey.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

Z Code の Base URL に /v1 は必要ですか？

接続に使う API 形式によります。Anthropic の場合は /v1 なしの https://api.wokey.ai、OpenAI の場合は https://api.wokey.ai/v1 を指定してください。

ターミナルで export した環境変数が反映されないのはなぜですか？

ターミナルの環境変数と Z Code デスクトップ版のモデル設定は別々で、同期されません。Base URL と API キーは Settings → Model Settings のプロバイダーに入力してください。

プロバイダーを追加したのに、モデルを選べないのはなぜですか？

各プロバイダーで Add Model からモデル ID を入力し、そのモデルの有効化スイッチをオンにする必要があります。そうするとチャット欄のモデル一覧に表示されます。

出力が途中で切れる、またはコンテキストが足りない場合は？

モデルの Advanced を開き、Max output tokens と context window をモデルページの値に合わせて調整してください。新しく追加したモデルのコンテキストウィンドウはデフォルトで 200000 です。

Z Code はこの設定をどこに保存しますか？

~/.zcode/v2/config.json です。PC の移行や再インストールの前にこのファイルをバックアップしてください。API キーが含まれているため、共有しないでください。