Skip to content

README.md

Latest commit

 

History

History
321 lines (235 loc) · 9.14 KB

README.md

File metadata and controls

321 lines (235 loc) · 9.14 KB

npm version npm downloads

Claude Code Model Router

一个轻量级 API 网关，让你在使用 Claude Code 时可以切换到第三方 AI 模型。

支持 Windows、macOS、Linux 跨平台使用。

快速开始

方式一：使用 npx（推荐）

# 1. 初始化配置文件
npx claude-code-model-router init

# 2. 编辑 .env 文件，填入 API Keys

# 3. 启动网关
npx claude-code-model-router start

# 4. 新开终端，启动 Claude Code
# 第三方模型（网关模式）：
npx claude-code-model-router claude

# 官方订阅（默认模式）：
claude

方式二：全局安装

npm install -g claude-code-model-router

# 然后使用 ccmr 命令
ccmr init
ccmr start

# 启动 Claude Code
ccmr claude    # 第三方模型（网关模式）
claude         # 官方订阅（默认模式）

命令说明

# 初始化配置文件
npx claude-code-model-router init

# 启动网关
npx claude-code-model-router start
npx claude-code-model-router start --port 9000  # 指定端口

# 查看可用模型
npx claude-code-model-router models

# 启动 Claude Code（网关模式，使用第三方模型）
npx claude-code-model-router claude
npx claude-code-model-router claude --gateway-port 9000  # 自定义网关端口

# 启动 Claude Code（官方订阅）
claude

Claude Code 原生参数支持

ccmr claude 命令完整支持 Claude Code 的原生启动参数：

# YOLO 模式（跳过所有权限确认）
ccmr claude --dangerously-skip-permissions

# 继续上一次会话
ccmr claude --continue
ccmr claude -c

# YOLO 模式 + 继续上一次会话
ccmr claude --dangerously-skip-permissions --continue

# 恢复指定会话（交互式选择）
ccmr claude --resume
ccmr claude -r

# 恢复指定会话 ID
ccmr claude --resume <session-id>

# 调试模式
ccmr claude --debug
ccmr claude --verbose

# 连接 IDE
ccmr claude --ide

# 指定权限模式
ccmr claude --permission-mode bypassPermissions

# 打印模式（非交互式）
ccmr claude -p "你的问题"
ccmr claude --print --output-format json "你的问题"

支持的完整参数列表：

参数 说明
-c, --continue 继续最近的会话
-r, --resume [id] 恢复指定会话或打开会话选择器
--fork-session 恢复时创建新会话 ID
--dangerously-skip-permissions 跳过所有权限检查（YOLO 模式）
--permission-mode <mode> 权限模式：acceptEdits, bypassPermissions, default, dontAsk, plan
-p, --print 打印模式（非交互式）
--output-format <format> 输出格式：text, json, stream-json
--model <model> 指定模型（覆盖网关路由）
--system-prompt <prompt> 自定义系统提示
--add-dir <dirs...> 添加额外目录权限
-d, --debug 调试模式
--verbose 详细输出
--ide 自动连接 IDE
--gateway-port <port> 指定网关端口（默认 8080）

提示： 任何 Claude Code 原生支持的参数都可以直接传递给 ccmr claude

支持的模型

短名称 版本别名 模型 提供商
deepseek deepseek-v3.2, ds DeepSeek V3.2 DeepSeek
kimi kimi-k2.5, moonshot Kimi K2.5 Moonshot
minimax minimax-m2.7, mm MiniMax M2.7 MiniMax
qwen qwen3.5-plus, tongyi Qwen3.5 Plus 阿里云
glm glm-5, zhipu GLM-5 智谱 AI

模型参数

模型 Context Window Max Output Tokens
DeepSeek V3.2 128K 128K
Kimi K2.5 256K 32K
MiniMax M2.7 200K 192K
Qwen3.5 Plus 1M 64K
GLM-5 200K 128K

配置

环境变量 (.env)

DEEPSEEK_API_KEY=sk-xxx    # https://platform.deepseek.com/
KIMI_API_KEY=sk-xxx        # https://www.kimi.com/
MINIMAX_API_KEY=xxx        # https://platform.minimax.io/
QWEN_API_KEY=sk-xxx        # https://dashscope.console.aliyun.com/
GLM_API_KEY=xxx            # https://open.bigmodel.cn/

配置文件 (models.yaml)

