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

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-codeFree Claude CodeFCC是一个本地 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 | shWindows PowerShell 执行powershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iex装完后验证一下uv --version # 需 0.11.16 如果版本偏低重新执行一遍安装命令即可自动升级。第 2 步克隆 Free Claude Code 源码并安装 Python 3.14git clone https://gitcode.com/GitHub_Trending/fr/free-claude-code cd free-claude-code uv python install 3.14.0三步分别做了三件事命令作用git clone拉取 Free Claude Code 完整源码cd进入项目根目录uv会自动识别项目uv python install 3.14.0下载并缓存 Python 3.14.0 解释器不污染系统 Python此时 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 页面以免费提供商为例三步完成配置到提供商官网创建一个 API Key例如 NVIDIA NIM、OpenRouter 都有免费额度在 Admin UI 对应卡片点击Configure粘贴 Key如NVIDIA_NIM_API_KEY在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-codexfcc-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.ps1uv run pytest -v --tbshort uv run ruff format uv run ty check⚠️ 项目规范见 CLAUDE.md禁止添加# type: ignore和from __future__ import annotations请直接修复类型问题。 关键文件路径速查文件说明pyproject.toml依赖、CLI 命令入口、Python 3.14 要求CONTRIBUTING.md官方开发环境搭建与质量检查说明.env.example全部提供商 API Key 环境变量模板scripts/ci.sh / scripts/ci.ps1本地一键 CI跨平台src/free_claude_code/api/app.pyFastAPI 应用主入口src/free_claude_code/cli/entrypoints.pyfcc-server启动逻辑src/free_claude_code/providers/50 提供商适配层源码ARCHITECTURE.md完整架构设计与扩展指南总结搭建 Free Claude Code 开发环境的核心链路只有 5 条命令安装 uvgit clone克隆源码uv python install 3.14.0安装解释器uv run fcc-server启动本地网关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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考