Free Claude Code Skill：用自己的 API Key 免费用上 Claude Code

Free Claude Code Skill：用自己的 API Key 免费用上 Claude Code

Free Claude Code（FCC）是一个开源本地代理网关，让你无需订阅就能在终端、IDE 或手机里使用 Claude Code、Codex、Pi 等顶级 AI 编程助手。核心原理是架设本地代理服务器，接入你自己的 OpenAI/Anthropic/本地模型等 Provider，用 Admin UI 集中管理 API Key 和路由策略，一次配置搞定所有 Coding Agent 的免费调用。截至 2026-08-04，GitHub 已斩获 44k stars、7.3k forks，today 单日新增约 291 stars，正处于快速爬升期。

功能与原则

FCC 的核心能力是多 Provider 聚合 + 本地透明代理：用户不需要给每个 Agent 单独配置 API Key，所有 Agent 的请求统一经过本地 FCC 服务器，由它路由到配置的 Provider。

设计原则：
– 成本自主：用你自己的 API Key，按用量付费，没有平台抽成
– 多 Agent 统一入口：Claude Code / Codex / Pi 共用同一套配置，无需重复设置
– 本地优先：API 请求不经过第三方中转，数据和流量完全可控
– Model Picker 集成：FCC 将配置的模型暴露给各 Agent 的模型选择器，原生体验不变

认可度

• GitHub Star：44,000+（截至 2026-08-04）
• Fork：7,300+
• 今日新增 Star：约 291（当天 Trending 排名靠前）
• Contributor：41 人，另有 27 人通过 PR 参与
• 编程语言：Python 占 96.3%，意味着安装和二次开发门槛低

链接

GitHub：https://github.com/Alishahryar1/free-claude-code

原作者

GitHub Username：Alishahryar1（个人开发者，未公开实名），项目采用 MIT 许可证。

介绍

Free Claude Code 的灵感来自”为什么好用的编程 Agent 都要付月费”。作者搭建了一套本地代理架构，用户在自己的机器上运行 fcc-server，它会启动一个本地 HTTP 服务作为所有 Agent 的请求代理。

安装后，系统会在菜单栏/系统托盘出现 FCC 图标，点击”Admin UI”（默认 http://127.0.0.1:8082/admin）即可在可视化界面里配置 Provider、API Key、模型路由规则和用量策略。

支持的 Coding Agent 包括：
– Claude Code（fcc-claude 启动）
– Codex（fcc-codex 启动）
– Pi（fcc-pi 启动）

所有 Agent 都会看到 FCC 暴露的模型列表，用户在 Agent 内部的 Model Picker 中直接选择，无需记住模型名称。

特点

• 一键安装：macOS/Linux 一行 curl，Windows 一行 PowerShell，无需手动配环境
• 本地 Admin UI：图形化配置 Provider、API Key、模型路由，不用碰配置文件
• 多 Agent 共用：一次配置，Claude Code / Codex / Pi 全部生效
• 支持本地模型：除 OpenAI/Anthropic/NVIDIA NIM 外，也支持 Ollama 等本地模型
• Reasoning 控制：对支持该特性的 Provider，可开启推理控制（Reasoning Control）
• 系统托盘常驻：Windows/macOS 下 FCC 在后台运行，不占窗口，不打断工作流
• 更新机制：官方提供 fcc-update 命令，半自动升级 Agent 和 FCC 本身

使用方法

安装（macOS/Linux）：

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

安装（Windows PowerShell）：

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

启动服务器：

fcc-server

启动后在 Admin UI（http://127.0.0.1:8082/admin）配置 Provider 的 API Key。

运行 Agent：

fcc-claude        # 启动 Claude Code
fcc-codex         # 启动 Codex
fcc-pi            # 启动 Pi

使用场景与人群

• 不想付月费的开发者：自己有 API Key 余额，想把 Claude Code / Codex 当日常工具用
• 企业内网用户：代码不能出境，需要所有请求在本地或内网处理
• 多 Agent 切换用户：同时用 Claude Code 和 Codex，希望统一管理 Key 和路由
• 本地模型爱好者：用 Ollama 等本地模型跑 Coding Agent，省 GPU 成本

输入与输出案例

案例 1：配置 NVIDIA NIM 作为 Provider

用户在 Admin UI 添加 NVIDIA NIM API Key，选择 nvidia/nemotron-4-mini-hindi 等模型。配置保存后，启动 fcc-claude，在 Claude Code 的 Model Picker 里会出现 FCC 暴露的模型列表，选择后即可以 NVIDIA NIM 的价格为 Claude Code 提供推理能力。

案例 2：多 Agent 切换

用户启动 fcc-server 并在 Admin UI 配置好 Anthropic API Key。在终端 A 运行 fcc-claude，在终端 B 运行 fcc-codex，两者共用水合的 Provider 配置，无需各自单独配置 Key，实现”一键免费切换多个 Coding Agent”。

GitHub: https://github.com/Alishahryar1/free-claude-code