claude-code-best/README.md

CC Pure — 纯净版 Claude Code

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

---

⚡ 快速开始

环境要求

• Bun >= 1.3.11

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

安装

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

配置 API

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

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

配置本地快捷命令

# 创建 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

验证

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

---

与上游的关系

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

上游同步策略

持续追踪 Claude Code Best 上游更新，按安全优先原则选择性合并：

版本	日期	合并数	说明
v2.2.2	2026-06-04	16 文件	Autonomy 全量合并：f2e9af49 PR #386 源码 + 11 测试文件，3699 pass
v2.2.1	2026-06-04	2	OpenAI fixes backfill：c82f5994 (stop_reason/usage/max_tokens) + 901628b4 (MCP 工具可见性)
v2.2.0	2026-06-04	2	Batch 1a 安全加固 + ad09f38f 斜杠补全
v2.1.0	2026-06-04	2	REVIEW 24 执行完毕
v2.0.0	2026-06-04	12	P3 A 完成
v1.8.0	2026-06-04	23	P2 完成
...	2026-06	10	P0/P1 + 基础设施同步

累计：180 个候选 commit 全量审查 → ✅ 49 MERGE / 🟡 34 已存在 / ❌ 96 SKIP / ⏸️ 1 延后。 详见本地文档 ~/文档/User_manual/CC_Pure_代码分析/CC_Pure_update_record/。

移除的企业全家桶

移除项	原因
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。数据主权归你——你可以用自己的分析脚本查看使用统计。

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

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

详见 → Claude Code 的光明和阴影面（遥测系统深度分析）

保留的核心能力

Feature	状态	说明
BRIDGE_MODE	✅	WebSocket 远程控制
DAEMON	✅	守护进程 + 后台 worker
ULTRATHINK	✅	扩展深度推理
ACP	⚠️	外部 Agent 协议 — stub (fail-closed)，默认关闭
VOICE_MODE	✅	语音输入
KAIROS	✅	定时任务系统
PROACTIVE	✅	自主代理模式
COORDINATOR_MODE	✅	多 worker 编排
BG_SESSIONS	✅	后台会话管理
SSH_REMOTE	✅	SSH 远程连接

---

工程质量

指标	CCB 基线	CC Pure 当前	提升
tsc 错误	62	0	✅
测试通过	3007	3699	+692
构建	不稳定	稳定（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。

---

本地开发

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

---

⚠️ 免责声明

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

---

致谢

• Claude Code Best — 逆向工程和开源的基础
• Anthropic — Claude Code 原作者