1. 项目定位与用途
free-code 是 Anthropic 官方 Claude Code CLI 的独立分叉版本，定位为隐私优先、功能完整的终端原生 AI 编程代理。它面向对数据隐私有严格要求、需要完整实验功能、或希望绕过 Anthropic 额外安全限制的开发者群体。项目核心用途是在终端环境中提供智能代码生成、项目导航、调试辅助和自动化任务执行能力，同时确保所有交互数据不离开本地机器。
项目档案命令行工具
free-code：无遥测版 Claude Code CLI，解锁全部实验功能，支持五大模型提供商
paoloanzn/free-code：free-code 是 Claude Code CLI 的隐私增强分叉版本，移除所有遥测与安全限制，解锁 54 项实验功能，支持五大模型提供商，本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
free-code 是 Claude Code CLI 的隐私增强分叉版本，移除所有遥测与安全限制，解锁 54 项实验功能，支持五大模型提供商，提供完全本地的 AI 编程代理体验。
中文项目介绍
free-code 是一个基于 Anthropic Claude Code 的修改版终端 AI 编程代理。
该项目从原始源码快照出发，进行了三类核心改造：彻底移除所有遥测数据收集（包括 OpenTelemetry、Sentry、GrowthBook 上报），剥离 Anthropic 注入的系统级安全提示防护层，并解锁全部可编译的 54 个实验性功能标志。
技术层面，它基于 Bun 1.3.11+ 运行时构建，采用 TypeScript 与 React JSX 开发终端 UI，通过模块化桥接层抽象多提供商 API 通信。项目支持 Anthropic、OpenAI Codex、AWS Bedrock、Google Vertex AI 和 Azure 五种模型后端，通过环境变量即可切换。
构建系统提供开发、编译和完整实验特性三种变体，最终产出单个可执行二进制文件，实现零回调、完全离线的 AI 编码助手。
详细信息与使用说明
2. 解决的问题
原版 Claude Code 存在三个主要限制：持续收集使用遥测与错误报告（通过 OpenTelemetry/gRPC、Sentry、GrowthBook）；在模型层面之外额外注入系统级安全提示与限制；以及通过 88 个特性标志控制实验功能，但公开版本仅开放少数。free-code 通过死代码消除与桩实现移除所有出站遥测，剥离安全防护注入层，并解锁 54 个可正常编译的实验特性，从而解决隐私泄露、功能受限和过度约束三大问题。
3. 适用场景
适用场景包括：企业内网或敏感代码库中的 AI 辅助开发，避免任何外部数据泄露；需要完整实验功能集进行前沿开发与测试的团队；多云环境下的灵活模型选择，通过单一 CLI 切换 Anthropic、OpenAI Codex、AWS Bedrock、Google Vertex AI 或 Azure 后端；以及追求最小化运行时依赖、偏好单体二进制部署的 DevOps 实践。项目不适用于需要 Anthropic 官方安全护栏或合规遥测的企业场景。
4. 安装方式
仓库提供一键安装脚本，自动完成环境检测、依赖安装、构建与部署。具体步骤：运行 curl -fsSL https://raw.githubusercontent.com/paoloanzn/free-code/main/install.sh | bash，脚本会检查系统、按需安装 Bun 运行时、克隆仓库、以完整实验特性集构建项目，并在 PATH 中创建 free-code 符号链接。项目要求 Bun 版本 >= 1.3.11，也可手动执行 bun run ./scripts/build.ts 进行构建，或使用 bun run src/entrypoints/cli.tsx 直接开发运行。仓库中未明确给出 Windows 或非 Unix 系统的安装说明。
5. 使用方式
安装后执行 free-code 命令启动 CLI。首次运行需使用 /login 命令完成身份验证，选择并配置偏好的模型提供商。切换提供商通过环境变量控制：CLAUDE_CODE_USE_OPENAI=1 启用 OpenAI Codex，CLAUDE_CODE_USE_BEDROCK=1 配合 AWS_REGION 使用 AWS Bedrock，其他提供商类似。CLI 内置丰富命令，如 /add-dir 添加工作目录、/commit 生成提交信息、/branch 管理分支、/agents 配置代理等，所有命令在 src/commands 目录中以延迟加载 JSX 模块形式实现。仓库中未明确给出所有命令的完整列表与参数说明。
6. 补充说明与实现特点
项目技术栈以 Bun 为核心，使用 TypeScript 6.0.2 编译，React JSX 构建终端 UI。架构上，cli 模块负责入口与命令路由，commands 目录采用 type: 'local-jsx' 实现按需加载，bridge 层抽象多提供商通信并集成 GrowthBook 特性开关，services 提供认证、OAuth 和 API 客户端。构建系统通过 scripts/build.ts 支持 --dev 和 --feature-set=dev-full 参数控制特性集。FEATURES.md 文档审计了 54 个可启用实验特性。IPFS 镜像已配置但具体访问方式未在 README 详述。项目当前因上游所有权迁移处于阻塞状态，但代码库完整可构建。
思维导图
free-code
核心改造
遥测移除
安全护栏剥离
实验功能解锁(54个)
技术栈
Bun 1.3.11+
TypeScript + React JSX
模块化命令系统
多提供商桥接层
模型支持
Anthropic (默认)
OpenAI Codex
AWS Bedrock
Google Vertex AI
Azure
构建与部署
一键安装脚本
build:dev 开发模式
compile 生产编译
build:dev:full 完整实验特性
关键模块
src/cli (入口)
src/commands (命令集)
src/bridge (API桥接)
src/assistant (会话管理)
src/buddy (UI组件)
常见问题
free-code 与原版 Claude Code 的主要区别是什么？
主要区别有三点：一是移除所有遥测数据收集（OpenTelemetry、Sentry、GrowthBook 等），确保零回调；二是剥离 Anthropic 注入的系统级安全提示防护层，仅保留模型自身安全训练；三是解锁 54 个可编译的实验性功能标志，提供更完整的功能集。
如何切换不同的 AI 模型提供商？
通过设置环境变量切换，无需修改代码。例如：export CLAUDE_CODE_USE_OPENAI=1 启用 OpenAI Codex，export CLAUDE_CODE_USE_BEDROCK=1 配合 AWS_REGION 使用 AWS Bedrock。其他提供商（Anthropic 默认、Google Vertex AI、Azure）均有对应环境变量，详见 README 的 Model Providers 章节。
安装是否需要手动配置 Bun 运行时？
不需要。官方提供的一键安装脚本（curl -fsSL https://raw.githubusercontent.com/paoloanzn/free-code/main/install.sh | bash）会自动检测系统环境，如果缺少 Bun 运行时则会自动安装，随后克隆仓库、构建项目并创建 free-code 符号链接到 PATH。
项目当前状态如何？是否可正常使用？
根据仓库原始描述，上游仓库因所有权迁移操作而暂时阻塞，但本仓库代码完整可构建。所有核心功能（多提供商支持、实验特性、命令系统）均在代码库中实现，安装脚本和构建流程均可正常运行。IPFS 镜像已配置但访问方式未在 README 明确说明。
是否可以在 Windows 系统上使用？
仓库中未明确给出 Windows 系统的安装说明。一键安装脚本和 Bun 运行时主要面向 Unix-like 系统设计，Windows 用户可能需要手动安装 Bun、克隆仓库并执行构建命令，但兼容性未在文档中验证。