# free-code

**Repository Path**: xl_wdm/free-code

## Basic Information

- **Project Name**: free-code
- **Description**: https://github.com/paoloanzn/free-code
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 18
- **Created**: 2026-04-04
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# free-code

**Claude Code 的自由构建版本。**

已移除全部遥测。已去除所有注入式安全提示护栏。已解锁全部实验性功能。单一二进制，无任何回传。

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

> 该脚本会检查你的系统、按需安装 Bun、克隆仓库、以启用全部功能的方式进行构建，并将 `free-code` 放入你的 `PATH`。之后只需执行 `export ANTHROPIC_API_KEY="sk-ant-..."`，再运行 `free-code`。

<p align="center">
  <img src="assets/screenshot.png" alt="free-code 截图" width="800" />
</p>

---

## 这是什么

这是 Anthropic [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI 的一个干净且可构建的分支版本。Claude Code 是一个原生运行于终端的 AI 编码代理。上游源码于 2026 年 3 月 31 日因 npm 分发包中的 source map 暴露而公开可见。

这个分支基于当时的源码快照，主要做了三类修改：

### 1. 移除遥测

上游二进制会通过 OpenTelemetry/gRPC、GrowthBook 分析、Sentry 错误上报以及自定义事件日志进行数据回传。在这个构建中：

- 所有对外遥测端点都已被死代码消除或替换为空实现
- GrowthBook 的功能开关评估仍可在本地运行（运行时功能门控仍然需要），但不会向外回传
- 不会上传崩溃报告、不会采集使用分析、不会进行会话指纹跟踪

### 2. 移除安全提示护栏

Anthropic 会在每次对话中注入系统级指令，用于在模型自身安全约束之外进一步限制 Claude 的行为。这些内容包括：

- 针对特定类别提示词的硬编码拒绝模式
- 注入式的“网络风险”指令块
- 由 Anthropic 服务器下发的托管设置安全覆盖层

这个构建移除了上述注入。模型自身的安全训练仍然有效，这里只是去掉了 CLI 在外层额外包裹的一层提示级限制。

### 3. 启用实验性功能

Claude Code 内置了大量通过 `bun:bundle` 编译期开关控制的功能标志。公开发布到 npm 的版本中，大多数功能默认关闭。这个构建解锁了全部 45+ 个可以正常编译的功能，包括：

| 功能 | 说明 |
|---|---|
| `ULTRAPLAN` | 在 Claude Code Web 上进行远程多代理规划（Opus 级别） |
| `ULTRATHINK` | 深度思考模式，输入 `ultrathink` 可提升推理强度 |
| `VOICE_MODE` | 按键说话语音输入与听写 |
| `AGENT_TRIGGERS` | 用于后台自动化的本地 cron/触发器工具 |
| `BRIDGE_MODE` | IDE 远程控制桥接（VS Code、JetBrains） |
| `TOKEN_BUDGET` | Token 预算跟踪与使用告警 |
| `BUILTIN_EXPLORE_PLAN_AGENTS` | 内置 explore/plan 代理预设 |
| `VERIFICATION_AGENT` | 用于任务验证的校验代理 |
| `BASH_CLASSIFIER` | 基于分类器的 Bash 权限决策 |
| `EXTRACT_MEMORIES` | 查询后自动提取记忆 |
| `HISTORY_PICKER` | 交互式提示历史选择器 |
| `MESSAGE_ACTIONS` | UI 中的消息操作入口 |
| `QUICK_SEARCH` | 提示词快速搜索 |
| `SHOT_STATS` | Shot 分布统计 |
| `COMPACTION_REMINDERS` | 围绕上下文压缩的智能提醒 |
| `CACHED_MICROCOMPACT` | 在查询流程中缓存 microcompact 状态 |

完整的 88 个功能标志审计及状态说明，请参见 [FEATURES.md](FEATURES.md)。

---

## 快速安装

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

该命令会检查你的系统、按需安装 Bun、克隆仓库、构建启用了全部实验性功能的二进制，并通过符号链接将其注册为你 `PATH` 中的 `free-code`。

安装完成后，执行：

```bash
export ANTHROPIC_API_KEY="sk-ant-..."
free-code
```

---

## 环境要求

- [Bun](https://bun.sh) >= 1.3.11
- macOS 或 Linux（Windows 可通过 WSL）
- 一个 Anthropic API Key（在环境变量中设置 `ANTHROPIC_API_KEY`）

```bash
# 如果你还没有安装 Bun
curl -fsSL https://bun.sh/install | bash
```

---

## 构建

```bash
# 克隆仓库
git clone https://github.com/paoloanzn/claude-code.git
cd claude-code

# 安装依赖
bun install

# 标准构建，生成 ./cli
bun run build

# 开发构建，带开发版本标记和实验性 GrowthBook key
bun run build:dev

# 启用全部实验性功能的开发构建，生成 ./cli-dev
bun run build:dev:full

# 编译构建（另一种输出路径），生成 ./dist/cli
bun run compile
```

### 构建变体

| 命令 | 输出 | 功能 | 说明 |
|---|---|---|---|
| `bun run build` | `./cli` | 仅 `VOICE_MODE` | 接近生产环境的二进制 |
| `bun run build:dev` | `./cli-dev` | 仅 `VOICE_MODE` | 带开发版本标记 |
| `bun run build:dev:full` | `./cli-dev` | 全部 45+ 实验性标志 | 完整解锁构建 |
| `bun run compile` | `./dist/cli` | 仅 `VOICE_MODE` | 替代输出目录 |

### 单独启用功能标志

你也可以不启用完整功能包，只打开指定标志：

```bash
# 仅启用 ultraplan 和 ultrathink
bun run ./scripts/build.ts --feature=ULTRAPLAN --feature=ULTRATHINK

# 在开发构建基础上启用指定标志
bun run ./scripts/build.ts --dev --feature=BRIDGE_MODE
```

---

## 运行

```bash
# 直接运行构建后的二进制
./cli

# 或运行开发版二进制
./cli-dev

# 或者直接从源码运行（启动更慢）
bun run dev

# 设置 API Key
export ANTHROPIC_API_KEY="sk-ant-..."

# 或使用 Claude.ai OAuth 登录
./cli /login
```

### 快速测试

```bash
# 单次执行模式
./cli -p "当前目录里有哪些文件？"

# 交互式 REPL（默认）
./cli

# 指定模型
./cli --model claude-sonnet-4-6-20250514
```

---

## 项目结构

```text
scripts/
  build.ts              # 带功能标志系统的构建脚本

src/
  entrypoints/cli.tsx   # CLI 入口
  commands.ts           # 命令注册表（slash 命令）
  tools.ts              # 工具注册表（代理工具）
  QueryEngine.ts        # LLM 查询引擎
  screens/REPL.tsx      # 主交互界面

  commands/             # /slash 命令实现
  tools/                # 代理工具实现（Bash、Read、Edit 等）
  components/           # Ink/React 终端 UI 组件
  hooks/                # React Hooks
  services/             # API 客户端、MCP、OAuth、分析相关服务
  state/                # 应用状态存储
  utils/                # 工具函数
  skills/               # 技能系统
  plugins/              # 插件系统
  bridge/               # IDE 桥接
  voice/                # 语音输入
  tasks/                # 后台任务管理
```

---

## 技术栈

| | |
|---|---|
| 运行时 | [Bun](https://bun.sh) |
| 语言 | TypeScript |
| 终端 UI | React + [Ink](https://github.com/vadimdemedes/ink) |
| CLI 解析 | [Commander.js](https://github.com/tj/commander.js) |
| Schema 校验 | Zod v4 |
| 代码搜索 | ripgrep（内置） |
| 协议 | MCP、LSP |
| API | Anthropic Messages API |

---

## IPFS 镜像

该仓库的完整副本已通过 Filecoin 永久固定到 IPFS：

- **CID:** `bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm`
- **网关地址：** https://w3s.link/ipfs/bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm

即使这个仓库被下架，代码仍然存在。

---

## 许可证

原始 Claude Code 源码归 Anthropic 所有。这个分支之所以存在，是因为源码曾通过其 npm 分发包被公开暴露。请自行判断并承担使用风险。