freecodexyz/free-code

The free build of Claude Code. All telemetry removed, security-prompt guardrails stripped, all experimental features enabled.

free-code — 精简版 Claude Code

free-code 是 Anthropic 的 Claude Code 的分支,Claude Code 是一个充当 AI 编程助手的终端程序。原始源代码在通过 Anthropic 的 npm 分发暴露后,于 2026 年 3 月公开可用。本项目获取该源代码并以三种方式修改。

三项修改

  1. 移除遥测 — 原始程序将使用数据、崩溃报告和分析发送回 Anthropic 的服务器。此构建移除或禁用了所有这些。没有任何数据回传。

  2. 移除安全提示护栏 — Anthropic 在每次对话中注入额外的系统级指令,限制 AI 在其自身内置安全训练之外的行为。此构建剥离了这些注入的限制。模型自身的安全训练仍然适用——仅移除了额外层。

  3. 解锁实验性功能 — 原始版本附带 88 个功能标志,大多数被禁用。此构建启用了所有 54 个能成功编译的标志。这些包括语音输入、深度思考模式、后台自动化触发器、内存提取等。

模型提供商

free-code 支持 五个不同的 AI 提供商,通过环境变量切换:

提供商 启用方式 认证方法
Anthropic(默认) — API 密钥或 OAuth
OpenAI Codex CLAUDE_CODE_USE_OPENAI=1 通过 OpenAI 的 OAuth
AWS Bedrock CLAUDE_CODE_USE_BEDROCK=1 AWS 凭据
Google Vertex AI CLAUDE_CODE_USE_VERTEX=1 Google Cloud 登录
Anthropic Foundry CLAUDE_CODE_USE_FOUNDRY=1 API 密钥

如何安装和使用

快速安装(一条命令):

curl -fsSL https://raw.githubusercontent.com/paoloanzn/free-code/main/install.sh | bash

这会检查您的系统,如有需要安装 Bun(JavaScript 运行时),构建项目,并将 free-code 命令添加到您的 PATH。

要求: Bun ≥ 1.3.11,macOS 或 Linux(Windows 通过 WSL),以及模型提供商的凭据。

基本用法:

free-code                    # 交互式聊天模式
free-code -p "问题"      # 单次模式:询问单个问题
free-code --model claude-opus-4-6   # 选择特定模型
free-code /login             # 登录您的提供商

从源代码构建

克隆仓库,然后:

bun build          # 生产构建
bun run build:dev:full   # 使用所有 54 个实验性标志构建

您也可以启用单个标志,例如 bun run ./scripts/build.ts --feature=ULTRAPLAN --feature=ULTRATHINK。

技术栈

  • 运行时: Bun
  • 语言: TypeScript
  • 终端 UI: React + Ink(用于终端的 React 渲染器)
  • CLI 解析: Commander.js
  • 模式验证: Zod v4
  • 协议: MCP(模型上下文协议)、LSP(语言服务器协议)
  • API: Anthropic、OpenAI Codex、AWS Bedrock、Google Vertex AI

值得注意的细节

  • IPFS 镜像: 仓库的永久副本固定在 IPFS(去中心化存储网络)上,带有内容 ID,因此即使 GitHub 仓库被下架,代码也能存活。
  • 贡献: 项目欢迎帮助恢复 34 个损坏的功能标志——许多接近编译成功,只需小修复。
  • 许可证说明: 原始 Claude Code 源代码属于 Anthropic;此分支的存在是因为源代码被公开暴露。README 说明请自行斟酌使用。

关键注意事项

  • README 明确说明移除护栏不会禁用模型自身的安全训练——它仅移除 CLI 添加的额外提示级限制。
  • 该项目是公开暴露的专有代码的分支,并非 Anthropic 官方发布。
  • README 列出了特定模型名称(例如 Claude Opus 4.6、GPT-5.3 Codex)作为支持的选项。

项目结构(高级)

  • src/entrypoints/cli.tsx — 入口点
  • src/commands.ts — 斜杠命令
  • src/tools.ts — 代理工具(Bash、Read、Edit 等)
  • src/QueryEngine.ts — LLM 查询引擎
  • src/screens/REPL.tsx — 主要交互式 UI
  • src/services/ — API 客户端、OAuth、分析
  • src/voice/ — 语音输入
  • src/bridge/ — IDE 集成(VS Code、JetBrains)

结论

free-code 是 Claude Code 的社区分支,移除了数据收集、移除了额外安全限制,并解锁了隐藏的实验性功能——同时保留了终端 AI 编程助手的核心功能,并增加了对 Anthropic 自身 API 之外的多个 AI 提供商的支持。

相关

  • 项目
  • 项目
  • 项目
  • 项目