一、安装 Node.js(已安装可跳过)
确保 Node.js 版本 ≥ 18.0
Windows
macOS
Ubuntu / Debian
卸载其他中转客户端(可选)
检查安装位置:
执行卸载:
二、安装 Claude Code
检查是否安装成功:
三、获取密钥
Smart Routing 是一项智能模型路由能力,能够根据输入任务的复杂程度,自动将请求分配至最合适的模型。约束与指南见此处 注意ClaudeCode无法接入非 \v1\messages 通讯的模型,使用智能路由接入时,所有路由层都需使用Claude系列模型。例如使用claude-haiku-4.5、claude-sonnet-5、claude-opus-5分别对应简单、复杂、超复杂三个路由层级。
四、配置环境变量
基础配置示例
智能路由接入请 ANTHROPIC_MODEL="auto"
Mac / Linux
Windows CMD
Windows PowerShell
双模型配置说明
Claude Code 默认使用双线程模型架构:
- 主线程模型:使用
ANTHROPIC_MODEL 环境变量配置
- 副线程模型:使用
ANTHROPIC_DEFAULT_HAIKU_MODEL 环境变量配置
- 用途:轻量级 / 快速任务模型
- 使用场景:
- 背景任务(文件监控、linter 检查等)
- 快速响应(简单问题、补全建议)
- 低优先级的辅助任务
基础配置(双模型,推荐)
Mac / Linux
Windows CMD
Windows PowerShell
单模型配置(可选)
如果只需要使用一个模型,有两种配置方法:
方法一:两个环境变量配置为同一个模型
将 ANTHROPIC_MODEL 和 ANTHROPIC_DEFAULT_HAIKU_MODEL 都设置为相同的模型:
Mac / Linux
Windows CMD
Windows PowerShell
方法二:启动后使用命令切换主线程模型
保持环境变量按「基础配置(双模型)」设置,启动 Claude Code 后,在交互界面中输入:
主线程会切换为使用 ANTHROPIC_DEFAULT_HAIKU_MODEL(即 claude-haiku-4-5)对应的模型。
错误指南
因Beta头部字段造成400错误
在设置中添加CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS : 1 ,禁止在请求体头部添加实验性功能相关内容。