コーディングエージェント
BasicRouterは、OpenAI互換またはAnthropic互換のAPIエンドポイントをサポートする コーディングエージェントやAI開発ツールと連携します。mwf/coding-auto などの ルーティングエイリアスを使用すると、開発者がツールの設定を変更することなく、 BasicRouterが利用可能な最適なコーディングモデルにルーティングできます。
汎用OpenAI互換セットアップ
Cursor、Codex、Hermes、OpenClaw、Continue、Aider、Cline、 LangChainベースのエージェント、LlamaIndexベースのエージェント、およびカスタムOpenAI互換エージェント ランタイムにこのセットアップを使用してください。
export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"汎用Anthropic互換セットアップ
Claude互換クライアントやAnthropic Messagesフォーマットを期待する ツールにこのセットアップを使用してください。
export ANTHROPIC_BASE_URL="https://api.basicrouter.ai/api/anthropic"
export ANTHROPIC_API_KEY="$BASICROUTER_API_KEY"
export ANTHROPIC_MODEL="mwf/coding-auto"推奨エージェントモデル
| ユースケース | 推奨エイリアス | 要件 |
|---|---|---|
| 汎用コーディング | mwf/coding-auto | ツール呼び出し、ストリーミング、高いコーディング能力。 |
| 高速コーディングチャット | mwf/coding-fast | 低レイテンシとストリーミング。 |
| 大規模リポジトリ分析 | mwf/coding-long | 長いコンテキストと安定した出力。 |
| コスト重視のコーディングアシスタント | mwf/low-cost | 低価格と許容できるコーディング品質。 |
| UIスクリーンショット / ビジョンコーディング | mwf/vision-chat | 画像入力とテキスト出力。 |
Cursorクイックガイド
OpenAI互換エンドポイントを使用します。
Base URL: https://api.basicrouter.ai/api/v1
API Key: BASICROUTER_API_KEY
Model: mwf/coding-auto推奨手順:
- Cursorの設定を開きます。
- OpenAI互換APIキー設定を追加または有効化します。
- OpenAIベースURLの上書きを
https://api.basicrouter.ai/api/v1に設定します。 mwf/coding-auto、mwf/coding-fast、mwf/coding-longなどのカスタムモデルを追加します。- 最適なエージェント動作のために、ストリーミングとツール呼び出しをサポートするモデルを使用してください。
トラブルシューティング:
| 問題 | 推奨される解決策 |
|---|---|
| モデルが表示されない | モデル名を手動でカスタムモデルとして追加してください。 |
| ツール呼び出しが失敗する | モデル一覧ページで tool_calling: true のモデルを使用してください。 |
| ストリーミングが中断される | バックオフで再試行するか、フォールバック付きのルーティングエイリアスを使用してください。 |
| 401エラー | APIキーとベースURLを確認してください。 |
| 404モデルエラー | アカウントでモデルが有効になっていることを確認してください。 |
Claude Codeクイックガイド
Anthropic互換ゲートウェイエンドポイントを使用します。
export ANTHROPIC_BASE_URL="https://api.basicrouter.ai/api/anthropic"
export ANTHROPIC_API_KEY="$BASICROUTER_API_KEY"
export ANTHROPIC_MODEL="mwf/coding-auto"BasicRouterは、Claude CodeおよびAnthropic SDK互換性のためのこの Anthropic互換パスをサポートしています:
POST /api/v1/messages推奨要件:
| 要件 | 理由 |
|---|---|
| Anthropic Messages互換リクエスト形式 | Claude CodeはAnthropicスタイルのメッセージを期待します。 |
| ストリーミングサポート | Claude CodeはストリーミングUXに依存します。 |
| ツール呼び出しサポート | エージェント型コーディングワークフローに必須。 |
| 長いコンテキスト | リポジトリレベルのタスクに有用。 |
| 安定したフォールバック | 長時間実行されるコーディングセッションに有用。 |
Codexクイックガイド
BasicRouterをカスタムOpenAI互換モデルプロバイダーとして使用します。
プロバイダー設定の例:
[model_providers.basicrouter]
name = "BasicRouter"
base_url = "https://api.basicrouter.ai/api/v1"
env_key = "BASICROUTER_API_KEY"
wire_api = "responses"
model_provider = "basicrouter"
model = "mwf/coding-auto"環境変数:
export BASICROUTER_API_KEY="br_xxx"推奨モデル:
| モデル | ユースケース |
|---|---|
mwf/coding-auto | デフォルトのコーディングエージェントモデル。 |
mwf/coding-long | 大規模リポジトリコンテキスト。 |
mwf/coding-fast | 高速な反復と小さな変更。 |
トラブルシューティング:
| 問題 | 推奨される解決策 |
|---|---|
| 認証エラー | env_key が BASICROUTER_API_KEY を指していることを確認してください。 |
| モデルが見つからない | BasicRouterコンソールでエイリアスを追加するか、直接モデルIDを使用してください。 |
| Responses APIエラー | Responsesをサポートするモデルとエンドポイントに対してのみ wire_api = "responses" を使用してください。 |
| Chat Completions専用モデル | クライアントがサポートしている場合は、チャット互換のワイヤAPIに切り替えてください。 |
Hermesクイックガイド
Hermesデプロイメントが別のプロトコル用に設定されていない限り、 OpenAI互換エンドポイントを使用してください。
export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"推奨モデルポリシー:
| Hermesワークロード | モデル |
|---|---|
| 汎用コード生成 | mwf/coding-auto |
| 低レイテンシのタスク実行 | mwf/coding-fast |
| 長文コンテキストのリポジトリスキャン | mwf/coding-long |
| コスト重視のバックグラウンドタスク | mwf/low-cost |
OpenClawクイックガイド
OpenAIスタイルのエージェントランタイム設定にOpenAI互換エンドポイントを使用します。
export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"OpenClawが複数のプロバイダーをサポートしている場合は、BasicRouterをOpenAI互換 プロバイダーとして設定し、モデル選択にBasicRouterのルーティングエイリアスを使用してください。
{
"provider": "openai-compatible",
"base_url": "https://api.basicrouter.ai/api/v1",
"api_key_env": "BASICROUTER_API_KEY",
"model": "mwf/coding-auto"
}エージェント互換性チェックリスト
| 機能 | 必要な場面 |
|---|---|
| ストリーミング | 優れたターミナル/エディタUX。 |
| ツール呼び出し | エージェント型コーディング、ファイル編集、コマンド実行。 |
| 長いコンテキスト | 大規模リポジトリと複数ファイルの変更。 |
| 構造化出力 | 計画、タスク分解、自動化ワークフロー。 |
| 画像入力 | UIスクリーンショット分析とデザインからコードへのワークフロー。 |
| フォールバック | 本番の安定性と長時間実行タスク。 |
