Frontier Now
搜索

开发工具#代码智能体#网关

free-claude-code：用本地代理让 Claude Code 接入多家模型服务商

free-claude-code 是 AGPL-3.0 本地代理，让 Claude Code、Codex 接入多家模型服务商，服务中断时自动切换到下一个模型。

作者
Frontier Now 编辑部
发布

项目资料

GitHub Ecosystem
仓库地址github.com/Alishahryar1/free-claude-code
许可证
AGPL-3.0-only
主语言
Python
星标
62,273
核查时间
2026-10-21

以上快照资料以核查当日为准，可能随版本或运营策略变化。

free-claude-code 的生成式封面：白色标题下方是副标题，说明它是一个本地代理，服务于 Claude Code、Codex 和 VS Code

Claude Code 默认连接 Anthropic 的模型。如果你想沿用它的界面和工作流，却不想为另一套账单付费，就需要一个中间层。free-claude-code 是一个 AGPL-3.0 许可的开源项目，在本机起一个代理，把 Claude Code、Codex、VS Code 等客户端发出的请求转给你配置好的模型服务商。README 说它接入了 61 家服务商，包括免费额度、付费 API、订阅账户和本地模型。项目页写明，它是独立项目，与 Anthropic 无关，也未获其背书。

它的价值在于切换。同一套客户端可以换到另一家模型，也可以在某家服务商限流或宕机时自动切到备用模型，而不必中断当前这一轮对话。这也意味着，模型的能力、工具调用的稳定性和费用，都取决于你选的服务商。README 没有比较不同模型的编码质量，我们也没有做过这种比较。

核心功能

  • 一个界面管理多家服务商：免费、付费、订阅和本地模型都在同一个可搜索的管理界面里配置。服务商目录里有 Anthropic（需要单独计费的 API key）、OpenAI API、GitHub Copilot、Vercel AI Gateway、Hugging Face Inference Providers 等条目。
  • 故障时自动切换：一轮对话的重试用完后，FCC 改用你排好的下一个模型，这一轮不需要从头开始。README 说这一功能对所有客户端都生效。
  • 多个客户端共用一个代理：Claude Code 的 VS Code 扩展、VS Code Chat、Claude Desktop、Codex 的 VS Code 扩展和 App、JetBrains 的 ACP 都可以连接。连接 Claude Desktop 前要完全退出它，连接之后再重新打开。
  • 订阅账户走 OAuth 连接：ChatGPT 订阅通过 OAuth 服务商页面连接，GitHub Copilot 使用你登录的 GitHub 账户和订阅。Anthropic 则使用单独计费的 API key。
  • 语音与远程入口：语音可以用本地 Whisper 或 NVIDIA NIM 转写，也可以通过 Discord 发送消息。
  • 浏览器里的 Codex 会话：选一个文件夹，在浏览器里运行 Codex，并能在同一个会话里切换服务商和模型。
  • 代理认证：启用 Proxy Authentication 后，本地代理会要求 bearer token，避免别人随便连上来。

典型使用场景

  • 想沿用 Claude Code 界面、但不想为 Anthropic 账单付费的个人开发者：先用服务商的免费额度试跑小任务，流程顺手以后再决定是否付费。免费额度由各服务商决定，README 也写明可能变化。
  • 想让第二个模型做一次代码审查的人：在同一个仓库里切换模型，跑同样的任务，对比两者的输出。
  • 担心单一服务商不稳定的团队：给同一个客户端配置两三个备用模型，主服务商出问题时由代理自动切换。
  • 在 IDE 或手机上写代码的人：VS Code、JetBrains 和语音入口共用同一套配置。

如果你更关心让 Agent 跨会话长期推进任务，而不是换模型，可以对照看看 LoopX。

快速上手

macOS 和 Linux 用 README 给出的一行安装命令：

curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh

Windows 用 README 里的 PowerShell 命令，它会从同一仓库取 install.ps1。直接把远程脚本通过管道交给 sh 执行，等于运行服务器返回的任何内容，所以更稳妥的做法是先下载下来读一遍再执行。

装好之后：

  1. 打开管理界面，进入 Providers，选择服务商，粘贴 API key 并保存。以 NVIDIA NIM 为例，README 的步骤是点击 Add key，粘贴后点 Save。
  2. 在 MODEL 下拉框里选择模型。服务商无法列出模型时，手动填写 <provider-id>/<exact-provider-model-id>。
  3. 在 Claude Code、Codex 等客户端里连接 FCC，然后开一个新会话。

小结

free-claude-code 适合已经在用 Claude Code、Codex 或 VS Code 里 AI 功能的人，想换模型、留一个备用，或者控制成本。它不适合期待 Anthropic 官方支持，或者希望有人承担服务保证的人。

有几件事要先知道。第一，免费额度属于各服务商，README 说它可能变化。第二，订阅类接入（ChatGPT、GitHub Copilot）受对应服务商的条款约束。README 说 FCC 会遵循服务商条款，并在某家服务商不再允许时移除相应的集成，但我们没有逐家核对条款。第三，许可证为 AGPL-3.0-only。如果你修改了它，并把修改后的版本作为网络服务提供给别人，AGPL 第 13 条要求你向这些用户提供修改后版本的源代码。

我们只核对了 README、LICENSE 和仓库元数据，没有安装运行，也没有比较不同模型在 Claude Code 中的工具调用质量。GitHub 对这个仓库的自动识别结果是 NOASSERTION，所以许可证以 LICENSE 文件中的 AGPL-3.0-only 声明为准。截至 2026-10-21，仓库有 62,273 颗星，最近一次推送是 2026-10-18，未归档。