企业官网建设流程全解析

Free Claude Code开发环境搭建：uv + Python 3.14从零跑通源码

【免费下载链接】free-claude-codeUse Claude Code, Codex, Pi, and OpenCode and more for free (1.3B+ free tokens) from your terminal, app, IDE, or phone like OpenClaw (voice supported + ToS friendly)项目地址: https://gitcode.com/GitHub_Trending/fr/free-claude-code

Free Claude Code（FCC）是一个本地 AI 代理网关：它在你的机器上运行一个轻量服务，把 Claude Code、Codex、Pi、OpenCode 等 10 个编程智能体免费接入 50 多个 ToS 友好的 AI 提供商，每月可白嫖 1.3B+ token，支持终端、桌面应用、IDE 和手机。本文是一份面向新手的 Free Claude Code 开发环境搭建指南，用 uv + Python 3.14 从零克隆源码、启动fcc-server、配置提供商，并跑通第一个免费模型——全程只需要几条命令。

📦 为什么推荐用 uv 搭建 Free Claude Code 开发环境？

这个项目的工程约定非常"现代"，pyproject.toml 明确要求requires-python >= 3.14.0，同时要求 uv ≥ 0.11.16（见 pyproject.toml 的tool.uv配置）。

uv 是 Rust 编写的极速 Python 包管理器，它把"装 Python 解释器、建虚拟环境、装依赖"三件事合成一条命令，而且项目根目录的 .python-version 文件已固定为3.14.0——uv 会自动读取，无需手动切换版本。项目官方贡献指南 CONTRIBUTING.md 也明确强调：所有 Python 命令都用uv run执行，不要用全局 Python 解释器。

第 1 步：安装 uv（最快的 Python 环境工具）

macOS / Linux 在终端执行：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows PowerShell 执行：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

装完后验证一下：

uv --version # 需 >= 0.11.16

💡 如果版本偏低，重新执行一遍安装命令即可自动升级。

第 2 步：克隆 Free Claude Code 源码并安装 Python 3.14

git clone https://gitcode.com/GitHub_Trending/fr/free-claude-code cd free-claude-code uv python install 3.14.0

三步分别做了三件事：

此时 uv 已经根据 uv.lock 锁定的依赖清单准备好一切，首次uv run时会自动创建虚拟环境并安装 FastAPI、Uvicorn、httpx、Loguru 等运行依赖（完整清单见 pyproject.toml）。

第 3 步：一条命令启动 fcc-server 🚀

uv run fcc-server

启动成功后，FCC 会打印一个 Admin UI 的本地地址并自动打开浏览器。入口实现位于 src/free_claude_code/cli/entrypoints.py，服务框架由 src/free_claude_code/api/app.py 的 FastAPI 应用承载。

服务跑起来后，配合编程智能体的实际效果就是下图这样——Claude Code 正在通过 FCC 网关调用免费模型执行多智能体代码分析：

第 4 步：在 Admin UI 配置免费 AI 提供商

打开服务日志里打印的 Admin UI 地址，你会看到 Providers 页面：

以免费提供商为例，三步完成配置：

1. 到提供商官网创建一个 API Key（例如 NVIDIA NIM、OpenRouter 都有免费额度）；
2. 在 Admin UI 对应卡片点击Configure，粘贴 Key（如NVIDIA_NIM_API_KEY）；
3. 在Model Config的MODEL下拉框里搜索并选择一个模型，点击Apply。

所有可用环境变量都有注释模板，可直接参考 .env.example。配置会持久化到~/.fcc/.env，无需手动维护。

🔑 小技巧：在 Model Config 下可以添加Fallback Models列表，当主提供商故障时 FCC 会自动切换到下一个模型，对话不会中断。

第 5 步：连接编程智能体，跑通第一个模型

保持fcc-server运行，另开一个终端：

# Claude Code 用户 uv run fcc-claude # Codex 用户 uv run fcc-codex

fcc-claude、fcc-codex、fcc-pi等 10 个命令都在 pyproject.toml 中定义，各自启动对应智能体并自动指向 FCC 本地网关。

进入 Claude Code 后输入/model，就能在原生模型选择器里看到 FCC 注入的全部免费模型：

至此，Free Claude Code 开发环境搭建完成——源码已跑通，智能体正在使用免费 token 为你写代码。

加分项：运行本地 CI 质量检查 ✅

如果你想深入阅读源码或提交贡献，项目提供了与 GitHub CI 完全对齐的本地检查脚本 scripts/ci.sh，按顺序执行 6 项检查：类型抑制扫描 → Ruff 格式化 → Ruff 静态检查 → ty 类型检查 → pytest 全量测试 → Playwright 浏览器测试。

# 一键跑完全部检查 ./scripts/ci.sh # 开发时常用：只跑测试 / 跳过慢项 ./scripts/ci.sh --only pytest ./scripts/ci.sh --skip playwright --dry-run

单独调试时也可以直接执行（Windows 用 scripts/ci.ps1）：

uv run pytest -v --tb=short uv run ruff format uv run ty check

⚠️ 项目规范（见 CLAUDE.md）：禁止添加# type: ignore和from __future__ import annotations，请直接修复类型问题。

📚 关键文件路径速查

总结

搭建 Free Claude Code 开发环境的核心链路只有 5 条命令：

1. 安装 uv；
2. git clone克隆源码；
3. uv python install 3.14.0安装解释器；
4. uv run fcc-server启动本地网关；
5. uv run fcc-claude接入编程智能体，开始免费写代码。

整个过程无需 Docker、无需手动建虚拟环境，uv 全程托管。跑通之后，建议顺手浏览 ARCHITECTURE.md 了解各模块边界，为后续二次开发打下基础。

【免费下载链接】free-claude-codeUse Claude Code, Codex, Pi, and OpenCode and more for free (1.3B+ free tokens) from your terminal, app, IDE, or phone like OpenClaw (voice supported + ToS friendly)项目地址: https://gitcode.com/GitHub_Trending/fr/free-claude-code