claude-code-proxy,更换 claude code 的内部模型
- 仓库教程: https://github.com/musistudio/claude-code-router/blob/main/README_zh.md
【免费Claude Code,免费模型有满血版几成功力? Claude Code高热度AI编程工具】
- https://juejin.cn/post/7528199682431238186
据说是更换 claude code 内部的模型,一个典型的做法是换成 gemini。
试着用该方案,实现数个免费代理商的轮询,确保更换配置时丝滑顺畅。而不是手动切换配置文件的 key 值,很麻烦低效。
全局安装
bash
pnpm i -g @musistudio/claude-code-router
配置全局的 .claude-code-router/config.json 配置文件
claude-code-proxy 的配置文件在全局的 .claude-code-router/config.json
内。
这是目前的配置文件,尽量保证及时更新:
最新的 .claude-code-router/config.json 配置文件
json
{
"Providers": [
{
"name": "gemini",
"api_base_url": "https://gemini-balance-lite.ruan-cat.com/v1beta/models/",
"api_key": "AIzaSyBP6MCPHw2Rw9lvEBflB-13D7A1j7PuscA,AIzaSyC5_0GSeA2XJZURzg9XLxSJDSPh7iLGarg",
"models": ["gemini-2.5-flash", "gemini-2.5-pro"],
"transformer": {
"use": ["gemini"]
}
}
],
"Router": {
"default": "gemini,gemini-2.5-flash",
"think": "gemini,gemini-2.5-pro"
}
}
基于 gemini-balance-lite 方案的中转商配置
gemini-balance-lite 是一个使用边缘云函数实现的自建 gemini 轮询代理方案,点此阅读自建教程笔记。
无法启动
在 window 内无法启动,莫名其妙报错。
log
PS D:\code\github-desktop-store\gh.notes> ccr start
undefined
Loaded JSON config from: C:\Users\pc\.claude-code-router\config.json
node:events:496
throw er; // Unhandled 'error' event
^
Error: ENOENT: no such file or directory, open 'C:\Users\pc\.claude-code-router\logs\ccr-2025-08-10T14:09:40.873Z.log'
at async open (node:internal/fs/promises:638:25)
at async RotatingFileStream.reopen (C:\Users\pc\AppData\Local\pnpm\global\5\.pnpm\@musistudio+claude-code-rou_8eebba572d89aedbba82aa7d5c79c13c\node_modules\@musistudio\claude-code-router\dist\cli.js:77186:14)
Emitted 'error' event on RotatingFileStream instance at:
at emitErrorNT (node:internal/streams/destroy:170:8)
at emitErrorCloseNT (node:internal/streams/destroy:129:3)
at process.processTicksAndRejections (node:internal/process/task_queues:90:21) {
errno: -4058,
code: 'ENOENT',
syscall: 'open',
path: 'C:\\Users\\pc\\.claude-code-router\\logs\\ccr-2025-08-10T14:09:40.873Z.log'
}
Node.js v22.14.0
被卡住了
因为 claude-code-proxy 在 window 环境内无法运行,故放弃该方案。除非被解决。
又可以继续登录了
在我不使用任何 key 和 baseUrl,使用官方账号登录时,该工具又可以正常使用了。