本文基于 Windows 环境,其他环境应该差不多
0. 环境说明
- OS:Windows
- 目标:在本地完成 Claude Code 安装,并通过本地网关工具接入调用链路
- 参考文档:
code.claude.com/docs/en/ove…
1) 安装 Claude Code 并验证
先按官方文档完成安装。安装后执行:
claude --version
如果能正常输出版本号,说明 CLI 已安装成功,后续可以继续做配置联调。
2) 修改 claude code 免登陆
~/.claude.json 是 Claude Code 的本地配置文件。
添加下面这行:
"hasCompletedOnboarding": true
3) 下载并配置 CLIProxyAPI
发布地址:
github.com/router-for-…
下载对应系统版本后,进入目录(Windows 示例):
3.1 生成配置文件
复制 config.example.yaml 并重命名为 config.yaml。
打开后配置 API Key(保留一个即可):
api-keys:
- "your-api-key"
配置界面示意:
3.2 启动并完成授权
在该目录打开终端并运行(可参考这个教程:help.router-for.me/cn/agent-cl…
./cli-proxy-api --codex-login
按页面提示完成授权流程。若你有多账号策略,可按工具文档进行账号管理与切换。目前codex 每周有免费额度,使用时会在这些账号自动切换
3.3 启动 cli-proxy-api
./cli-proxy-api
4) 下载并配置 cc-switch
发布地址:
github.com/farion1231/…
下载并安装后打开:
点击 Claude 图标并添加配置:
- API Key:填写你在
config.yaml中设置的值 - 请求地址:填写本地网关地址(端口按你的实际配置)
5) 网络与代理
确保系统代理/网络通道已正确开启,否则可能出现连接失败或超时。
6) 最后开始使用
claude