Free Claude Code GitHub 项目：真的免费吗？（2026）

错误 #1："它只是个 URL 重定向"

Anthropic Messages 与其他提供商格式之间的转换工作量相当大。工具调用、系统消息、图片、推理内容和流式数据块都需要针对具体格式处理。

错误 #2："免费模型无法处理智能体任务"

对于编写函数、修复 bug、解释代码这类简单任务，免费额度的模型在我们 4 月的测试中表现尚可。 在依赖工具调用可靠性的多步骤智能体任务上，差距会拉大。我们没有重新测试 README 目录中的新模型。

错误 #3："项目内部实现是稳定的"

我们 4 月的版本描述了请求优化器、启发式工具调用解析器和强制串行化的子智能体。请求优化器已在 10 月被删除（PR #2112）。其余两项我们在当前 README 中没有找到描述，在当前源码中搜索 "run_in_background" 也没有结果，但我们没有逐行审计代码，所以请把它们视为未确认。项目每隔几天就发布一个版本（v6.18.1 到 v6.18.5 在 10 月 25 日至 29 日之间发布），任何指南都很快会过时。复制命令之前，请先查看 README。

错误做法：所有请求用同一个免费模型，且没有备用

MODEL="nvidia_nim/nvidia/nemotron-3-ultra-550b-a55b"   # for everything

在每分钟 40 次请求的限额下，繁忙的智能体会话可能触顶。没有备用模型时，这一轮就会失败。

正确做法：按层级路由并添加备用模型

MODEL_OPUS="nvidia_nim/nvidia/nemotron-3-ultra-550b-a55b"   # hard tasks
MODEL_SONNET="open_router/openrouter/free"                  # general coding
MODEL_HAIKU="lmstudio/<model-id>"                           # quick lookups, local
# Admin UI, Model Config: add ordered Fallback Models

繁重任务交给你手上最强的模型，快速任务留在本地，失败的请求转到下一个备用模型。

错误做法：选择不支持工具调用的模型

README 建议编程智能体优先使用支持工具调用的模型。纯聊天模型能回答问题，但无法完成编辑和命令执行。README 在 OpenAI API 的说明里还提到，其模型列表可能包含无法处理编程请求的模型 ID。

正确做法：让上下文大小和推理强度匹配任务

本地模型需要足够的上下文来容纳 Claude Code 的系统提示和工具定义（README）。在 Model Config 中按模型设置推理强度；除非有理由覆盖，否则保持默认的 From client。

Python 3.14 兼容性

2026 年 4 月时，该项目需要 Python 3.14，使用 3.12 或更早版本的用户在启动时会遇到 Pydantic/FastAPI 错误。 根本原因： 该项目的 pyproject.toml 当时固定了 requires-python = ">=3.14"。请使用以下命令安装 3.14：uv python install 3.14。 更新（2026 年 10 月 30 日）： 现在的固定值是 ==3.14.10（见下一条），并且安装程序会为你设置 uv 和 Python。

使用 pip install uv 在 macOS 上

Homebrew 管理的 Python 会拒绝 pip install uv，原因是 PEP 668（externally-managed-environment）。 根本原因： Homebrew 将其 Python 标记为系统管理。请使用官方安装程序：curl -LsSf https://astral.sh/uv/install.sh | sh。 更新（2026 年 10 月 30 日）： FCC 安装程序现在会替你设置 uv，所以这一条主要适用于手动安装。

设置 ANTHROPIC_BASE_URL 为 /v1

用户设置 ANTHROPIC_BASE_URL="http://localhost:8082/v1" 并收到 404 错误。 根本原因： Claude Code 会自己在基础 URL 后追加 /v1/messages。请将其指向 http://localhost:8082（不含 /v1）。 更新（2026 年 10 月 30 日）： 这是 4 月的测试结果，我们没有在 10 月重新测试；请使用 fcc-claude 启动器，它会替你设置该变量。

高负载下的 503 错误

