- Claude Desktop installation and setup
- Claude Desktop gateway configuration
- Claude Desktop configuration reference
Claude Desktop のサードパーティ推論には、Anthropic互換のゲートウェイが必要です。CometAPI は Anthropic メッセージ API を通じて Claude モデルをサポートしています。
前提条件
- claude.com/download から Claude Desktop をインストール済みであること
- Developer mode と Configure third-party inference を含む Claude Desktop ビルド
- 有効な API キーを持つ CometAPI アカウント
- CometAPI で Claude モデルにアクセスできること
https://api.cometapi.comに到達できるネットワーク経路
設定
Enable developer mode
Claude Desktop を開き、サインイン画面のままにします。アプリケーションメニューで Help → Troubleshooting を開き、Enable Developer Mode を選択します。Windows では、サインイン前はメニューにアクセスしづらい場合があります。メールフィールドにフォーカスを合わせ、メニューにフォーカスが移るまで
Tab を押してから、Enter を押してください。Open third-party inference settings
Developer mode を有効にした後、Developer → Configure third-party inference を開きます。設定ウィンドウが開き、左側のサイドバーに複数のセクションが表示されます。CometAPI の設定には Connection セクションを使用します。
Configure the gateway
Connection セクションで、以下の CometAPI の値を入力します:
base URL は表示どおり正確に入力してください。Claude Desktop では HTTPS の base URL が必要です。次のスクリーンショットは、CometAPI の値が入力された Connection セクションを示しています。
| Field | Value |
|---|---|
| Inference provider | Gateway |
| Gateway | Anthropic-compatible |
| Gateway base URL | https://api.cometapi.com |
| Gateway API key | <COMETAPI_KEY> などの CometAPI API キー |
| Gateway auth scheme | Bearer |
| Gateway extra headers | 空欄のまま |

Add model IDs
Model list で、これらの model ID を手動で追加します:
リストの最初の model がデフォルト model になります。汎用的なデフォルトにしたい場合は、
| Model ID | Recommended use |
|---|---|
claude-opus-4-7 | 複雑な計画立案とエージェントタスク |
claude-sonnet-4-6 | 一般的なデスクトップ用途 |
claude-haiku-4-5-20251001 | 軽量なプロンプト(Prompt)と素早い下書き |
claude-sonnet-4-6 を先頭に配置してください。次のスクリーンショットは、CometAPI 用に 3 つの Claude model ID が設定された model list を示しています。
Apply the configuration locally
Apply locally をクリックします。Claude Desktop は選択した設定をローカルユーザープロファイルに書き込み、アプリを再起動します。アプリが再起動しない場合は、Claude Desktop を完全に終了してから再度開いてください。
設定を確認する
外部ツールを必要としない短いプロンプト(Prompt)を使用します:
トラブルシューティング
Developer menu does not appear
Developer menu does not appear
Claude Desktop opens the standard sign-in flow
Claude Desktop opens the standard sign-in flow
次の項目を確認してください:
- Inference provider が Gateway に設定されている。
- Gateway base URL が
https://api.cometapi.comになっている。 - Gateway API key に余計なスペースなしで CometAPI API キーが含まれている。
- Apply locally をクリックし、Claude Desktop を完全に再起動した。
Connection validation fails
Connection validation fails
base URL が
https:// で始まっていることを確認してください。Claude Desktop はプレーンな HTTP の gateway URL を受け付けません。また、CometAPI アカウントで Claude モデルにアクセスできること、および API キーが削除または無効化されていないことも確認してください。Configured models do not appear
Configured models do not appear
Developer → Configure third-party inference を再度開き、Model list の項目を確認してください。model ID は、CometAPI が公開している ID と一致している必要があります。各 model ID は個別の項目として追加してください。UI フィールドに引用符、カンマ、余分なスペースを含めないでください。
An OpenAI-compatible base URL does not work
An OpenAI-compatible base URL does not work
このフローでの Claude Desktop のサードパーティ推論では、Anthropic互換のゲートウェイが必要です。
https://api.cometapi.com と、上記に記載した Claude の model ID を使用してください。The Code tab behaves differently
The Code tab behaves differently
Code タブでは、Claude Desktop 内の Claude Code エンジンが使用されます。一部のデスクトップ設定は、Cowork に適用されるのと同じようには Code セッションに適用されない場合があります。スタンドアロンのターミナル利用については、Claude Code integration guide を参照してください。