Free Claude Code（简称 FCC）是一个开源的本地代理工具，让你免费或低成本使用 Claude Code、Codex、Pi、OpenCode 等主流 AI 编程 Agent。它把这些工具的 Anthropic Messages API 请求转发到 49 个合规的 Provider（含大量免费额度），同时保持原有客户端协议完整，无需修改 Claude Code 本身。

重要声明：独立开源项目，与 Anthropic 无关。Claude / Claude Code 是 Anthropic 的商标。免费额度由各 Provider 自行控制，可能随时变化。

1. 你能获得什么

  • 49 个 ToS 友好 Provider，每月合计约 13 亿+ 免费 token（免费 / 付费 / 订阅 / 本地模型统一管理）
  • 9 大编程 Agent 统一接入：
    • Claude Code
    • Codex
    • Pi
    • OpenCode
    • Cline
    • Hermes
    • DeepSeek Harness
    • Grok Build
    • Muse Code
  • 故障自动切换：一个 Provider 失败后自动尝试下一个配置的模型
  • 终端输出 token 大幅减少（最高约 90%）：可选 RTK 过滤 + 内置优化
  • 多端使用：终端、桌面启动器、VS Code、JetBrains、Discord、Telegram
  • 语音输入：本地 Whisper 或 NVIDIA NIM 转录，语音转代码
  • 能力完整保留：流式输出、工具调用、原生 thinking、图片输入、按模型独立路由（Opus / Sonnet / Haiku 等）

2. 快速安装

macOS / Linux

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

Windows PowerShell

1
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1")))

安装过程中会提示选择至少一个编程 Agent，以及是否安装可选的 RTK。

重新运行同一命令即可更新。

3. 启动 FCC

系统 启动方式
Windows 从桌面或开始菜单打开 Free Claude Code
macOS 从桌面或 Applications 打开 Free Claude Code
Linux 终端运行 fcc-server

启动后会自动打开 Admin UI（管理界面）。Windows / macOS 可通过托盘或菜单栏图标管理（打开 Admin、重启、退出）。Linux 需保持 fcc-server 终端窗口开启。

4. 配置 Provider（以 NVIDIA NIM 为例，推荐新手）

  1. 前往 NVIDIA API Keys 创建免费 API Key。
  2. 打开 Admin UI（启动日志中会显示地址）。
  3. 在 NVIDIA_NIM_API_KEY 处粘贴 Key。
  4. MODEL 保持默认或从下拉列表选择其他模型（例如 nvidia_nim/nvidia/nemotron-3-super-120b-a12b）。
  5. 点击 Validate → Apply。

其他常用 Provider 示例：

Provider 配置项 示例 MODEL
OpenRouter OPENROUTER_API_KEY open_router/openrouter/free
Groq GROQ_API_KEY groq/llama-3.3-70b-versatile
DeepSeek DEEPSEEK_API_KEY deepseek/deepseek-chat
Google Gemini GEMINI_API_KEY gemini/models/gemini-…
Kimi KIMI_API_KEY kimi/kimi-k2.5
LM Studio（本地） LM_STUDIO_BASE_URL lmstudio/
Ollama（本地） OLLAMA_BASE_URL ollama/
llama.cpp LLAMACPP_BASE_URL llamacpp/

支持 Fallback Models 列表：请求失败后自动按顺序尝试下一个模型。

可在 Admin UI 开启 Proxy Authentication 为本地代理增加 Bearer Token 保护。

5. 启动编程 Agent

配置完成后，直接使用专用启动器（全部走当前 Admin 设置）：

1
2
3
4
5
6
7
8
9
10
fcc-claude          # Claude Code
fcc-codex           # Codex
fcc-pi              # Pi
fcc-opencode        # OpenCode
fcc-cline           # Cline
fcc-hermes          # Hermes
fcc-dsh             # DeepSeek Harness Web
fcc-dsh --profile headless "your task"   # DeepSeek 无头模式
fcc-grok            # Grok Build
fcc-muse            # Muse Code

正常 CLI 参数仍然有效，例如：

1
fcc-codex exec "hello"

在 Agent 内部使用原生 /model 选择器即可切换 FCC 暴露的模型。

注意：

  • FCC 不会修改你原有的 Agent 设置、会话、凭证和扩展。
  • 部分 Agent（如 Hermes、DeepSeek Harness、Grok Build、Muse）有特殊会话/插件保留逻辑，详见官方 README。

6. 其他连接方式

  • VS Code / JetBrains：通过对应扩展 + 环境变量指向本地 FCC 代理。
  • Discord / Telegram：支持机器人集成，可远程使用。
  • 手机：通过 Telegram 等渠道操作。
  • 手动环境变量方式（高级）：
1
2
3
export ANTHROPIC_BASE_URL="http://localhost:8082"
export ANTHROPIC_AUTH_TOKEN="freecc"
# 然后正常运行 claude / codex 等

7. 常用管理与优化

  • Admin UI：集中管理所有 Provider、模型、Fallback、认证、日志等。
  • RTK（可选）：大幅减少终端命令输出占用的 token。
  • 语音输入：支持本地 Whisper 或 NVIDIA NIM 转录。
  • 自动故障转移：一个 Provider 不可用时无缝切换。
  • 模型独立路由：可把 Opus / Sonnet / Haiku 分别映射到不同 Provider 的兼容模型。

配置文件通常位于 ~/.config/free-claude-code/.env（安装脚本会处理）。

8. 从源码安装（开发者）

1
2
3
4
uv tool install git+https://github.com/Alishahryar1/free-claude-code.git
# 或克隆后本地开发
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code

项目使用 Python（推荐 3.14）、uv、Ruff、Pytest、Loguru 等现代工具链。

9. 注意事项与最佳实践

  1. 遵守各 Provider 服务条款，FCC 会主动移除不再合规的集成。
  2. 免费额度有限且可能变化，建议配置多个 Provider + Fallback。
  3. 本地模型（LM Studio / Ollama / llama.cpp）完全离线，适合隐私或无网络场景。
  4. 首次使用建议先从 NVIDIA NIM 或 OpenRouter 免费模型 开始验证。
  5. 生产或团队使用时建议开启 Proxy Authentication。
  6. 遇到问题优先查看 Admin UI 日志和 GitHub Issues。

10. 总结与快速上手路径

Free Claude Code 把“想用 Claude Code 等顶级 Agent，又不想/不能支付 Anthropic 官方费用”的痛点解决得非常彻底，同时保持了原生产品的完整体验。

推荐上手步骤：

  1. 运行一键安装脚本。
  2. 启动 FCC（桌面图标或 fcc-server）。
  3. 在 Admin UI 配置至少一个免费 Provider（推荐 NVIDIA NIM）。
  4. 执行 fcc-claude 或 fcc-codex 开始使用。
  5. 按需添加更多 Provider 和 Fallback，开启 RTK 与语音功能。