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 月公开可用。本项目获取该源代码并以三种方式修改。
三项修改
移除遥测 — 原始程序将使用数据、崩溃报告和分析发送回 Anthropic 的服务器。此构建移除或禁用了所有这些。没有任何数据回传。
移除安全提示护栏 — Anthropic 在每次对话中注入额外的系统级指令,限制 AI 在其自身内置安全训练之外的行为。此构建剥离了这些注入的限制。模型自身的安全训练仍然适用——仅移除了额外层。
解锁实验性功能 — 原始版本附带 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— 主要交互式 UIsrc/services/— API 客户端、OAuth、分析src/voice/— 语音输入src/bridge/— IDE 集成(VS Code、JetBrains)
结论
free-code 是 Claude Code 的社区分支,移除了数据收集、移除了额外安全限制,并解锁了隐藏的实验性功能——同时保留了终端 AI 编程助手的核心功能,并增加了对 Anthropic 自身 API 之外的多个 AI 提供商的支持。
相关
- 项目
- 项目
- 项目
- 项目