免费层级提供商在过载时会返回 503。用户会将其视为代理 bug。 根本原因： 提供商侧的速率限制或容量问题。2026 年 4 月时，代理对 429/503 错误有指数退避机制，但免费层级的持续负载会触及限制。 更新（2026 年 10 月 30 日）： 备用模型和 PR #2112 带来的变化见下一条。

手动安装时 Python 版本不对

项目的 pyproject.toml 固定了 requires-python = "==3.14.10"。安装程序会为你设置 uv 和 Python。如果你克隆仓库自己运行，请使用 uv，不要用系统自带的 Python。

没有清除 ANTHROPIC_API_KEY

Anthropic 帮助中心说明：如果设置了 ANTHROPIC_API_KEY 环境变量，Claude Code 会使用它而不是你的 Claude 订阅，这意味着产生 API 费用。无论你走哪条路线，开始之前先检查你的 shell。

手动把 ANTHROPIC_BASE_URL 设成带 /v1 的地址

在 4 月的测试中，用户把基础 URL 设成代理地址加 /v1 会得到 404，因为 Claude Code 会自己追加路径。我们没有在 10 月重新测试。请使用 fcc-claude 启动器，它会替你设置该变量。

高负载下的 429 和 503 错误

免费额度的提供商会限流或宕机。FCC 会重试，如果你设置了备用模型，就会切换过去。自 PR #2112 之后，杂项请求也会发给提供商，所以 40 次/分钟这样的限额会比 4 月时用得更快。

OpenRouter 上的 Model not found 错误

OpenRouter 的免费模型列表会变化。上个月还能用的模型可能消失。请在 openrouter.ai/models 查看当前可用选项，或使用 README 中的免费路由模型。

照着旧教程操作

许多教程（包括本文 4 月的版本）描述的是 uv run uvicorn server:app、.env 文件和按层级的 thinking 开关。当前版本使用安装程序、Admin UI 和 fcc-* 启动器。报告 bug 时，请运行 fcc-doctor 并附上输出。

客观的权衡

• 质量下降。 底层模型不是 Claude，工具调用可靠性更低。Sonnet 或 Opus 能干净完成的智能体任务，在免费额度的模型上失败会更多。
• 免费额度不是永久的。 NVIDIA 把它的免费层称为用于原型验证的试用，称限额因模型而异，NVIDIA 开发者论坛的一位版主表示，免费层没有官方途径提高限额。要进入生产环境，需要走另一条付费路线。
• 数据路径改变。 你的提示词和代码会流经你选择的提供商，适用该提供商的留存和训练政策，而不是 Anthropic 的。向任何免费试用端点发送私有代码之前，请阅读其条款。
• 延迟增加。 代理多了一跳，格式转换增加开销，免费端点通常比 Anthropic 的服务慢。
• 没有官方支持。 Anthropic 的 Claude Code 文档表示，它不背书、不维护、不审计第三方网关，也不支持通过任何网关把 Claude Code 路由到非 Claude 模型。如果 Claude Code 更新后出问题，只能依靠社区。
• 许可证变更。 项目在 2026 年 9 月 24 日从 MIT 改为 AGPL-3.0-only。如果你打算修改后为他人运行，请阅读 AGPL 条款。

Goodbye Claude Code subscription fees.

Someone just built a proxy that runs Claude Code completely free... and it's wild.

You literally plug in a free NVIDIA API key and point Claude Code at localhost.

That's it.

— Hasan Toor (@hasantoxr)April 22, 2026

"质量会下降。底层模型不是 Claude，工具调用可靠性更低。Sonnet 或 Opus 能轻松完成的智能体任务，在免费额度上失败会更多。 免费额度不是永久的。数据路径会改变：你的提示词和代码会流经你选择的提供商。 适合折腾、离线工作或非敏感的个人项目。在处理客户代码或严肃工程时，它不是付费版 Claude 的直接替代品。"

X 上的 @sharbel，2026 年 4 月 24 日（英文原文翻译）

我们的看法

