github/claude-code-best
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
f4a2fc542e
claude-code-best/README.md

197 lines
7.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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-3699-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, ~586 files）
```
### 配置 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 反编译源码，做了以下核心变更：
### 上游同步策略
持续追踪 [Claude Code Best](https://github.com/claude-code-best/claude-code) 上游更新，按安全优先原则选择性合并：
| 版本 | 日期 | 合并数 | 说明 |
|------|------|:------:|------|
| 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 全量审查 → ✅ 52 MERGE / 🟡 34 已存在 / ❌ 94 SKIP。
> 详见本地文档 `~/文档/User_manual/CC_Pure_代码分析/CC_Pure_update_record/`。
### 移除 / 降级的组件
| 组件 | 状态 | 说明 |
|------|:---:|------|
| Sentry 错误追踪 | 🟡 休眠 | 代码保留（`src/utils/sentry.ts`），设 `SENTRY_DSN` 即激活，支持自托管 Docker 或 sentry.io Cloud |
| Pipe IPC / LAN Pipes | ❌ 禁用 | 多机编排，个人使用不需要 |
| UDS_INBOX | ❌ 禁用 | 进程间通信管道，Node.js 环境卡死 |
| Anthropic 遥测上报 | ❌ 阻断 | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` 启动层拦截 |
| Langfuse 监控 | 🟡 休眠 | 代码保留（`src/services/langfuse/`），配 key 即激活，支持 Docker 自部署 |
| GrowthBook 远程配置 | 🟡 本地降级 | 1256 行完整客户端，远程不可用时自动使用本地静态默认值 |
### 遥测：保留源码，默认关闭，本地接管
**源码保留**（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 | 状态 | 说明 |
|------|---------|:---:|------|
| **Agent 协议** | ACP | ✅ | 外部 Agent 协议，含 bridge / permissions / session / acp-link manager |
| **浏览器** | Chrome Use | ✅ | Claude in Chrome 集成，通过浏览器扩展执行操作 |
| | Computer Use | ✅ | GUI 自动化（截图/点击/输入），`packages/@ant/computer-use-mcp/` |
| **远程控制** | BRIDGE_MODE | ✅ | Remote Control 私有部署，自托管绕过 claude.ai 订阅（`CLAUDE_BRIDGE_BASE_URL`），RCS 服务已实测可用（127.0.0.1:3000） |
| | SSH_REMOTE | ❌ | SSH 远程连接 — 反编译残留 stub，需合上游 `SSHSessionManagerImpl` 实现 |
| **自主代理** | PROACTIVE | ✅ | 主动自主代理模式，SleepTool 控制 tick 节奏 |
| | DAEMON | ✅ | 守护进程 + 后台 worker |
| | COORDINATOR_MODE | ✅ | 多 worker 编排 |
| | BG_SESSIONS | ✅ | 后台会话管理（ps/logs/attach/kill） |
| **记忆系统** | EXTRACT_MEMORIES | ✅ | /dream 记忆整理 + autoDream 自动蒸馏 |
| | AWAY_SUMMARY | ✅ | 离线摘要（用户离开后生成总结） |
| | LODESTONE | ✅ | 上下文锚点，优化长对话的相关性检索 |
| **推理增强** | ULTRATHINK | ✅ | 超深度思考模式 |
| | ULTRAPLAN | ✅ | 超级规划模式，深度分析后生成实施计划 |
| | VERIFICATION_AGENT | ✅ | 任务完成后自动验证 |
| **工具系统** | TOKEN_BUDGET | ✅ | Token 预算管理与控制 |
| | PROMPT_CACHE_BREAK_DETECTION | ✅ | Prompt cache 破裂检测 |
| **输入输出** | VOICE_MODE | ✅ | Push-to-Talk 语音输入 |
| | KAIROS_BRIEF | ✅ | 定时摘要汇报 |
| **定时任务** | KAIROS | 🟡 | 代码完整，运行时需 GrowthBook + OAuth 后端（CCP 暂无） |
| **可观测性** | Langfuse | 🟡 | 自托管 LLM 追踪（`src/services/langfuse/`），设 `LANGFUSE_PUBLIC_KEY` + `SECRET_KEY` 即激活，支持 Docker 自部署 |
| **远程配置** | GrowthBook | 🟡 | 1256 行完整客户端，远程不可用时自动降级到本地静态默认值 |
---
## 工程质量
| 指标 | 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](SECURITY.md)。
---
## 本地开发
```bash
bun install
bun run dev # 开发模式（默认全 feature 开启）
bun run build # 生产构建
bun test # 3699 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 原作者
Reference in New Issue View Git Blame Copy Permalink