# CC Pure — 纯净版 Claude Code

[![Bun](https://img.shields.io/badge/runtime-Bun-black?style=flat-square&logo=bun)](https://bun.sh/)
[![Build](https://img.shields.io/badge/build-passing-brightgreen?style=flat-square)]()
[![Tests](https://img.shields.io/badge/tests-3068%20pass-brightgreen?style=flat-square)]()
[![Security](https://img.shields.io/badge/CodeQL-0%20open-brightgreen?style=flat-square)]()

> Claude Code 的纯净分叉 —— 去遥测、去企业全家桶、保留核心能力。可审计、可自建、数据主权归你。

---

## ⚡ 快速开始

### 环境要求

- [Bun](https://bun.sh/) >= 1.3.11

```bash
curl -fsSL https://bun.sh/install | bash
```

### 安装

```bash
git clone https://github.com/GhostDragon124/CC_Pure.git
cd CC_Pure
bun install
bun run build          # 构建到 dist/（split build, ~560 chunks）
```

### 配置 API

```bash
# 方式一：环境变量
export ANTHROPIC_BASE_URL="https://your-api/v1"
export ANTHROPIC_API_KEY="sk-xxx"

# 方式二：REPL 内 /login 命令
bun run dev
```

### 配置本地快捷命令

```bash
# 创建 ccp 命令（一行搞定）
cat > ~/.local/bin/ccp << 'EOF'
#!/usr/bin/env bash
export PATH="$HOME/.bun/bin:$PATH"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export DISABLE_TELEMETRY=1
export NO_PROXY=localhost,127.0.0.1,.local
exec bun /path/to/CC_Pure/dist-nosplit/cli.js "$@"
EOF
chmod +x ~/.local/bin/ccp

# 使用
ccp -p "hello world"    # pipe 模式
ccp                     # 交互 REPL
```

### 验证

```bash
ccp --version           # 输出: 2.6.5 (Claude Code)
ccp -p "1+1"            # 输出: 2
```

---

## 与上游的关系

CC Pure 基于 CCB v2.6.6 反编译源码，做了以下核心变更：

### 移除的企业全家桶

| 移除项 | 原因 |
|--------|------|
| Langfuse 监控 | 企业级 Agent 监控，依赖外部 SaaS |
| Sentry 错误追踪 | 数据上报第三方 |
| Pipe IPC / LAN Pipes | 多机编排，个人使用不需要 |
| UDS_INBOX | 进程间通信管道，构建后 Node.js 环境卡死 |

### 遥测：保留源码，默认关闭，本地接管

**源码保留**（Datadog / GrowthBook / BigQuery / 1P Event Logging 全部在代码里），但通过 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` 在启动层阻断所有上游上报。

同时我们在 `logEvent()` 入口插入了**本地 JSONL sink**，所有 70+ 事件全量写入 `~/.claude/local_analytics.jsonl`。数据主权归你——你可以用自己的分析脚本查看使用统计。

```bash
# 查看今天的事件报告
python3 scripts/analyze_analytics.py

# 实时追踪
tail -f ~/.claude/local_analytics.jsonl
```

详见 → [Claude Code 的光明和阴影面（遥测系统深度分析）](docs/Claude_Code_的光明和阴影面.md)

### 保留的核心能力

| Feature | 状态 | 说明 |
|---------|:---:|------|
| BRIDGE_MODE | ✅ | WebSocket 远程控制 |
| DAEMON | ✅ | 守护进程 + 后台 worker |
| ULTRATHINK | ✅ | 扩展深度推理 |
| ACP | ✅ | 外部 Agent 协议（Zed/Cursor 兼容） |
| VOICE_MODE | ✅ | 语音输入 |
| KAIROS | ✅ | 定时任务系统 |
| PROACTIVE | ✅ | 自主代理模式 |
| COORDINATOR_MODE | ✅ | 多 worker 编排 |
| BG_SESSIONS | ✅ | 后台会话管理 |
| SSH_REMOTE | ✅ | SSH 远程连接 |

---

## 工程质量

| 指标 | CCB 基线 | CC Pure 当前 | 提升 |
|------|:--------:|:----------:|:----:|
| tsc 错误 | 62 | **0** | ✅ |
| 测试通过 | 3007 | **3068** | +61 |
| 构建 | 不稳定 | **稳定（splitting: true）** | ✅ |
| 遥测外连 | 有 | **0** | ✅ |
| CodeQL open | 175+ | **0** | ✅ |

### 安全审计（Phase 0-4，已完成）

四阶段安全审计，175 个 CodeQL 告警全量审查并关闭：

| 阶段 | 范围 | 关键修复 |
|:----:|------|----------|
| 0 | 基线建立 | 降级查询套件，过滤反编译噪音 |
| 1 | 隐私泄露 | 凭证脱敏、RCS 默认绑 127.0.0.1 |
| 2 | 结构对齐 | 删除 `src/tools/` 去重，修复 BashTool/AgentTool 回归 |
| 3 | 漏洞修复 | shell 注入、URL 解析、HTML 过滤 |
| 4 | 残余告警 | 命令注入（which）、ReDoS、净化绕过 |

**全部 175 个告警经人工审查后关闭**：误报（PKCE SHA-256、execa 数组 args）、feature-gated 代码、或预期行为。详见 [SECURITY.md](SECURITY.md)。

---

## 本地开发

```bash
bun install
bun run dev           # 开发模式（默认全 feature 开启）
bun run build         # 生产构建
bun test              # 3068 tests
```

---

## ⚠️ 免责声明

1. **本项目仅供学习研究用途。** Claude Code 的所有权利归 [Anthropic](https://www.anthropic.com/) 所有。
2. **非 CCB 官方发布。** CC Pure 是个人维护的纯净分叉，未经 CCB 团队审核或认可。
3. **不提供任何保证。** 使用本软件即表示您自行承担风险。
4. **API 使用合规。** 使用第三方 API 需遵守相应服务商条款。本项目不提供任何 API 密钥。

---

## 致谢

- [Claude Code Best](https://github.com/claude-code-best/claude-code) — 逆向工程和开源的基础
- [Anthropic](https://www.anthropic.com/) — Claude Code 原作者