free-claude-code 是一个维护积极、迭代很快的代理，在一个特定场景下有实际价值：用免费或本地模型运行编程智能体界面，处理非关键工作。 适合使用的情况： 想在不付费的情况下体验 Claude Code 工作流、做个人项目、离线工作，或把代码留在自己的硬件上。 应该跳过的情况： 需要 Claude 级别的质量来写生产代码、需要可靠的多步骤智能体运行，或需要保证可用性。 如果你想用真正的 Claude 模型，客观的途径是 Claude Pro 或 Max 套餐，或 Console API 额度。

问： Claude Code 免费吗？

官方不免费。Anthropic 定价页（2026 年 10 月 30 日查看）显示，免费版不包含 Claude Code。Pro（按年付费 17 美元/月，按月付费 20 美元/月）、Max（100 美元/月起）、Team 和 Enterprise 包含 Claude Code。你也可以通过 Claude Console API 账户或 Amazon Bedrock 等云平台按 token 付费。安装 CLI 本身不收费，但要运行 Claude 模型，必须走上述付费途径之一。

问： Claude Code 有免费版本吗？

没有包含 Claude Code 的免费 Claude 套餐。最接近的免费方案是开源项目 free-claude-code：它保留 Claude Code 的界面，但把请求发给其他模型，例如 NVIDIA NIM 试用端点、OpenRouter 免费模型，或你自己在本地运行的模型。回答来自这些模型，而不是 Claude。

问： free-claude-code 的 GitHub 仓库是什么？

free-claude-code（GitHub：Alishahryar1/free-claude-code）是一个独立的开源代理和启动器，让 Claude Code 和其他编程智能体可以连接非 Anthropic 的提供商。截至 2026 年 10 月 30 日，该仓库约有 65,000 个 star，最新版本是 v6.18.5（2026 年 10 月 29 日发布），许可证为 AGPL-3.0-only。它与 Anthropic 没有关联，也未获其背书。

问： 如何获得免费的 Claude Code？

运行 free-claude-code GitHub README 中的安装脚本（它也可以帮你安装 Claude Code），在 build.nvidia.com 创建免费的 NVIDIA NIM API 密钥，在 FCC 管理界面（Admin UI）中添加密钥并选择模型，然后用 fcc-claude 命令启动 Claude Code。你得到的是运行在非 Claude 模型上的 Claude Code 界面。如果想用真正的 Claude 模型，需要付费的 Anthropic 套餐或 API 额度。

问： 哪些免费 LLM API 可以配合 Claude Code 使用？

项目 README 把 NVIDIA NIM 列在第一位。NVIDIA 表示，免费层对大多数模型最高允许每分钟 40 次请求，不按 token 计费，仅用于原型验证。README 还列出了 OpenRouter（带免费路由模型）、Groq、Google AI Studio、Cerebras 等，以及本地运行时（LM Studio、llama.cpp、Ollama）。免费额度和限制由各提供商决定，且经常变化。

问： 在哪里下载 Claude Code？

从 Anthropic 官方获取。官方安装页列出：原生安装脚本（macOS、Linux 和 WSL 使用 curl -fsSL https://claude.ai/install.sh | bash，Windows 使用 PowerShell 命令）、Homebrew（brew install --cask claude-code）和 WinGet（winget install Anthropic.ClaudeCode）。Claude Desktop 应用也内置了 Claude Code。不要从第三方镜像下载。

问： free-claude-code 实际上使用 Claude 模型吗？

默认不使用。它把 Claude Code 的 API 调用路由到其他提供商。你得到的是 Claude Code 的界面（工具、记忆、技能），背后是另一个模型。README 还列出了 Anthropic 提供商，它使用单独计费的 Anthropic API 密钥，这是通过该代理访问真正 Claude 模型的方式。

问： free-claude-code 合法吗？是否符合 Anthropic 的条款？

该项目不会解锁 Claude 模型，也不会绕过 Anthropic 登录。它只是把请求重定向到你持有自己密钥的提供商。README 称项目是独立的，遵循各提供商的条款，并会移除不再被允许的集成（项目自述）。Anthropic 文档明确表示，不支持通过任何网关把 Claude Code 路由到非 Claude 模型，所以不要指望官方支持。用于工作代码之前，请先查看各提供商的条款。

