AI 编程工具（CLI / IDE 插件）

本页中的 {baseUrl} 是平台 API 根地址（不含末尾 / 或 /v1），使用前请替换为实际地址。模型、价格和界面以当前控制台及客户端版本为准。

Claude Code

简介：Anthropic 官方终端编程助手。MRouter 提供 Anthropic 原生协议（POST /v1/messages），因此 Claude Code 可以零改造接入。

官方主页：https://www.anthropic.com/claude-code

安装

Windows

# 1. 安装 Node.js LTS：https://nodejs.org/
node --version
npm --version

# 2. 安装 Git for Windows（Claude Code 在 Windows 下依赖 Git Bash）
#    https://git-scm.com/downloads/win

# 3. 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 4. 验证
claude --version

macOS / Linux

curl -fsSL https://claude.ai/install.sh | bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
claude --version

配置（方式一：settings.json，推荐）

编辑 ~/.claude/settings.json（Windows 为 C:\Users\你的用户名\.claude\settings.json）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "{baseUrl}",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5-20251001",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

字段含义：

变量	说明
`ANTHROPIC_BASE_URL`	不带 `/v1`，Claude Code 会自行拼接 `/v1/messages`
`ANTHROPIC_AUTH_TOKEN`	你的 `sk-` 密钥
`ANTHROPIC_MODEL`	主力模型（Sonnet 档）
`ANTHROPIC_SMALL_FAST_MODEL`	轻量模型（Haiku 档），用于后台摘要等轻任务
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	关闭非必要遥测，避免向官方域名发请求

配置（方式二：环境变量）

Windows（PowerShell）

[Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL','{baseUrl}','User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN','sk-你的密钥','User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL','claude-sonnet-4-5-20250929','User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_SMALL_FAST_MODEL','claude-haiku-4-5-20251001','User')

设置后需要重开终端才生效。

macOS / Linux

cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL="{baseUrl}"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5-20251001"
EOF
source ~/.zshrc

验证与使用

# 确认环境变量已生效
echo $ANTHROPIC_BASE_URL          # 应输出 {baseUrl}

# 进入项目目录并启动
cd /path/to/your/project
claude

# 在会话内切换模型
/model

原文列出的 Claude 模型示例（原文标注支持 anthropic 端点；当前可用性及倍率以控制台为准）：

模型 ID	倍率	定位
`claude-haiku-4-5-20251001`	3.5	轻量快速
`claude-sonnet-4-5-20250929`	10.5	均衡，推荐主力
`claude-sonnet-5`	7	新一代均衡
`claude-opus-4-5-20251101`	17.5	高能力
`claude-opus-5`	17.5	旗舰
`claude-fable-5`	35	最强，成本高

重要提醒：设置 ANTHROPIC_BASE_URL 后，Claude Code 的所有模型请求（含官方预设模型）都会走 MRouter，不再消耗 Anthropic 官方账号额度。

Codex CLI

简介：OpenAI 官方终端编码代理，MRouter 的 /v1/responses 端点与之兼容。

项目主页：https://github.com/openai/codex

安装

Windows（推荐 WSL2）

wsl --install
# 重启后进入 WSL
wsl

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
nvm install 22
npm i -g @openai/codex
codex --version

macOS / Linux

npm install -g @openai/codex
# 权限报错时：sudo npm install -g @openai/codex
codex --version

配置

编辑 ~/.codex/config.toml：

model = "gpt-5.2"
model_provider = "mrouter"

[model_providers.mrouter]
name = "MRouter"
base_url = "{baseUrl}/v1"
env_key = "MROUTER_API_KEY"
wire_api = "responses"

字段含义：

字段	说明
`model`	默认模型，如 `gpt-5.2`、`gpt-5.3-codex`
`base_url`	带 `/v1`
`env_key`	环境变量名，Codex 会从这个变量读取密钥
`wire_api`	`responses` 使用 `/v1/responses`；请确认所用 Codex 版本及上游均支持 Responses API

设置密钥环境变量：

# macOS / Linux（写入 ~/.zshrc）
export MROUTER_API_KEY="sk-你的密钥"

# Windows PowerShell
[Environment]::SetEnvironmentVariable('MROUTER_API_KEY','sk-你的密钥','User')

使用

cd /path/to/your/project
codex
# 会话内切换模型
/model

推荐模型：gpt-5.3-codex、gpt-5.1-codex、gpt-5.2、kimi-k2.7-code。

CC Switch（AI CLI 统一管理器）

简介：开源跨平台工具，统一管理 Claude Code、Codex、Gemini CLI 三端的 Provider 配置、MCP 服务器、系统提示词，一键切换而无需手改配置文件。

GitHub：https://github.com/farion1231/cc-switch
下载：https://github.com/farion1231/cc-switch/releases

安装

# macOS（Homebrew）
brew tap farion1231/ccswitch
brew install --cask cc-switch

# ArchLinux
paru -S cc-switch-bin

# Web 版（无头 / SSH 服务器）
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-web-linux-x64.tar.gz
tar -xzf cc-switch-web-linux-x64.tar.gz
cd cc-switch-web/ && ./cc-switch-web
# 默认端口 17666，浏览器访问 http://localhost:17666

Windows 从 Releases 下载 .msi 或便携版 .zip。

核心能力

模块	说明
Provider 管理	Claude / Codex / Gemini 三端配置一键切换，支持多端点与延迟测速
4 层模型配置	Haiku / Sonnet / Opus / Custom 四级模型粒度
MCP 服务器管理	单面板管理三端 MCP，支持 stdio / HTTP / SSE 三种传输
Prompts 管理	多预设系统提示词，对应 `CLAUDE.md` / `AGENTS.md` / `GEMINI.md`
Skills 扩展	统一管理扩展能力

手动添加 MRouter 配置

打开 CC Switch，点击右上角「+」新增 Provider
顶部切换到目标应用：Claude / Codex / Gemini
填写：

字段	填写内容
名称	`MRouter`
API 地址	Claude：`{baseUrl}`；Codex：`{baseUrl}/v1`
API Key	`sk-你的密钥`
主模型（必填）	如 `claude-sonnet-4-5-20250929`
Haiku 模型	`claude-haiku-4-5-20251001`
Sonnet 模型	`claude-sonnet-5`
Opus 模型	`claude-opus-5`

保存后，在供应商列表点击「启用」
重启对应 CLI 工具使配置生效（Claude Code 支持热重载，其余需重启）

首次使用的设置建议：设置 → 通用 → 窗口行为，建议全部开启「开机自启」「静默启动」「应用到 Claude Code 插件」「跳过初次安装确认」「关闭时最小化到托盘」。其中**「跳过初次安装确认」可绕过 Claude Code 反复弹出的登录界面**，强烈建议开启。

Cline / Roo Code（VS Code 插件）

VS Code 扩展市场安装 Cline（或 Roo Code）
打开插件设置，配置如下：

字段	填写内容
API Provider	`OpenAI Compatible`
Base URL	`{baseUrl}/v1`
API Key	`sk-你的密钥`
Model ID	如 `claude-sonnet-4-5-20250929`

部分版本需要额外勾选「Supports Images」「Supports Computer Use」等能力开关，按需开启
保存后即可在 VS Code 侧边栏对话

注意：Cline 会发送大量长上下文请求，建议在控制台为这个令牌单独设置额度上限，避免成本失控。

Cursor

Cursor 支持覆盖 OpenAI 端点：

Ctrl/Cmd + Shift + P → 搜索 OpenAI API Key → 填入 sk-你的密钥
设置 → Models → 展开 OpenAI API Key → 开启 Override OpenAI Base URL → 填 {baseUrl}/v1
点击「Verify」验证
在模型列表中添加自定义模型名，如 claude-sonnet-4-5-20250929、gpt-5.2
关闭 Cursor 内置的其他模型（Tab 补全等内置功能仍走官方，无法代理）

Cursor 的 Agent / Composer 功能依赖特定模型能力，代理接入的兼容性会随版本变化。如果 Agent 模式异常，改用 Chat 模式。

Continue（VS Code / JetBrains）

以下示例适用于使用 JSON 配置的版本，编辑 ~/.continue/config.json；如当前版本使用不同配置格式，请以客户端为准：

{
  "models": [
    {
      "title": "MRouter - GPT-5.2",
      "provider": "openai",
      "model": "gpt-5.2",
      "apiBase": "{baseUrl}/v1",
      "apiKey": "sk-你的密钥"
    },
    {
      "title": "MRouter - Claude Sonnet",
      "provider": "openai",
      "model": "claude-sonnet-4-5-20250929",
      "apiBase": "{baseUrl}/v1",
      "apiKey": "sk-你的密钥"
    }
  ],
  "tabAutocompleteModel": {
    "title": "MRouter - 补全",
    "provider": "openai",
    "model": "gpt-5-mini",
    "apiBase": "{baseUrl}/v1",
    "apiKey": "sk-你的密钥"
  }
}

Claude Code​

安装​

配置（方式一：settings.json，推荐）​

配置（方式二：环境变量）​

验证与使用​

Codex CLI​

安装​

配置​

使用​

CC Switch（AI CLI 统一管理器）​

Cline / Roo Code（VS Code 插件）​

Cursor​

Continue（VS Code / JetBrains）​

Claude Code

安装

配置（方式一：settings.json，推荐）

配置（方式二：环境变量）

验证与使用

Codex CLI

安装

配置

使用

CC Switch（AI CLI 统一管理器）

Cline / Roo Code（VS Code 插件）

Cursor

Continue（VS Code / JetBrains）