clawdfree 实战:零月费跑通 Claude Code,用中转 API 生成文档

clawdfree 基于 Claude Code 改造,去掉了订阅校验并接入中转 API,只需一个 API Key 即可免费使用。本文通过给 React 组件生成文档的场景,手把手教你配置和运行。

clawdfree 实战:零月费跑通 Claude Code,用中转 API 生成文档

最近几天连续有几个人问我同一个问题:Claude Code 很好用,但官方要订阅,API 又容易被限,有没有什么办法能低成本跑起来?

我直接说答案就是 clawdfree。这东西基于 Claude Code v2.1.88 改的,核心改动是砍掉了账号订阅校验,并且接入了中转 API 线路。说白了,你不用付那个 $20 的月费,也不用折腾信用卡,只要有一个中转 API Key 就能跑。

我拿一个具体场景走一遍,你就知道这东西到底怎么用了。

场景:用 clawdfree 快速给项目生成文档

我手头有个 React 组件的项目,之前一直拖着一堆代码没写注释和 README。我不想自己一句句写,就想让 Claude Code 帮我搞定。

第一步:拿到 clawdfree 和配置 API

这个项目在 GitHub 上能找到,直接 clone 下来。安装依赖那步没什么特别的,跟官方一样走 npm 或者 yarn。

关键在配置。它默认读取环境变量里的 ANTHROPIC_API_KEY,但你可以直接把这个变量设成你的中转 API Key,只要那个中转商支持 Anthropic 协议就行。我试了一家中转,地址填的是他们给的 endpoint,然后把 Key 怼进去。

export ANTHROPIC_BASE_URL=https://your-proxy.com/v1
export ANTHROPIC_API_KEY=sk-your-key-here

这一步你最好确认一下你的中转线路稳不稳定,我用下来偶尔会有超时重试,但基本不影响。

第二步:启动 clawdfree 开始工作

你不需要登录任何 Claude 账号,直接在项目目录下跑:

clawdfree

第一次启动会让你确认要扫描哪些文件,然后 Claude Code 就开始干活。我让它“给 src/components 下的所有组件加上 JSDoc 注释,英文写得简洁点”,它一步步扫描代码、理解逻辑、生成注释,整个过程花了大约三分钟。

这里有个细节:clawdfree 默认走的是 claude-sonnet-4-20250514,能力足够用了,但如果你用的是那种按量计费的中转,注意一下 token 消耗。我扫了 15 个文件,大概花了 4 万 token,折合人民币不到两块钱。

限制和需要注意的地方

用了一整天之后,我必须说几个真实槽点。

中转 API 的选择直接决定成败。 我换了两家中转,第一家偶尔 502,第二家基本稳定。如果你的中转线路质量一般,clawdfree 会自动重试,但你会感觉到明显的卡顿。这不是 clawdfree 的问题,是上游的问题。

不支持多人协作的场景, 因为本质上是绕过订阅的改造版,如果你有团队协作需求,官方版的权限管理和分享功能还是没法替代的。

模型更新有滞后。 它基于 v2.1.88 改的,官方如果更新了版本,clawdfree 这边得等人再改一版才能同步。目前我对比了一下,功能上基本一致,但一些小工具调用上的差异偶尔会遇到。

还有一点:如果你习惯用 Claude Code 的 deep thinking 模式,clawdfree 默认是开的,但有些中转商对长上下文支持不好,超过 80K 就开始丢响应。所以你遇到模型突然给不出结论时,先检查一下上下文是不是已经爆了。

适合什么样的人

我个人觉得 clawdfree 最适合两类人:一是个人开发者,尤其是短期项目或者练手阶段,不想为了一个工具专门开订阅;二是你已经有中转 API 的存量 Key(比如买了一些额度没用完),直接拿来跑 clawdfree 几乎零成本。

但如果你是一个正规团队,项目文件多、需要稳定性和连续性,我还是建议你直接走官方。毕竟省下来的订阅钱,可能远不如一次中转故障浪费时间带来的损失。

最后说一句:clawdfree 本身不收费,也没内置广告,就是一套改造后的命令行工具。你把 API 配好就能直接用,这个诚意还是可以的。

觉得有用?看看更多

发现更多优质内容与最新行业洞察。

评论

发表评论

0/2000

评论经审核后发布。