问： free-claude-code 使用什么许可证？

AGPL-3.0-only。该仓库在 2026 年 9 月 24 日合并的 pull request（PR #1887）中，从 MIT 改为 AGPL-3.0-only。本指南早期版本写的是 MIT，对当前版本已不正确。这不是法律意见；在修改并为他人托管之前，请阅读许可证全文。

问： 我的代码质量会和真正的 Claude 一样吗？

不会。底层模型能力各不相同，许多非 Claude 模型的工具调用可靠性较低。在较长的多步骤智能体任务中，预计失败会更多。按 README 的建议选择支持工具调用的模型，并保证模型的上下文窗口足以容纳 Claude Code 的系统提示。

问： 我可以在 VSCode 扩展中使用它吗？

可以。启动 FCC，打开 Admin UI，进入 Integrations，在 Claude Code in VS Code 卡片上点击 Connect，然后重新加载 VS Code。在同一张卡片上点击 Disconnect 即可撤销。

问： 如果 NVIDIA NIM 的免费额度失效了怎么办？

换一个提供商。README 的目录列出 60 多个提供商，你还可以设置有序的备用模型（fallback），请求失败时自动换到下一个。本地运行时（LM Studio、llama.cpp、Ollama）除硬件外没有速率限制。

问： 我可以为不同的模型层级混合使用提供商吗？

可以。在 Admin UI 中把 MODEL_FABLE、MODEL_OPUS、MODEL_SONNET 和 MODEL_HAIKU 设置为带不同提供商前缀的模型，其余请求使用 MODEL 作为兜底。

问： Discord/Telegram 机器人可以使用吗？

可以，据 README 所述。在 Admin UI 的 Messaging 中配置 Discord 或 Telegram 机器人，设置允许访问的目录，就能在聊天中发送编程任务。语音消息可通过本地 Whisper 或 NVIDIA NIM 转录。它需要单独的机器人令牌（bot token）。

代理 (Proxy)：位于客户端和目标服务器之间的服务器，负责转发并可选择性地转换请求。

Harness：编程智能体中的编排层，负责管理工具调用、文件编辑、记忆、技能和子智能体 (subagents)。

FCC：free-claude-code 的简称，用于其 README 和管理界面。

管理界面 (Admin UI)：FCC 打开的浏览器页面，用于设置提供商密钥、模型路由、备用模型和集成。

NVIDIA NIM：NVIDIA 的推理微服务平台。其 build.nvidia.com 免费层有速率限制（据 NVIDIA，大多数模型最高每分钟 40 次请求），用于原型验证。

OpenRouter：一个 API 聚合器，通过单一端点提供对众多 LLM（包括部分免费模型）的访问。

SSE (Server-Sent Events)：一种通过 HTTP 从服务器向客户端流式传输数据的协议，用于流式响应。

Anthropic Messages API：Claude Code 通信所使用的 API 格式，定义了消息结构、工具使用 (tool use) 和流式传输。

OpenAI Chat Completions：许多提供商使用的另一种 API 格式。FCC 在需要时在该格式与 Anthropic 格式之间转换。

工具使用 / tool_use：结构化的块，用于指示智能体执行操作（读取文件、编辑文件、运行命令）。需要精确的格式。

备用模型 (Fallback model)：当所选模型重试后仍失败时，FCC 按顺序尝试的后备模型。

速率限制：提供商对特定时间窗口内请求次数的限制。

AGPL-3.0：GNU Affero 通用公共许可证，一种 copyleft 许可证，其约束也覆盖通过网络提供的使用。FCC 自 2026 年 9 月起使用 AGPL-3.0-only。

LM Studio：一款通过图形界面在本地运行 LLM 的桌面应用程序。

llama.cpp：一个用于在本地运行 GGUF 格式 LLM 的 C++ 库。

Ollama：一个通过简单命令在本地运行 LLM 的工具。

GGUF：一种量化 LLM 权重的文件格式，专为在消费级硬件上进行高效本地推理而设计。