
把 Claude Code 跑起来其实没啥门槛——难点向来是账号和网络。官方的 Claude Code 现在还是要走订阅(Pro 每月 20 美元),而且直接访问 API 对很多人来说并不稳定。如果你试过注册、绑卡、被风控这一套流程,就知道有多头疼。
所以“免订阅+中转”基本成了实际可选的唯一路径。clawdfree 正是沿着这个思路改出来的东西。它基于 Claude Code v2.1.88 改造,不需要登录 Claude 账号,直接用你手里的中转 API Key 就能跑。
clawdfree 配置流程
这套工具的核心改动就是去掉了 Claude 的账号鉴权,改为直连你指定的 API 端点和 Key。配置上没有太多花哨,几步就能走通。
第一步:下载
直接从项目仓库拿编译好的二进制。目前 clawdfree 支持 macOS 和 Linux 环境,Windows 可以用 WSL 跑。下载完丢到 /usr/local/bin 或者随便一个 PATH 目录里,顺手 chmod +x。
第二步:准备中转 API 信息
这是关键。你需要一个可用的中转 API 地址和对应的 Key。很多中转站支持 Claude Sonnet / Claude 3 Opus 模型。如果你手头有走 OpenAI 兼容接口的中转服务,换成 Claude 模型的请求地址也能用。
第三步:写入配置
clawdfree 不依赖 Claude 官方的 config 文件系统,你用的话直接设置两个环境变量就行:
export CLAUDE_CODE_API_BASE="https://你的中转地址/v1"
export CLAUDE_CODE_API_KEY="sk-你的key"
我建议在终端里跑之前先用 echo 确认变量生效,避免因为路径写错报 401。
第四步:启动
直接在项目目录底下敲 clawdfree。第一次启动它会自动帮你初始化项目上下文,等几秒钟进入交互模式就能正常用 slash 命令或者自然语言对话了。
配置里容易卡住的地方
如果你发现跑了之后一直报 Rate limit 或者 Empty response,十有八九不是 clawdfree 的问题,而是中转 API 的限制或者模型名称没写对。我遇到过的情况是某家中转站虽然标了 Sonnet,但实际模型名填的是 claude-3-sonnet-20240229,用他们在文档里给的那个名字完全不行。
这种情况下建议你直接问中转站客服要准确的 model name,或者自己在终端里用 curl 测一下接口通不通:
curl https://你的中转地址/v1/chat/completions \
-H "Authorization: Bearer sk-你的key" \
-H "Content-Type: application/json" \
-d '{"model":"claude-3-sonnet-20240229","messages":[{"role":"user","content":"hi"}]}'
通了说明中转本身没问题,只是 clawdfree 和它的对接参数需要调。
实际使用体验和限制
我拿 clawdfree 试过一个完整的个人小项目,从生成 Flask 脚手架到写 Dockerfile 再到修复两个 lint 报错。整体响应速度取决于你中转 API 的延迟,我用的一家中转大概 2-3 秒出首字,写完整函数的时候会有一点点停顿,但在能接受的范围内。
另外说一个很多人不留意的事:clawdfree 因为绕过了 Claude 官方账号,所以不能使用 Projects 或者 Artifacts 这些和账号绑定的云功能。这些功能对你本地开发影响不大,但如果你习惯了用 Claude Code 当知识库和对话历史索引,就得额外依赖本地文件来记录上下文。
还有一点,clawdfree 基于 v2.1.88,如果你之前用过官方 v2.2.x 的某些新特性(比如新的自动补全策略),这里会缺失。但如果你只是做代码审查、生成脚本、调试报错之类的工作,旧版核心能力完全够用。
谁更适合用这种方案
免订阅加上中转的模式,最适合三类人:
- 不想每个月再交 20 美元给 Claude Pro 的人——你付的是 Key 的按量费用,用多少花多少
- 频繁切换 API 供应商的开发者——一份 clawdfree 配置,换 Key 就行
- 希望在限制比较多的网络区域里用 Claude 能力的人——中转本来就是帮你这事的
反过来,如果你依赖 Claude 的官方生态,比如经常用 Projects 协作或者想看完整的对话历史同步,那还得走官方订阅。
如果想更稳定一点
用 clawdfree 有个隐含的前提:你手里的中转 Key 质量决定了使用体验的好坏。不建议用那种免费额度或者限制极严的公测 Key,宁可花十几块买一个月量的稳定中转,也不要在中断和报错上浪费时间。
总之,clawdfree 的配置流程很短,难点全在外围(中转能不能跑通、模型命名是否匹配)。把这个解决掉,你就得到了一套不绑账号、不交月费、随时可以换底座的 Claude Code 运行环境。
Comments
Leave a Comment