可以自定义模型配置、添加别名等。运行 init 命令会生成模板。

使用场景

双模式使用（配置完全隔离）

本工具通过独立的配置目录实现完全隔离，让你可以同时使用官方订阅和第三方模型：

┌─────────────────────────────────────────────────────────────────┐
│  模式1: 官方订阅（默认）                                          │
│  命令: claude                                                    │
│  配置: ~/.claude/settings.json                                  │
│  用途: 使用 Claude 官方模型（订阅额度）                           │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│  模式2: 第三方模型（网关）                                        │
│  命令: npx claude-code-model-router claude                      │
│  配置: ~/.claude-gateway/settings.json                          │
│  用途: 使用第三方 AI 模型（DeepSeek, GLM, Qwen 等）              │
└─────────────────────────────────────────────────────────────────┘

为什么配置是隔离的？

  • 官方模式使用 ~/.claude/ 配置目录（Claude Code 默认）
  • 网关模式使用 ~/.claude-gateway/ 配置目录（独立隔离）
  • 两个配置目录完全独立，互不干扰
  • 在网关模式切换模型不会影响官方模式

使用步骤

第一步：启动网关

npx claude-code-model-router start

第二步：选择使用模式

使用官方订阅（终端 A）：

claude
  • 使用官方 Claude 模型（Sonnet, Opus, Haiku）
  • 消耗订阅额度
  • 配置存储在 ~/.claude/

使用第三方模型（终端 B）：

npx claude-code-model-router claude
  • 使用第三方 AI 模型（DeepSeek, GLM-5, Qwen3.5 等）
  • 按 API 使用量付费
  • 配置存储在 ~/.claude-gateway/

跨平台支持

所有命令在 Windows、macOS、Linux 上完全相同，无需修改。

在 Claude Code 中切换模型

官方模式（直接 claude 启动）

/model sonnet     # Claude Sonnet 4.5
/model opus       # Claude Opus 4.5
/model haiku      # Claude Haiku 3.5

网关模式（npx ... claude 启动）

使用短名称或版本别名切换模型：

# 使用短名称（向后兼容）
/model deepseek   # 切换到 DeepSeek V3.2
/model qwen       # 切换到 Qwen3.5 Plus
/model glm        # 切换到 GLM-5
/model kimi       # 切换到 Kimi K2.5
/model minimax    # 切换到 MiniMax M2.7

# 使用版本别名（明确指定版本）
/model deepseek-v3.2   # DeepSeek V3.2
/model glm-5           # GLM-5
/model minimax-m2.7    # MiniMax M2.7
/model kimi-k2.5       # Kimi K2.5
/model qwen3.5-plus    # Qwen3.5 Plus

重要： 两个模式的配置完全独立，在网关模式切换模型不会影响官方模式！

API 端点

端点 方法 说明
/v1/messages POST Anthropic Messages API
/v1/models GET 列出可用模型
/health GET 健康检查

开发

# 克隆项目
git clone https://github.com/luwill/Claude-Code-Model-Router.git
cd Claude-Code-Model-Router

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建
npm run build

# 本地测试
npm link
ccmr start

故障排除

端口被占用

# 使用其他端口
npx claude-code-model-router start --port 9000

API Key 错误

  1. 检查 .env 文件中的 Key 是否正确
  2. 确认账户有余额
  3. 运行 npx claude-code-model-router models 查看状态

更新日志

v1.2.0

  • 更新 GLM 模型至 GLM-5 版本
  • 更新 MiniMax 模型至 M2.7 版本
  • 更新 Qwen 模型至 Qwen3.5 Plus 版本
  • 更新 Kimi 模型至 K2.5 版本
  • 更新各模型的 context window 和 max tokens 参数
  • 新增版本别名支持（如 glm-5、minimax-m2.7、qwen3.5-plus、kimi-k2.5）

v1.1.0

  • 更新 MiniMax 模型至 M2.1 版本
  • 更新 GLM 模型至 4.7 版本
  • 更新 GLM API 端点至 https://open.bigmodel.cn/api/anthropic
  • 新增版本别名支持（如 glm-4.7、minimax-m2.1）
  • 优化日志显示，显示具体模型版本
  • 更新各模型的 context window 和 max tokens 参数

v1.0.1

  • 添加 Claude Code 原生参数支持

v1.0.0

  • 初始版本发布

License

MIT