程式碼代理
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 base URL 覆寫設為
https://api.basicrouter.ai/api/v1。 - 新增自訂模型，如
mwf/coding-auto、mwf/coding-fast或mwf/coding-long。 - 使用支援串流與工具呼叫的模型以獲得最佳代理行為。
疑難排解：
| 問題 | 建議修正 |
|---|---|
| 模型未顯示 | 手動將模型名稱新增為自訂模型。 |
| 工具呼叫失敗 | 在模型頁面使用具有 tool_calling: true 的模型。 |
| 串流中斷 | 使用退避重試或使用具有備援的路由別名。 |
| 401 錯誤 | 檢查 API 密鑰與 base 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 支援此 Anthropic 相容路徑，用於 Claude Code 與 Anthropic SDK 相容性：
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 的模型 | 若用戶端支援，切換為 chat 相容的 wire API。 |
Hermes 快速指南
使用 OpenAI 相容端點，除非您的 Hermes 部署已設定為其他協定。
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 截圖分析與設計轉程式碼工作流程。 |
| 備援 | 生產穩定性與長時間執行的任務。 |