サードパーティ API で使う Claude Desktop：Configure Third-Party Inference の設定とトラブルシューティング

Wokey Team · 2026-09-24

結論： Claude デスクトップアプリでサードパーティ API を使う方法はただ 1 つ、Developer → Configure Third-Party Inference です。このアプリは ANTHROPIC_BASE_URL も ~/.claude/settings.json も読まないため、ターミナルで動く設定もデスクトップアプリでは何の効果もありません。このガイドでは、よくぶつかる問題を順に解説します。メニューが見つからない、設定が反映されない、モデル一覧が空、そしてサードパーティモードではそもそも使えない機能です。初回のセットアップ全体は Claude Desktop 設定ガイドをご覧ください。

正しい手順

1. デスクトップアプリを起動し、Anthropic アカウントにはログインしないでください。

2. Help → Troubleshooting → Enable Developer Mode を開きます。

3. Developer → Configure Third-Party Inference… を開きます。

4. Connection で Inference provider を Gateway に設定し、Gateway credentials を入力します。

   項目	値
   Gateway base URL	https://api.wokey.ai（/v1 なし）
   Gateway API key	Wokey の API キー
   Credential kind	Static API key
   Gateway auth scheme	Bearer（Wokey は x-api-key も受け付けます。デフォルトのままで構いません）

5. Apply Changes をクリックし、続けて Save & Restart をクリックします。

動作環境：

• macOS： 14（Sonoma）以降、Apple シリコンまたは Intel。
• Windows： Windows 10 ビルド 19041 以降、x64 または Arm64。

Developer メニューが見つからない

Developer メニューは、開発者モードをオンにしたときだけ表示されます：Help → Troubleshooting → Enable Developer Mode。Help メニューにもこの項目がない場合は、アプリを最新バージョンに更新してください。古いバージョンにはサードパーティ推論の設定がありません。

設定ウィンドウが読み取り専用になっている

会社の MDM プロファイルなど、管理者が配布した設定がすでにマシンにある場合、ウィンドウは読み取り専用で開き、ローカルでは変更できません。管理者に相談するか、管理されていないマシンを使ってください。

環境変数が効かない

これが最もよくある間違いです。デスクトップアプリは、ゲートウェイの設定をサードパーティ推論の設定からしか取得しません。ANTHROPIC_BASE_URL も settings.json も読みません。

デスクトップアプリの Code タブも同じ動作です。CLI と同じ Claude Code エンジンを動かしますが、ゲートウェイのアドレスと認証情報はデスクトップの設定から直接取得します。~/.claude/settings.json のユーザーレベルの設定では上書きできません。

逆も同様で、デスクトップの設定はターミナルの claude には影響しません。それぞれ別に設定してください。ターミナルについては Claude Code base URL ガイドをご覧ください。

モデル一覧が空、またはモデルが足りない

独自のモデル一覧がない場合、アプリはゲートウェイの GET /v1/models にリクエストし、ID から Claude と判別できるモデルだけを残します。そのため Wokey では、自動検出で claude-opus-5 や claude-sonnet-5 などのモデルが表示され、GPT、Grok などのモデルは除外されます。これは想定どおりの動作です。

一覧を固定したり、デフォルトのモデルを選んだりするには、設定ウィンドウのモデル一覧（Model list、キーは inferenceModels）に完全なモデル ID を入力します。

• 先頭のエントリがデフォルトになり、Code タブの新しいセッションもそのモデルで始まります。
• すべてのエントリが完全な ID の場合、アプリは /v1/models へのリクエストを省略します。
• /v1/models が失敗し、一覧も空の場合、モデル選択欄は空になります。

エラー

Gateway was unreachable： アプリがゲートウェイに到達できません。Gateway base URL に打ち間違いがないか確認し、ターミナルから curl でテストしてください。

curl -X POST https://api.wokey.ai/v1/messages \
  -H "Authorization: Bearer your Wokey API key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'

curl は動くのにアプリが動かない場合、原因はたいていプロキシです。ターミナルはプロキシを経由しているのにアプリは経由していない、またはその逆です。

code が invalid_api_key の 401： リクエストは Wokey に届いていますが、キーがないか間違っています。Wokey はどちらの認証方式も受け付けるので、その設定を変える必要はありません。キーを貼り直してください。

invalid x-api-key： リクエストが Anthropic に送られており、サードパーティの設定が有効になっていません。たいていは Save & Restart をクリックしていないか、その後のログイン画面で Anthropic のログインを選んでいます。invalid x-api-key ガイドをご覧ください。

さらに詳しく調べるには： Help → Troubleshooting → Generate Diagnostic Report でレポートを書き出します。その中の 3 つのファイルが役立ちます。

• managed-config.txt：有効になっている設定。
• provider-status.txt：ゲートウェイの接続状態。
• deployment-mode.txt：現在のモード。

ログの場所：

• macOS：~/Library/Logs/Claude-3p/main.log
• Windows：%LOCALAPPDATA%\Claude-3p\Logs\main.log

サードパーティモードで使えない機能

次の機能は Anthropic アカウントや Anthropic のクラウドサービスに依存しているため、ゲートウェイでは使えません。設定の問題ではありません。

• モバイルと claude.ai のウェブからのアクセス
• 音声モード
• プロジェクトとプラグインの共有
• Claude Design、Claude Security、Claude Tag
• Computer use
• Remote Control と Anthropic がホストするクラウド環境

さらに 2 つがデフォルトでオフになっています。

• ツール検索と実験的なベータ機能。 厳格なゲートウェイとの互換性のため、アプリはこれらをオフにしています。ツール検索は toolSearchEnabled で再びオンにできます。
• SSH リモートセッション。 サードパーティモードではベータ版で、管理者がホストの許可リストを設定する必要があります。

Anthropic アカウントに戻す

ログイン画面で Anthropic のログインを選ぶと、通常の Claude デスクトップアプリに戻ります。