アプリとコーディングエージェントを接続
接続方法を選び、CostRouter の Base URL と API Key を設定して、利用ログで最初のリクエストを確認します。
方法 1
AI アプリケーションを接続
互換 SDK または HTTP クライアントはそのままに、Base URL、API Key、モデル ID だけを変更します。
最初の動作確認リクエスト
curl 例
curl -X POST "https://costrouter.ai/v1/chat/completions" \
-H "Authorization: Bearer YOUR_COSTROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-luna",
"messages": [
{
"role": "user",
"content": "Reply with exactly: CostRouter connected"
}
],
"stream": false
}'設定する 3 つの値
- Base URL: https://costrouter.ai/v1
- 認証: Bearer YOUR_COSTROUTER_API_KEY
- モデル:モデル一覧から正確な ID をコピー
方法 2
コーディングエージェントを設定
各設定には Base URL と API キーを渡す環境変数が示されています。YOUR_COSTROUTER_API_KEY とモデルのプレースホルダーを置き換え、表示されたコマンドでツールを起動してください。
Codex
CostRouter 対応設定
設定
Codex
CostRouter 対応設定
Codex をインストール
ツールをインストールするか、現在のバージョンが正常に起動することを確認します。
Codex をインストール
npm install -g @openai/codex
codex --versionコマンドを1つコピーして接続を確認
現在のターミナルに API Key を export してから、一時的な CostRouter プロバイダー設定で Codex を起動します。config.toml は変更されず、このターミナルを閉じると失効します。
現在のターミナル(zsh / bash)
export OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY" && \
codex \
-c 'model_provider="costrouter"' \
-c 'model="gpt-5.6-luna"' \
-c 'model_providers.costrouter.name="CostRouter"' \
-c 'model_providers.costrouter.wire_api="responses"' \
-c 'model_providers.costrouter.env_key="OPENAI_API_KEY"' \
-c 'model_providers.costrouter.base_url="https://costrouter.ai/v1"'永続設定
プロバイダーの接続先と API Key を config.toml に保存し、次回以降の Codex 起動時に自動で読み込みます。API Key は端末内に平文で保存されるため、個人用端末でのみ使用し、ファイルを適切に保護してください。
~/.codex/config.toml
model_provider = "costrouter"
model = "gpt-5.6-luna"
[model_providers.costrouter]
name = "CostRouter"
wire_api = "responses"
base_url = "https://costrouter.ai/v1"
experimental_bearer_token = "YOUR_COSTROUTER_API_KEY"
- このツール専用の API Key を使用します。
- モデル一覧から利用可能なモデルを選びます。
- ツールを再起動し、利用ログでリクエストを確認します。
Claude Code
CostRouter 対応設定
設定
Claude Code
CostRouter 対応設定
Claude Code をインストール
ツールをインストールするか、現在のバージョンが正常に起動することを確認します。
Claude Code をインストール
npm install -g @anthropic-ai/claude-code
claude --versionコマンドを1つコピーして接続を確認
以下のコマンド全体を実行してください。Base URL と API Key は export で現在のターミナルに設定され、設定ファイルは変更されません。このターミナルを閉じると失効します。
現在のターミナル(zsh / bash)
export ANTHROPIC_BASE_URL="https://costrouter.ai" \
ANTHROPIC_AUTH_TOKEN="YOUR_COSTROUTER_API_KEY" && \
claude永続設定
ツールの設定ファイルに保存し、次回以降の起動でも引き続き使用します。
~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://costrouter.ai",
"ANTHROPIC_AUTH_TOKEN": "YOUR_COSTROUTER_API_KEY"
}
}- このツール専用の API Key を使用します。
- モデル一覧から利用可能なモデルを選びます。
- ツールを再起動し、利用ログでリクエストを確認します。
Gemini CLI
CostRouter 対応設定
設定
Gemini CLI
CostRouter 対応設定
Gemini CLI をインストール
ツールをインストールするか、現在のバージョンが正常に起動することを確認します。
Gemini CLI をインストール
npm install -g @google/gemini-cli
gemini --versionコマンドを1つコピーして接続を確認
以下のコマンド全体を実行してください。Base URL と API Key は export で現在のターミナルに設定され、設定ファイルは変更されません。このターミナルを閉じると失効します。
現在のターミナル(zsh / bash)
export GOOGLE_GEMINI_BASE_URL="https://costrouter.ai" \
GEMINI_API_KEY="YOUR_COSTROUTER_API_KEY" \
GEMINI_MODEL="gemini-available-model-id" && \
gemini永続設定
ツールの設定ファイルに保存し、次回以降の起動でも引き続き使用します。
~/.gemini/settings.json
{
"env": {
"GOOGLE_GEMINI_BASE_URL": "https://costrouter.ai",
"GEMINI_API_KEY": "YOUR_COSTROUTER_API_KEY",
"GEMINI_MODEL": "gemini-available-model-id"
}
}- このツール専用の API Key を使用します。
- モデル一覧から利用可能なモデルを選びます。
- ツールを再起動し、利用ログでリクエストを確認します。
Cursor
CostRouter 対応設定
設定
Cursor
CostRouter 対応設定
Cursor をインストール
ツールをインストールするか、現在のバージョンが正常に起動することを確認します。
Cursor をインストール
cursor .コマンドを1つコピーして接続を確認
環境変数は、今回起動する Cursor とそのプロジェクトプロセスにだけ渡されます。内蔵 Agent に反映されるかは、Cursor のバージョンによって異なります。
現在のターミナル(zsh / bash)
export OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY" \
OPENAI_BASE_URL="https://costrouter.ai/v1" && \
cursor .永続設定
Cursor 内で実行するプロジェクトコードやスクリプト向けに、プロジェクトの .env に保存します。内蔵 Agent のカスタム Base URL 対応は、インストール済みのバージョンによって異なります。
.env
OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY"
OPENAI_BASE_URL="https://costrouter.ai/v1"- このツール専用の API Key を使用します。
- モデル一覧から利用可能なモデルを選びます。
- ツールを再起動し、利用ログでリクエストを確認します。
ローカルエージェント設定を管理
cc-switch でローカルのプロバイダー設定を保存・切替できます。CostRouter の Base URL と API Key は一度だけ入力します。
本番環境
公開前の確認
トラフィック増加後もアクセスを制御し、コストを可視化します。
- アプリ、環境、エージェントごとに Key を分けます。
- 上限、有効期限、モデル制限、IP 許可リストを設定します。
- 設定やモデル変更後に利用ログを確認します。
- 環境変数またはシークレット管理から認証情報を読み込みます。