@zyycn/claudex 1.0.3-fork.3767904

package/LICENSE.md

@@ -0,0 +1,5 @@
+This package is published from a fork of Anthropic Claude Code.
+
+Refer to the upstream license and usage terms before redistribution:
+- https://github.com/anthropics/claude-code/blob/main/LICENSE.md
+- https://www.anthropic.com/legal/commercial-terms

package/README.md

@@ -0,0 +1,468 @@
+# Claude Code Best V3 (CCB)
+
+牢 A (Anthropic) 官方 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI 工具的源码反编译/逆向还原项目。目标是将 Claude Code 大部分功能及工程化能力复现 (问就是老佛爷已经付过钱了)。虽然很难绷, 但是它叫做 CCB(踩踩背)...
+
+[文档在这里, 支持投稿 PR](https://ccb.agent-aura.top/)
+
+赞助商占位符
+
+- [x] v1 会完成跑通及基本的类型检查通过;
+- [x] V2 会完整实现工程化配套设施;
+  - [ ] Biome 格式化可能不会先实施, 避免代码冲突
+  - [x] 构建流水线完成, 产物 Node/Bun 都可以运行
+- [x] V3 会写大量文档, 完善文档站点
+- [ ] V4 会完成大量的测试文件, 以提高稳定性
+- [ ] V5 大规模重构石山代码, 全面模块分包
+  - [ ] V5 将会为全新分支, 届时 main 分支将会封存为历史版本
+
+> 我不知道这个项目还会存在多久, Star + Fork + git clone + .zip 包最稳健; 说白了就是扛旗项目, 看看能走多远
+>
+> 这个项目更新很快, 后台有 Opus 持续优化, 几乎几个小时就有新变化;
+>
+> Claude 已经烧了 1000$ 以上, 没钱了, 换成 GLM 继续玩;
+>
+
+存活记录:
+
+1. 开源后 48 小时: 突破 7k Star; 测试代码小有成效;
+2. 开源后 24 小时: 突破 6k Star, 感谢各位支持. 完成 docs 文档的站点构建, 达到 v3 版本, 后续开始进行测试用例维护, 完成之后可以接受 PR; 看来牢 A 是不想理我们了;
+3. 开源后 15 小时: 完成了构建产物的 node 支持, 现在是完全体了; star 快到 3k 了; 等待牢 A 的邮件
+4. 开源后 12 小时: 愚人节, star 破 1k, 并且牢 A 没有发邮件搞这个项目
+
+## 快速开始
+
+### 环境要求
+
+一定要最新版本的 bun 啊, 不然一堆奇奇怪怪的 BUG!!! bun upgrade!!!
+
+- [Bun](https://bun.sh/) >= 1.3.11
+- 常规的配置 CC 的方式, 各大提供商都有自己的配置方式
+
+### 安装
+
+```bash
+bun install
+```
+
+### 运行
+
+```bash
+# 开发模式, 看到版本号 888 说明就是对了
+bun run dev
+
+# 构建
+bun run build
+```
+
+构建采用 code splitting 多文件打包（`build.ts`），产物输出到 `dist/` 目录（入口 `dist/cli.js` + 约 450 个 chunk 文件）。
+
+构建出的版本 bun 和 node 都可以启动, 你 publish 到私有源可以直接启动
+
+### Fork 发布 / claudex 启动
+
+现在仓库额外提供了一套**低侵入 fork 发布链路**：
+
+- 配置目录：`~/.claudex`
+- 全局配置文件：`~/.claudex/.claude.json`
+
+```bash
+# 准备 npm 发布目录（默认包名 @zyycn/claudex，命令名 claudex）
+bun run release:prepare
+
+# 发布目录
+dist/npm/
+```
+
+- 发布脚本：`scripts/release/prepare-release-package.mjs`
+- 启动包装器：`scripts/release/bin/claudex.js`
+- 上游同步脚本：`scripts/sync-upstream.sh`
+- GitHub Actions：
+  - `.github/workflows/sync-upstream.yml`
+  - `.github/workflows/publish-npm.yml`
+
+可通过 GitHub Actions Variables 覆盖：
+
+- `NPM_PACKAGE_NAME`
+- `NPM_BIN_NAME`
+- `PUBLISH_REPOSITORY_URL`
+- `UPSTREAM_URL`
+- `UPSTREAM_BRANCH`
+- `TARGET_BRANCH`
+
+如果遇到 bug 请直接提一个 issues, 我们优先解决
+
+## 相关文档及网站
+
+<https://deepwiki.com/claude-code-best/claude-code>
+
+## Star History
+
+<a href="https://www.star-history.com/?repos=claude-code-best%2Fclaude-code&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/image?repos=claude-code-best/claude-code&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/image?repos=claude-code-best/claude-code&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/image?repos=claude-code-best/claude-code&type=date&legend=top-left" />
+ </picture>
+</a>
+
+## 能力清单
+
+> ✅ = 已实现  ⚠️ = 部分实现 / 条件启用  ❌ = stub / 移除 / feature flag 关闭
+
+### 核心系统
+
+| 能力 | 状态 | 说明 |
+|------|------|------|
+| REPL 交互界面（Ink 终端渲染） | ✅ | 主屏幕 5000+ 行，完整交互 |
+| API 通信 — Anthropic Direct | ✅ | 支持 API Key + OAuth |
+| API 通信 — AWS Bedrock | ✅ | 支持凭据刷新、Bearer Token |
+| API 通信 — Google Vertex | ✅ | 支持 GCP 凭据刷新 |
+| API 通信 — Azure Foundry | ✅ | 支持 API Key + Azure AD |
+| 流式对话与工具调用循环 (`query.ts`) | ✅ | 1700+ 行，含自动压缩、token 追踪 |
+| 会话引擎 (`QueryEngine.ts`) | ✅ | 1300+ 行，管理对话状态与归因 |
+| 上下文构建（git status / CLAUDE.md / memory） | ✅ | `context.ts` 完整实现 |
+| 权限系统（plan/auto/manual 模式） | ✅ | 6300+ 行，含 YOLO 分类器、路径验证、规则匹配 |
+| Hook 系统（pre/post tool use） | ✅ | 支持 settings.json 配置 |
+| 会话恢复 (`/resume`) | ✅ | 独立 ResumeConversation 屏幕 |
+| Doctor 诊断 (`/doctor`) | ✅ | 版本、API、插件、沙箱检查 |
+| 自动压缩 (compaction) | ✅ | auto-compact / micro-compact / API compact |
+
+### 工具 — 始终可用
+
+| 工具 | 状态 | 说明 |
+|------|------|------|
+| BashTool | ✅ | Shell 执行，沙箱，权限检查 |
+| FileReadTool | ✅ | 文件 / PDF / 图片 / Notebook 读取 |
+| FileEditTool | ✅ | 字符串替换式编辑 + diff 追踪 |
+| FileWriteTool | ✅ | 文件创建 / 覆写 + diff 生成 |
+| NotebookEditTool | ✅ | Jupyter Notebook 单元格编辑 |
+| AgentTool | ✅ | 子代理派生（fork / async / background / remote） |
+| WebFetchTool | ✅ | URL 抓取 → Markdown → AI 摘要 |
+| WebSearchTool | ✅ | 网页搜索 + 域名过滤 |
+| AskUserQuestionTool | ✅ | 多问题交互提示 + 预览 |
+| SendMessageTool | ✅ | 消息发送（peers / teammates / mailbox） |
+| SkillTool | ✅ | 斜杠命令 / Skill 调用 |
+| EnterPlanModeTool | ✅ | 进入计划模式 |
+| ExitPlanModeTool (V2) | ✅ | 退出计划模式 |
+| TodoWriteTool | ✅ | Todo 列表 v1 |
+| BriefTool | ✅ | 简短消息 + 附件发送 |
+| TaskOutputTool | ✅ | 后台任务输出读取 |
+| TaskStopTool | ✅ | 后台任务停止 |
+| ListMcpResourcesTool | ⚠️ | MCP 资源列表（被 specialTools 过滤，特定条件下加入） |
+| ReadMcpResourceTool | ⚠️ | MCP 资源读取（同上） |
+| SyntheticOutputTool | ⚠️ | 仅在非交互会话（SDK/pipe 模式）下创建 |
+| CronCreateTool | ✅ | 定时任务创建（已移除 AGENT_TRIGGERS gate） |
+| CronDeleteTool | ✅ | 定时任务删除 |
+| CronListTool | ✅ | 定时任务列表 |
+| EnterWorktreeTool | ✅ | 进入 Git Worktree（`isWorktreeModeEnabled()` 已硬编码为 true） |
+| ExitWorktreeTool | ✅ | 退出 Git Worktree |
+
+### 工具 — 条件启用
+
+| 工具 | 状态 | 启用条件 |
+|------|------|----------|
+| GlobTool | ✅ | 未嵌入 bfs/ugrep 时启用（默认启用） |
+| GrepTool | ✅ | 同上 |
+| TaskCreateTool | ⚠️ | `isTodoV2Enabled()` 为 true 时 |
+| TaskGetTool | ⚠️ | 同上 |
+| TaskUpdateTool | ⚠️ | 同上 |
+| TaskListTool | ⚠️ | 同上 |
+| TeamCreateTool | ⚠️ | `isAgentSwarmsEnabled()` |
+| TeamDeleteTool | ⚠️ | 同上 |
+| ToolSearchTool | ⚠️ | `isToolSearchEnabledOptimistic()` |
+| PowerShellTool | ⚠️ | Windows 平台检测 |
+| LSPTool | ⚠️ | `ENABLE_LSP_TOOL` 环境变量 |
+| ConfigTool | ❌ | `USER_TYPE === 'ant'`（永远为 false） |
+
+### 工具 — Feature Flag 关闭（全部不可用）
+
+| 工具 | Feature Flag |
+|------|-------------|
+| SleepTool | `PROACTIVE` / `KAIROS` |
+| RemoteTriggerTool | `AGENT_TRIGGERS_REMOTE` |
+| MonitorTool | `MONITOR_TOOL` |
+| SendUserFileTool | `KAIROS` |
+| OverflowTestTool | `OVERFLOW_TEST_TOOL` |
+| TerminalCaptureTool | `TERMINAL_PANEL` |
+| WebBrowserTool | `WEB_BROWSER_TOOL` |
+| SnipTool | `HISTORY_SNIP` |
+| WorkflowTool | `WORKFLOW_SCRIPTS` |
+| PushNotificationTool | `KAIROS` / `KAIROS_PUSH_NOTIFICATION` |
+| SubscribePRTool | `KAIROS_GITHUB_WEBHOOKS` |
+| ListPeersTool | `UDS_INBOX` |
+| CtxInspectTool | `CONTEXT_COLLAPSE` |
+
+### 工具 — Stub / 不可用
+
+| 工具 | 说明 |
+|------|------|
+| TungstenTool | ANT-ONLY stub |
+| REPLTool | ANT-ONLY，`isEnabled: () => false` |
+| SuggestBackgroundPRTool | ANT-ONLY，`isEnabled: () => false` |
+| VerifyPlanExecutionTool | 需 `CLAUDE_CODE_VERIFY_PLAN=true` 环境变量，且为 stub |
+| ReviewArtifactTool | stub，未注册到 tools.ts |
+| DiscoverSkillsTool | stub，未注册到 tools.ts |
+
+### 斜杠命令 — 可用
+
+| 命令 | 状态 | 说明 |
+|------|------|------|
+| `/add-dir` | ✅ | 添加目录 |
+| `/advisor` | ✅ | Advisor 配置 |
+| `/agents` | ✅ | 代理列表/管理 |
+| `/branch` | ✅ | 分支管理 |
+| `/btw` | ✅ | 快速备注 |
+| `/chrome` | ✅ | Chrome 集成 |
+| `/clear` | ✅ | 清屏 |
+| `/color` | ✅ | Agent 颜色 |
+| `/compact` | ✅ | 压缩对话 |
+| `/config` (`/settings`) | ✅ | 配置管理 |
+| `/context` | ✅ | 上下文信息 |
+| `/copy` | ✅ | 复制最后消息 |
+| `/cost` | ✅ | 会话费用 |
+| `/desktop` | ✅ | Claude Desktop 集成 |
+| `/diff` | ✅ | 显示 diff |
+| `/doctor` | ✅ | 健康检查 |
+| `/effort` | ✅ | 设置 effort 等级 |
+| `/exit` | ✅ | 退出 |
+| `/export` | ✅ | 导出对话 |
+| `/extra-usage` | ✅ | 额外用量信息 |
+| `/fast` | ✅ | 切换 fast 模式 |
+| `/feedback` | ✅ | 反馈 |
+| `/loop` | ✅ | 定时循环执行（bundled skill，可通过 `CLAUDE_CODE_DISABLE_CRON` 关闭） |
+| `/heapdump` | ✅ | Heap dump（调试） |
+| `/help` | ✅ | 帮助 |
+| `/hooks` | ✅ | Hook 管理 |
+| `/ide` | ✅ | IDE 连接 |
+| `/init` | ✅ | 初始化项目 |
+| `/install-github-app` | ✅ | 安装 GitHub App |
+| `/install-slack-app` | ✅ | 安装 Slack App |
+| `/keybindings` | ✅ | 快捷键管理 |
+| `/login` / `/logout` | ✅ | 登录 / 登出 |
+| `/mcp` | ✅ | MCP 服务管理 |
+| `/memory` | ✅ | Memory / CLAUDE.md 管理 |
+| `/mobile` | ✅ | 移动端 QR 码 |
+| `/model` | ✅ | 模型选择 |
+| `/output-style` | ✅ | 输出风格 |
+| `/passes` | ✅ | 推荐码 |
+| `/permissions` | ✅ | 权限管理 |
+| `/plan` | ✅ | 计划模式 |
+| `/plugin` | ✅ | 插件管理 |
+| `/pr-comments` | ✅ | PR 评论 |
+| `/privacy-settings` | ✅ | 隐私设置 |
+| `/rate-limit-options` | ✅ | 限速选项 |
+| `/release-notes` | ✅ | 更新日志 |
+| `/reload-plugins` | ✅ | 重载插件 |
+| `/remote-env` | ✅ | 远程环境配置 |
+| `/rename` | ✅ | 重命名会话 |
+| `/resume` | ✅ | 恢复会话 |
+| `/review` | ✅ | 代码审查（本地） |
+| `/ultrareview` | ✅ | 云端审查 |
+| `/rewind` | ✅ | 回退对话 |
+| `/sandbox-toggle` | ✅ | 切换沙箱 |
+| `/security-review` | ✅ | 安全审查 |
+| `/session` | ✅ | 会话信息 |
+| `/skills` | ✅ | Skill 管理 |
+| `/stats` | ✅ | 会话统计 |
+| `/status` | ✅ | 状态信息 |
+| `/statusline` | ✅ | 状态栏 UI |
+| `/stickers` | ✅ | 贴纸 |
+| `/tasks` | ✅ | 任务管理 |
+| `/theme` | ✅ | 终端主题 |
+| `/think-back` | ✅ | 年度回顾 |
+| `/upgrade` | ✅ | 升级 CLI |
+| `/usage` | ✅ | 用量信息 |
+| `/insights` | ✅ | 使用分析报告 |
+| `/vim` | ✅ | Vim 模式 |
+
+### 斜杠命令 — Feature Flag 关闭
+
+| 命令 | Feature Flag |
+|------|-------------|
+| `/voice` | `VOICE_MODE` |
+| `/proactive` | `PROACTIVE` / `KAIROS` |
+| `/brief` | `KAIROS` / `KAIROS_BRIEF` |
+| `/assistant` | `KAIROS` |
+| `/remote-control` (alias `rc`) | `BRIDGE_MODE` |
+| `/remote-control-server` | `DAEMON` + `BRIDGE_MODE` |
+| `/force-snip` | `HISTORY_SNIP` |
+| `/workflows` | `WORKFLOW_SCRIPTS` |
+| `/web-setup` | `CCR_REMOTE_SETUP` |
+| `/subscribe-pr` | `KAIROS_GITHUB_WEBHOOKS` |
+| `/ultraplan` | `ULTRAPLAN` |
+| `/torch` | `TORCH` |
+| `/peers` | `UDS_INBOX` |
+| `/fork` | `FORK_SUBAGENT` |
+| `/buddy` | `BUDDY` |
+
+### 斜杠命令 — ANT-ONLY（不可用）
+
+`/files` `/tag` `/backfill-sessions` `/break-cache` `/bughunter` `/commit` `/commit-push-pr` `/ctx_viz` `/good-claude` `/issue` `/init-verifiers` `/mock-limits` `/bridge-kick` `/version` `/reset-limits` `/onboarding` `/share` `/summary` `/teleport` `/ant-trace` `/perf-issue` `/env` `/oauth-refresh` `/debug-tool-call` `/agents-platform` `/autofix-pr`
+
+### CLI 子命令
+
+| 子命令 | 状态 | 说明 |
+|--------|------|------|
+| `claude`（默认） | ✅ | 主 REPL / 交互 / print 模式 |
+| `claude mcp serve/add/remove/list/get/...` | ✅ | MCP 服务管理（7 个子命令） |
+| `claude auth login/status/logout` | ✅ | 认证管理 |
+| `claude plugin validate/list/install/...` | ✅ | 插件管理（7 个子命令） |
+| `claude setup-token` | ✅ | 长效 Token 配置 |
+| `claude agents` | ✅ | 代理列表 |
+| `claude doctor` | ✅ | 健康检查 |
+| `claude update` / `upgrade` | ✅ | 自动更新 |
+| `claude install [target]` | ✅ | Native 安装 |
+| `claude server` | ❌ | `DIRECT_CONNECT` flag |
+| `claude ssh <host>` | ❌ | `SSH_REMOTE` flag |
+| `claude open <cc-url>` | ❌ | `DIRECT_CONNECT` flag |
+| `claude auto-mode` | ❌ | `TRANSCRIPT_CLASSIFIER` flag |
+| `claude remote-control` | ❌ | `BRIDGE_MODE` + `DAEMON` flag |
+| `claude assistant` | ❌ | `KAIROS` flag |
+| `claude up/rollback/log/error/export/task/completion` | ❌ | ANT-ONLY |
+
+### 服务层
+
+| 服务 | 状态 | 说明 |
+|------|------|------|
+| API 客户端 (`services/api/`) | ✅ | 3400+ 行，4 个 provider |
+| MCP (`services/mcp/`) | ✅ | 34 个文件，12000+ 行 |
+| OAuth (`services/oauth/`) | ✅ | 完整 OAuth 流程 |
+| 插件 (`services/plugins/`) | ✅ | 基础设施完整，无内置插件 |
+| LSP (`services/lsp/`) | ⚠️ | 实现存在，默认关闭 |
+| 压缩 (`services/compact/`) | ✅ | auto / micro / API 压缩 |
+| Hook 系统 (`services/tools/toolHooks.ts`) | ✅ | pre/post tool use hooks |
+| 会话记忆 (`services/SessionMemory/`) | ✅ | 会话记忆管理 |
+| 记忆提取 (`services/extractMemories/`) | ✅ | 自动记忆提取 |
+| Skill 搜索 (`services/skillSearch/`) | ✅ | 本地/远程 skill 搜索 |
+| 策略限制 (`services/policyLimits/`) | ✅ | 策略限制执行 |
+| 分析 / GrowthBook / Sentry | ⚠️ | 框架存在，实际 sink 为空 |
+| Voice (`services/voice.ts`) | ❌ | `VOICE_MODE` flag 关闭 |
+
+### 内部包 (`packages/`)
+
+| 包 | 状态 | 说明 |
+|------|------|------|
+| `color-diff-napi` | ✅ | 1006 行完整 TypeScript 实现（语法高亮 diff） |
+| `audio-capture-napi` | ✅ | 151 行完整实现（跨平台音频录制，使用 SoX/arecord） |
+| `image-processor-napi` | ✅ | 125 行完整实现（macOS 剪贴板图片读取，使用 osascript + sharp） |
+| `modifiers-napi` | ✅ | 67 行完整实现（macOS 修饰键检测，bun:ffi + CoreGraphics） |
+| `url-handler-napi` | ❌ | stub，`waitForUrlEvent()` 返回 null |
+| `@ant/claude-for-chrome-mcp` | ❌ | stub，`createServer()` 返回 null |
+| `@ant/computer-use-mcp` | ⚠️ | 类型安全 stub（265 行，完整类型定义但函数返回空值） |
+| `@ant/computer-use-input` | ✅ | 183 行完整实现（macOS 键鼠模拟，AppleScript/JXA/CGEvent） |
+| `@ant/computer-use-swift` | ✅ | 388 行完整实现（macOS 显示器/应用管理/截图，JXA/screencapture） |
+
+### Feature Flags（31 个，全部返回 `false`）
+
+`ABLATION_BASELINE` `AGENT_MEMORY_SNAPSHOT` `BG_SESSIONS` `BRIDGE_MODE` `BUDDY` `CCR_MIRROR` `CCR_REMOTE_SETUP` `CHICAGO_MCP` `COORDINATOR_MODE` `DAEMON` `DIRECT_CONNECT` `EXPERIMENTAL_SKILL_SEARCH` `FORK_SUBAGENT` `HARD_FAIL` `HISTORY_SNIP` `KAIROS` `KAIROS_BRIEF` `KAIROS_CHANNELS` `KAIROS_GITHUB_WEBHOOKS` `LODESTONE` `MCP_SKILLS` `PROACTIVE` `SSH_REMOTE` `TORCH` `TRANSCRIPT_CLASSIFIER` `UDS_INBOX` `ULTRAPLAN` `UPLOAD_USER_SETTINGS` `VOICE_MODE` `WEB_BROWSER_TOOL` `WORKFLOW_SCRIPTS`
+
+## 项目结构
+
+```
+claude-code/
+├── src/
+│   ├── entrypoints/
+│   │   ├── cli.tsx          # 入口文件（含 MACRO/feature polyfill）
+│   │   └── sdk/             # SDK 子模块 stub
+│   ├── main.tsx             # 主 CLI 逻辑（Commander 定义）
+│   └── types/
+│       ├── global.d.ts      # 全局变量/宏声明
+│       └── internal-modules.d.ts  # 内部 npm 包类型声明
+├── packages/                # Monorepo workspace 包
+│   ├── color-diff-napi/     # 完整实现（终端 color diff）
+│   ├── modifiers-napi/      # stub（macOS 修饰键检测）
+│   ├── audio-capture-napi/  # stub
+│   ├── image-processor-napi/# stub
+│   ├── url-handler-napi/    # stub
+│   └── @ant/               # Anthropic 内部包 stub
+│       ├── claude-for-chrome-mcp/
+│       ├── computer-use-mcp/
+│       ├── computer-use-input/
+│       └── computer-use-swift/
+├── scripts/                 # 自动化 stub 生成脚本
+├── build.ts                 # 构建脚本（Bun.build + code splitting + Node.js 兼容后处理）
+├── dist/                    # 构建输出（入口 cli.js + ~450 chunk 文件）
+└── package.json             # Bun workspaces monorepo 配置
+```
+
+## 技术说明
+
+### 运行时 Polyfill
+
+入口文件 `src/entrypoints/cli.tsx` 顶部注入了必要的 polyfill：
+
+- `feature()` — 所有 feature flag 返回 `false`，跳过未实现分支
+- `globalThis.MACRO` — 模拟构建时宏注入（VERSION 等）
+
+### Monorepo
+
+项目采用 Bun workspaces 管理内部包。原先手工放在 `node_modules/` 下的 stub 已统一迁入 `packages/`，通过 `workspace:*` 解析。
+
+## Feature Flags 详解
+
+原版 Claude Code 通过 `bun:bundle` 的 `feature()` 在构建时注入 feature flag，由 GrowthBook 等 A/B 实验平台控制灰度发布。本项目中 `feature()` 被 polyfill 为始终返回 `false`，因此以下 30 个 flag 全部关闭。
+
+### 自主 Agent
+
+| Flag | 用途 |
+|------|------|
+| `KAIROS` | Assistant 模式 — 长期运行的自主 Agent（含 brief、push 通知、文件发送） |
+| `KAIROS_BRIEF` | Kairos Brief — 向用户发送简报摘要 |
+| `KAIROS_CHANNELS` | Kairos 频道 — 多频道通信 |
+| `KAIROS_GITHUB_WEBHOOKS` | GitHub Webhook 订阅 — PR 事件实时推送给 Agent |
+| `PROACTIVE` | 主动模式 — Agent 主动执行任务，含 SleepTool 定时唤醒 |
+| `COORDINATOR_MODE` | 协调器模式 — 多 Agent 编排调度 |
+| `BUDDY` | Buddy 配对编程功能 |
+| `FORK_SUBAGENT` | Fork 子代理 — 从当前会话分叉出独立子代理 |
+
+### 远程 / 分布式
+
+| Flag | 用途 |
+|------|------|
+| `BRIDGE_MODE` | 远程控制桥接 — 允许外部客户端远程操控 Claude Code |
+| `DAEMON` | 守护进程 — 后台常驻服务，支持 worker 和 supervisor |
+| `BG_SESSIONS` | 后台会话 — `ps`/`logs`/`attach`/`kill`/`--bg` 等后台进程管理 |
+| `SSH_REMOTE` | SSH 远程 — `claude ssh <host>` 连接远程主机 |
+| `DIRECT_CONNECT` | 直连模式 — `cc://` URL 协议、server 命令、`open` 命令 |
+| `CCR_REMOTE_SETUP` | 网页端远程配置 — 通过浏览器配置 Claude Code |
+| `CCR_MIRROR` | Claude Code Runtime 镜像 — 会话状态同步/复制 |
+
+### 通信
+
+| Flag | 用途 |
+|------|------|
+| `UDS_INBOX` | Unix Domain Socket 收件箱 — Agent 间本地通信（`/peers`） |
+
+### 增强工具
+
+| Flag | 用途 |
+|------|------|
+| `CHICAGO_MCP` | Computer Use MCP — 计算机操作（屏幕截图、鼠标键盘控制） |
+| `WEB_BROWSER_TOOL` | 网页浏览器工具 — 在终端内嵌浏览器交互 |
+| `VOICE_MODE` | 语音模式 — 语音输入输出，麦克风 push-to-talk |
+| `WORKFLOW_SCRIPTS` | 工作流脚本 — 用户自定义自动化工作流 |
+| `MCP_SKILLS` | 基于 MCP 的 Skill 加载机制 |
+
+### 对话管理
+
+| Flag | 用途 |
+|------|------|
+| `HISTORY_SNIP` | 历史裁剪 — 手动裁剪对话历史中的片段（`/force-snip`） |
+| `ULTRAPLAN` | 超级计划 — 远程 Agent 协作的大规模规划功能 |
+| `AGENT_MEMORY_SNAPSHOT` | Agent 运行时的记忆快照功能 |
+
+### 基础设施 / 实验
+
+| Flag | 用途 |
+|------|------|
+| `ABLATION_BASELINE` | 科学实验 — 基线消融测试，用于 A/B 实验对照组 |
+| `HARD_FAIL` | 硬失败模式 — 遇错直接中断而非降级 |
+| `TRANSCRIPT_CLASSIFIER` | 对话分类器 — `auto-mode` 命令，自动分析和分类对话记录 |
+| `UPLOAD_USER_SETTINGS` | 设置同步上传 — 将本地配置同步到云端 |
+| `LODESTONE` | 深度链接协议处理器 — 从外部应用跳转到 Claude Code 指定位置 |
+| `EXPERIMENTAL_SKILL_SEARCH` | 实验性 Skill 搜索索引 |
+| `TORCH` | Torch 功能（具体用途未知，可能是某种高亮/追踪机制） |
+
+## 许可证
+
+本项目仅供学习研究用途。Claude Code 的所有权利归 [Anthropic](https://www.anthropic.com/) 所有。

package/bin/claudex.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+
+import { spawnSync } from 'node:child_process'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { readFileSync } from 'node:fs'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const packageRoot = join(here, '..')
+const entrypoint = join(packageRoot, 'dist', 'cli.js')
+const packageName = getPackageName()
+
+const result = spawnSync(process.execPath, [entrypoint, ...process.argv.slice(2)], {
+  cwd: process.cwd(),
+  stdio: 'inherit',
+  env: {
+    ...process.env,
+    CLAUDE_CODE_BIN_NAME: 'claudex',
+    CLAUDE_CODE_PACKAGE_NAME: packageName,
+    CLAUDE_CODE_FORCE_FULL_LOGO:
+      process.env.CLAUDE_CODE_FORCE_FULL_LOGO ?? '1',
+  },
+})
+
+if (result.error) {
+  console.error(result.error.message)
+  process.exit(1)
+}
+
+process.exit(result.status ?? 1)
+
+function getPackageName() {
+  try {
+    const pkg = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))
+    if (typeof pkg?.name === 'string' && pkg.name.trim()) {
+      return pkg.name.trim()
+    }
+  } catch {}
+  return '@zyycn/claudex'
+}