外部ツールを OpenDesign Cloud API に接続する

必要な接続を選択する

プロバイダーキーを OpenDesign に取り込むには、BYOKのセットアップに従ってください。このガイドでは逆方向の接続、つまりClaude CodeやCodexなどの外部ツールから OpenDesign CloudモデルAPIを使用する方法を説明します。

開始する前に

OpenDesign Cloud API は、Go、Plus、Pro、Max プランで利用できます。Free はサポートされていません。アカウントのモデルリストによって、利用できるテキストモデルが決まります。スクリーンショットに表示されているモデルは例であり、すべてのプランで利用できることを示すものではありません。

対応エージェントはClaude Code、Codex、Grok Build、OpenCode、OpenClaw、Hermes Agentです。最初に使用するエージェントをインストールしてください。CC Switchがすでにインストールされている場合は、そのインストール手順を省略できます。

ウェブでAPI keysを開く

ウェブで OpenDesign のアカウント管理にサインインし、サイドバーでAPI keysを選択します。右上のOne-click agent setupを選択してください。既存のキーがなくても開始できます。

手動で設定するには、Connection setup（接続設定）を開き、ツールで必要な API 形式（Chat Completions、Responses、Messages のいずれか）を選択して、その API base URL をコピーします。エンドポイントとプロトコルの組み合わせを一致させてください。以下の手順では、ワンクリックインポートについて説明します。

ステップ1：CC Switchをインストールして開く

1. One-click agent setupで、Download for MacまたはDownload for Windowsを選択します。
2. CC Switchをインストールして開きます。すでにインストールされている場合は、この手順を省略してください。

ステップ2：エージェントとモデルを選択する

1. 対象エージェントを選択します。デフォルトではClaude Codeが選択されています。
2. プランのModel（モデル）リストからテキストモデルを選択します。利用可能なモデルがない場合は、別のエージェントを選択するか、プランを確認してください。スクリーンショットからモデル名をコピーしても、アクセス権は付与されません。

ステップ3：インポートして再起動する

1. Import into CC Switchを選択します。これにより、Claude Code · Macのようにエージェント名とシステム名を含む新しいキーが作成され、CC Switchが開きます。
2. ブラウザーの確認メッセージでOpen CC Switchを許可します。CC SwitchでAPI Endpoint、キー、モデルを確認してから、Importを選択します。
3. ウェブページに戻ってDoneを選択するか、別の接続を設定する場合はSet up another agentを選択します。
4. 対象エージェントを再起動します。Claude Codeの場合は現在のセッションを終了し、新しいターミナルでclaudeを実行します。

ワンクリックセットアップを実行するたびに新しいキーが作成されます。既存のキーを再利用することはできません。既存のキーには影響しません。以前のエージェント設定はCC Switchで引き続き利用できます。

有効な接続を確認する

1. 再起動したエージェントで短いメッセージを送信し、応答が返ることを確認します。
2. Claude Codeでは/statusを実行し、表示されたモデルを選択内容と比較します。ほかのエージェントでは、同等のステータス画面を使用してください。
3. ウェブのAPI keysページで、新しいキーのLast used（最終使用日時）が更新されるか確認します。

以前のモデルがまだ有効な場合は、古いセッションを閉じてエージェントを再起動してください。ブラウザーでCC Switchが開かなかった場合は、アドレスバー付近にある確認メッセージを確認し、CC Switchを開いて、もう一度Openを選択します。後からモデルを変更する場合は、セットアップを繰り返さずにCC Switchで変更できます。

以前の接続に戻す、またはアクセスを取り消す

CC Switchでエージェントの以前の設定を見つけ、有効にすると元の接続へ戻せます。CC Switchの設定を削除しても、APIキーは無効になりません。キーを機能しないようにするには、ウェブのAPI keysページで取り消してください。

現在のプランとモデルの利用可否は、アカウントページで確認してください。完全な録画とスクリーンショットについてはワンクリックエージェントセットアップのチュートリアルを、アカウント設定についてはサブスクリプションと請求を参照してください。

API呼び出しはアプリのクレジットと共通ですか？

はい。通常のAPI呼び出しでは、プランの利用枠と使用期間がアプリと共通になります。別のキーを作成したり、エージェントを切り替えたりしてもリセットされません。プロモーションクレジットには、API利用資格に関する個別の条件が設定されている場合があります。クレジットと使用量を参照してください。

キーと使用量を管理するには、Cloudコンソールを開きます。カスタムモデルのエンドポイントとキーを受け付けるZcodeなどのツールは、対応するAPIプロトコルに合わせて設定できます。ただし、これは OpenDesign からそのツールを組み込みのローカルエージェントとして起動できるという意味ではありません。

画像を含むリクエストがサイズ制限を超える場合

現在のサポートガイダンスでは、APIリクエスト本文の上限は50 MiBです。この上限は画像ごとではなく本文全体に適用され、画像のエンコードによってサイズも増加します。画像の数または寸法を減らし、小さいリクエストで再試行してください。それでも失敗する場合は、キーを開示せずに、レスポンスステータス、リクエスト時刻、モデルをサポートへ伝えてください。