Claude登不上、没账号?国内免费替代方案!用claude-code-router秒解锁AI编码
有没有遇到过这种窘境:想用工具Claude Code辅助编码,却因地区限制登不上、没有账号被拒之门外?别慌!今天分享一个国内免费可用的完美替代方案——通过claude-code-router配置国内主流AI模型(Kimi、硅基流动、通义千问等),无需Claude账号,一键解锁AI编码功能,步骤简单到新手也能秒会!
一、前提准备
首先确保你的设备已安装Node.js(建议v16+版本),因为后续安装依赖npm(Node.js自带的包管理器)。
下载Node.js:https://nodejs.org/ (安装时勾选"Add to PATH",默认配置即可)
验证安装:打开终端/命令提示符,输入
node -v和npm -v,能显示版本号即安装成功。
二、核心步骤:安装+配置
1. 安装Claude基础代码
打开终端(Windows用CMD/PowerShell,Mac/Linux用Terminal),输入以下命令全局安装:
npm install -g @anthropic-ai/claude-code2. 安装claude-code-router(关键代理工具)
继续在终端输入命令,安装路由工具:
npm install -g @musistudio/claude-code-router3. 生成初始配置文件
输入以下命令生成默认配置,后续我们会手动编辑优化:
ccr start提示输入参数时暂时随意填写(比如直接回车),完成后按Ctrl+C退出终端,进入下一步编辑配置文件。
4. 编辑配置文件(核心环节)
配置文件的作用是关联国内可访问的AI模型,不同系统的配置文件路径不同,找到后用记事本(Windows)或文本编辑器(Mac/Linux)打开:
Linux/Mac:
~/.claude-code-router/config.jsonWindows:
C:/User/你的用户名/.claude-code-router/config.json
也可使用下面的命令进行网页配置
ccr ui配置文件示例(直接复制可用,需替换API Key)
以下配置包含3个国内常用模型提供商,支持Kimi-K2、Qwen3-Coder等强编码模型,复制后按需修改api_key即可:
{ "LOG": false, // 是否开启日志(默认关闭,新手无需开启) "OPENAI_API_KEY": "", // 无需填写,留空即可 "OPENAI_BASE_URL": "", // 无需填写,留空即可 "OPENAI_MODEL": "", // 无需填写,留空即可 "Providers": [ // 1. 硅基流动(支持Kimi-K2模型,上下文长,编码流畅) { "name": "siliconflow", "api_base_url": "https://api.siliconflow.cn/v1/chat/completions", "api_key": "sk-xxx", // 替换为你的硅基流动API Key(官网免费申请) "models": ["moonshotai/Kimi-K2-Instruct"], "transformer": { "use": [["maxtoken", {"max_tokens": 16384}]] // 最大 tokens 限制(16k上下文) } }, // 2. Moonshot(Kimi官方,模型稳定,中文支持好) { "name": "moonshot", "api_base_url": "https://api.moonshot.cn/v1/chat/completions", "api_key": "sk-xxx", // 替换为你的Kimi API Key(官网注册申请) "models": ["kimi-k2-0711-preview"], "transformer": {"use": ["openrouter"]} // 适配API格式兼容性 }, // 3. 阿里通义千问(Qwen3-Coder,中文编码优化,免费额度充足) { "name": "modelscope", "api_base_url": "https://api-inference.modelscope.cn/v1/chat/completions", "api_key": "替换为你的api_key(删除ms-前缀)", // 模型scope API Key需去掉开头"ms-" "models": ["Qwen/Qwen3-Coder-480B-A35B-Instruct"], "transformer": { "use": [["maxtoken", {"max_tokens": 65536}]] // 64k超长上下文 } } ], "Router": { "default": "siliconflow,moonshotai/Kimi-K2-Instruct" // 默认使用的模型(可自定义) } }关键说明:
API Key获取:硅基流动、Kimi(Moonshot)、模型scope的API Key需去各自官网注册账号后申请,均有免费额度,完全够用日常编码。
transformer参数:核心作用是解决不同AI模型提供商的API格式差异,无需修改,直接沿用示例配置即可。
模型选择:如果需要超长上下文,优先选Qwen3-Coder(64k)或Kimi-K2(16k);如果侧重中文编码准确性,Kimi和Qwen都是优选。
5. 启动服务+交互式配置(可选)
方式1:直接启动(推荐,已配置好文件)
在终端进入你要工作的目录(建议新建空白目录,避免读取不信任文件),输入:
ccr code方式2:交互式配置(不想手动改文件?直接终端输入)
如果觉得编辑JSON文件麻烦,可通过命令行交互式配置,按提示输入信息即可:
C:\Users\Administrator>ccr code Enter Provider Name: Gemini # 输入模型提供商名称(自定义) Enter Provider API KEY: 123456 # 输入你的API Key Enter Provider URL: https://xxx.com # 输入提供商API地址 Enter MODEL Name: gemini-2.5-pro # 输入模型名称三、授权信任+开始使用
- 启动后会提示是否信任当前目录,选择
1. Yes, proceed(按回车确认),建议在新建的空白安全目录下操作,避免执行不信任文件:
Do you trust the files in this folder? C:\Users\Administrator Claude Code may read files in this folder. Reading untrusted files may lead Claude Code to behave in unexpected ways. With your permission Claude Code may execute files in this folder. Executing untrusted code is unsafe. 1. Yes,proceed 2. No,exit Enter to confirm ·Esc to exit- 授权成功后,会进入Claude Code交互界面,和官方版本用法完全一致!比如输入:
write a test for index.js # 让AI生成index.js的测试用例也可以用/help查看帮助,/status查看当前配置状态。
四、常用命令速查(收藏不迷路)
| 命令 | 描述 |
|---|---|
ccr code | 启动CCR代理会话(最常用,开始AI编码) |
ccr start | 启动CCR后台服务 |
ccr stop | 停止CCR后台服务 |
ccr restart | 重启CCR后台服务 |
ccr status | 查看CCR服务运行状态 |
ccr ui | 打开Web UI管理界面(可视化配置) |
ccr help | 查看所有命令帮助 |
ccr version | 查看当前CCR版本 |
五、避坑注意事项
Node.js版本:必须安装v16及以上,否则npm安装会失败,安装后记得重启终端。
API Key安全:配置文件中的API Key是私人凭证,不要分享给他人,避免泄露后被恶意使用。
目录安全性:务必在安全目录下启动,不要在包含未知脚本、可执行文件的目录授权,防止AI误执行危险代码。
兼容性问题:如果启动后报错,大概率是API Key错误或模型名称写错,检查 Providers 中的
api_base_url、api_key、models字段是否和官网一致。日志排查:如果遇到问题,可将配置文件中的
LOG改为true,启动后查看日志定位问题。
总结
无需Claude账号、不用科学上网,通过claude-code-router就能在国内免费使用AI编码工具!配置简单,支持Kimi、通义千问等主流模型,完全替代Claude Code的核心功能。不管是日常编码、写测试用例,还是解决技术难题,都能轻松应对。
如果配置过程中遇到问题,欢迎在评论区留言,一起交流避坑~ 赶紧试试这个方案,让AI编码效率翻倍!