Home → Guides → Claude デスクトップと Codex を APICLAN に向ける
デスクトップアプリの設定画面には base URL の入力欄がありません。その設定は CC Switch が書き込みます。ここでは入力すべき内容と、設定失敗のほぼすべてを占める 2 つの原因を説明します。
残高のあるアカウントと API キーが必要です。コンソールの「API キー」で作成します。呼び出すベンダー系列を選び（Claude デスクトップなら Anthropic、Codex なら OpenAI）、次に支払いに使うキーグループを選びます。グループで単価が決まります。各モデルの価格は料金ページにあります。
キーは 1 つのグループだけに属します。テキストモデル用に作ったキーで画像モデルは呼び出せませんし、その逆も同じです。これは権限エラーではなく、モデルの 404 として返ります。両方必要ならキーを 2 つ作ってください。あるキーで何を呼び出せるかは、そのキーを付けて GET /v1/models を送った結果が常に正解です。
すべてのリクエストは /v1 で始まるパスに届く必要があります。クライアント側に /v1 を自分で入力するかどうかはクライアント次第で、自動で付けるものと付けないものがあります。「つながらない」という報告の大半は、この 1 点が原因です。
| クライアント | 入力するリクエストアドレス |
|---|---|
| Claude Desktop (via CC Switch) | https://apiclan.us/v1 |
| Codex / ChatGPT desktop app | https://apiclan.us/v1 |
| OpenAI SDK, Cherry Studio, Chatbox, LobeChat, LM Studio | https://apiclan.us/v1 |
| Cursor, Cline, Roo Code | https://apiclan.us/v1 |
| Claude Code | https://apiclan.us |
| Anthropic SDK | https://apiclan.us |
逆にするとリクエストはエッジで 404 になります。つまりゲートウェイに届いておらず、利用ログにも現れません。ログが空であること自体が症状です。アドレスの末尾にスラッシュを付けないでください。
Codex は ChatGPT デスクトップアプリに統合されました。Windows では Microsoft Store で ChatGPT を検索してインストール、macOS では OpenAI のサイトからダウンロードします。コマンドライン版 Codex も同じ設定です。
CC Switch で Codex 用のプロバイダーを追加し、キーを貼り付け、リクエストアドレスに https://apiclan.us/v1 を入力します。それを有効にしたら、Codex を完全に終了し（ウィンドウを閉じるだけでは足りません）、起動し直します。設定は起動時にしか読まれないため、起動中のプロセスは古い設定を使い続け、何も変わっていないように見えます。
CC Switch を使わず設定ファイルを直接編集したい場合、base URL とキーの置き場所はクイックスタートに書いてあります。
claude.com から Claude デスクトップアプリをインストールし、CC Switch で設定します。
https://apiclan.us/v1 を入力します。クライアントが末尾に /messages を付けます。スラッシュは付けません。CC Switch が「直接接続」と「モデルマッピング」の選択を求めてきたら、選ぶ前に次の節を読んでください。この設定がモデル選択の可否を決めます。
「接続はできているがプロバイダーがリクエストを拒否した」という表示は、ほぼ必ずキーではなくモデル名の問題です。デスクトップアプリは内蔵のモデル識別子を送信しますが、ゲートウェイは上流アカウントが実際に提供するモデルしか扱えません。
直接接続ではなくモデルマッピングで解決します。アプリ側の項目を、このゲートウェイが提供する名前に対応付けてください。直接接続が成立するのは、プロバイダーがアプリの送る識別子をそのまま受け付ける場合だけです。
キーを付けて GET /v1/models を送ると、対応付けに使える一覧が得られます。この一覧はあなたのキーが属するグループから生成されるため、一般的なカタログではなく、あなたのアカウントにとっての実際の答えです。
何かが恒久的に上書きされることはありません。CC Switch で公式プロバイダーを再度有効にし、クライアントを再起動すれば、デスクトップアプリはサブスクリプションに戻ります。両方を設定したままいつでも切り替えられます。ここの残高は前払いで期限切れがないため、使っていない設定を残しておいても費用はかかりません。
/v1 が必要かを確認し、末尾のスラッシュを削除します。それでも解決しない場合は、失敗したモデル名とおおよその時刻を support@apiclan.us までメールしてください。担当者が読みます。
No subscription, no monthly minimum, no sales call. Top up with USDT and spend what you use — 1 USDT gives you 2 credits of API balance.
Read the 30-second quickstartPrices quoted on this page are regenerated automatically from live billing data. Third-party terms are quoted from that party's own published documentation.