mirror of
https://github.com/claude-code-best/claude-code.git
synced 2026-06-23 16:55:51 +00:00
cd222b8e65
* fix: 终端内容溢出 viewport 时的重影 bug 主屏幕模式下 frame 持续溢出 viewport 时，cursor-restore LF 把内容滚入 scrollback 导致相对光标追踪漂移，可见区 diff 落到错误行产生重影（重复 banner / 错位）。 扩展 log-update overflow 分支为无条件 fullReset（含 \x1b[3J 清 scrollback）， 并将主屏 self-healing 清屏从 ERASE_SCREEN (CSI 2 J) 换成 ERASE_DOWN (CSI J)， 避免 xterm.js / VSCode 集成终端的 scrollback 边界副作用。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 删除 3 个孤立诊断脚本 - scripts/verify-autofix-pr.ts: 一次性 autofix-pr 验证脚本，全仓零引用 - scripts/smoke-test-commands.ts: 开发期冒烟测试脚本，无任何 import - scripts/probe-subscription-endpoints.ts: 手动 endpoint 探针，无引用 均不在 package.json scripts、build.ts、vite.config.ts、CI workflows 中。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 self-hosted-runner stub 及其 cli.tsx fast-path - 删除 src/self-hosted-runner/main.ts（自动生成的 Promise.resolve() stub） - 同步移除 src/entrypoints/cli.tsx 中 feature('SELF_HOSTED_RUNNER') 守卫的 fast-path 分支 - 该 flag 不在 build.ts DEFAULT_BUILD_FEATURES 也不在 dev 默认列表，所有默认配置下整段为构建期死代码 删除 stub 单独会留下未解析的动态 import，必须协同拆除。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 删除 agentSdkTypes 中三个 not-implemented stub 移除 watchScheduledTasks、buildMissedTaskNotification、connectRemoteControl 三个 stub 函数（函数体仅 throw new Error('not implemented')），以及仅被这些 stub 引用的孤儿类型（ScheduledTasksHandle、ConnectRemoteControlOptions、RemoteControlHandle、InboundPrompt 等）。 全仓零外部引用。buildMissedTaskNotification 在 src/utils/cronScheduler.ts 有真实可用实现，未受影响。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 Cursor.ts 中未引用的 kill ring 访问器 - 删除 getKillRingItem、getKillRingSize、clearKillRing、canYankPop（全仓零引用的独立 export） - 移除 VIM_WORD_CHAR_REGEX 的 export 关键字（仍由 isVimWordChar 内部使用，保留常量本体） kill ring 特性本身仍活跃（getLastKill/pushToKillRing/yankPop 在 useSearchInput/useTextInput 使用），仅这几个孤儿 helper 未接入。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 insights.ts 中未引用的导出 - 删除 deduplicateSessionBranches（全仓零调用，含 JSDoc） - 删除 buildExportData（全仓零调用，原 S3 上传路径实际用 HTML 而非 JSON） - InsightsExport 仅移除 export 关键字（保留类型本体，仍作为内部返回类型） Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 autonomyCommandSpec.ts 中未引用的导出 - 删除 AUTONOMY_CLI（CLI 子命令描述对象，零引用；handler 仅用 AUTONOMY_USAGE） - 删除 AUTONOMY_COMMAND_DESCRIPTION（值已在 main.tsx:5181 内联） - ParsedAutonomyCommand 仅移除 export 关键字（保留类型作为 parseAutonomyArgs 返回类型） Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 binaryCheck/claudeAiLimits/codeIndexing 中未引用的导出 - binaryCheck.ts: 删除 clearBinaryCache（零调用，binaryCache 仍由 isBinaryInstalled 使用） - claudeAiLimits.ts: 删除 RATE_LIMIT_DISPLAY_NAMES 常量 + getRateLimitDisplayName（互为唯一消费者） - codeIndexing.ts: 删除 detectCodeIndexingFromMcpTool（同胞 detectCodeIndexingFromCommand/McpServerName 仍活跃） Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除多处仅内部使用的 export 关键字 下列符号均仅在本文件内被引用，export 关键字冗余；保留符号本体不动： - internalLogging.ts: getContainerId（line 88 内部调用） - api/errors.ts: isMediaSizeError（line 151 内部调用） - api/withRetry.ts: parseMaxTokensContextOverflowError（line 389/724 内部调用） - statsCache.ts: STATS_CACHE_VERSION（7 处内部使用） - startupProfiler.ts: logStartupPerf（line 128 内部调用） - bashCommandHelpers.ts: CommandIdentityCheckers（3 处内部参数类型） Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 清理注释代码块与 legacy shim 注释代码（已死的、引用不存在符号的注释块）： - Onboarding.tsx: 注释化的 preflight if-block（引用不存在的 preflightStep） - ultraplan.tsx: 两处引用不存在符号的注释（ULTRAPLAN_INSTRUCTIONS、getUltraplanModel） - types/hooks.ts: 禁用的 type-fest IsEqual 类型断言块 - types/global.d.ts: 已被真实模块取代的 Ultraplan ambient declares - types/textInputTypes.ts: 注释化的 onMessage interface 成员 legacy shim： - cli/bg.ts: 删除 handleBgFlag 别名 export（同胞 handleBgStart 已被所有调用点使用） Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 ccshareResume stub 及 main.tsx 的 ccshare fast-path - 删除 src/utils/ccshareResume.ts（parseCcshareId 恒返回 null、loadCcshare 恒抛错的 stub） - 同步移除 src/main.tsx 中 USER_TYPE === 'ant' 守卫下的 if (ccshareId) {...} else {...} 双分支 - 提升 else 块（文件路径 resume 处理）为直接进入 if (options.resume) 块内 ccshare 是 Anthropic 内部特性（go/ccshare URL），stub 未实现导致 ccshareId 恒为 null，整个 ccshare 分支永不进入；保留的文件路径 resume 路径不变。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 environment-runner stub 及其 cli.tsx fast-path 与 self-hosted-runner 相同模式的 sibling（工作流 1 verifier 建议同步处理）： - 删除 src/environment-runner/main.ts（自动生成的 Promise.resolve() stub） - 同步移除 src/entrypoints/cli.tsx 中 feature('BYOC_ENVIRONMENT_RUNNER') 守卫的 fast-path 分支 - 清理两个空目录（src/self-hosted-runner/、src/environment-runner/） BYOC_ENVIRONMENT_RUNNER flag 不在 build.ts DEFAULT_BUILD_FEATURES 也不在 dev 默认列表，所有默认配置下整段为构建期死代码。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 删除孤立诊断脚本 probe-local-wiring.ts #!/usr/bin/env bun shebang 的手动诊断脚本，全仓零引用，不在 package.json/build.ts/vite.config.ts/CI workflows 中。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 ultrareview preflight stub 及其测试 - 删除 src/services/api/ultrareviewPreflight.ts（自动生成的 stub） - 删除 src/commands/review/UltrareviewPreflightDialog.tsx（依赖前者的 UI stub） - 删除 src/services/api/__tests__/ultrareviewPreflight.test.ts（测试已删代码） - 同步移除 ultrareviewCommand.test.tsx 中对 UltrareviewPreflightDialog 的 mock Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 cachedMCConfig stub 及 prompts.ts 的 CACHED_MICROCOMPACT 死代码 - 删除 src/services/compact/cachedMCConfig.ts（自动生成的 stub） - 同步移除 src/constants/prompts.ts 中依赖该 stub 的代码： - getCachedMCConfigForFRC 变量（feature('CACHED_MICROCOMPACT') 守卫的 require） - getFunctionResultClearingSection 函数（约 18 行） - systemPrompt 数组中的 frc section 调用与注册 CACHED_MICROCOMPACT 不在 build.ts DEFAULT_BUILD_FEATURES 也不在 dev 默认列表，所有默认配置下整段为构建期死代码。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 goalAudit stub 及其测试引用 - 删除 src/services/goal/goalAudit.ts（导出 COMPLETION_AUDIT_RULES/BLOCKED_AUDIT_RULES/isGoalTerminal 等未引用的 stub） - 同步移除 tests/integration/goal-lifecycle.test.ts 中对 goalAudit 的 import 和一个测试用例（budget_limited is terminal） Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 删除 agentSdkTypes 第二批 not-implemented stub 移除运行时函数体仅为 throw new Error 或 placeholder 的 stub： - createSdkMcpToolDefinition、createSdkMcpServer - query 函数重载与实现 - unstable_v2_* 系列函数 - session 操作 stub（getSessionMessages/listSessions/getSessionInfo/renameSession/tagSession/forkSession） - AbortError 类 保留所有 export type 重导出和类型别名（仍是公共类型面）。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 Tool.ts 中 backwards-compat 重导出 shim 删除 "// Re-export progress types for backwards compatibility" 注释块及其重导出语句。所有消费方已直接从 src/types/tools.js 导入，无需重导出转发。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 bootstrap/state.ts 中 4 个未引用的 export - clearRegisteredHooks（STATE.registeredHooks 仍由其他函数管理） - getInvokedSkills（getInvokedSkillsForAgent 是活跃入口） - getSessionSource（setSessionSource 仍活跃，sessionSource state 字段保留） - markScrollActivity（scrollDraining/getIsScrollDraining/waitForScrollDrain 仍活跃） 仅删除孤儿访问器，不动模块级 state 副作用。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 src/ 下多处未引用的导出 涉及 18 个文件，每处均为独立的 unreferenced export 删除或 export 关键字冗余移除： - bridge/bridgeStatusUtil.ts、components/TrustDialog/utils.ts、context/stats.tsx - keybindings/loadUserBindings.ts、memdir/paths.ts、remote/sdkMessageAdapter.ts - services/acp/utils.ts（删除 nodeToWebReadable，全仓零引用） - services/api/metricsOptOut.ts、services/lsp/LSPDiagnosticRegistry.ts、services/lsp/manager.ts - services/mcp/utils.ts、services/skillLearning/projectContext.ts - services/teamMemorySync/secretScanner.ts、services/teamMemorySync/watcher.ts - skills/loadSkillsDir.ts、utils/attachments.ts、utils/filePersistence/filePersistence.ts - utils/messageQueueManager.ts Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * chore: 移除 packages/ 下多处未引用的导出 涉及 11 个 workspace 包文件，每处均为独立的 unreferenced export 删除或 export 关键字冗余移除： - @ant/ink/core/termio/csi.ts（eraseLine） - acp-link/manager/types.ts、acp-link/ws-message.ts - builtin-tools/AgentTool/agentMemory.ts、BashTool/bashSecurity.ts、BashTool/sedEditParser.ts - builtin-tools/ConfigTool/supportedSettings.ts、FileEditTool/utils.ts - remote-control-server/store.ts、transport/event-bus.ts、types/messages.ts Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * Revert "fix: 终端内容溢出 viewport 时的重影 bug" This reverts commit3d18e1da58. * revert: 移除主屏幕周期性 self-healing 重绘 回退f69c7051中引入的 ink.tsx self-healing 机制（lastMainScreenHealTime 字段 + 每 5 秒触发全量重绘 + needsEraseBeforePaint 主屏幕分支）。该机制在 workflow 面板持续刷新场景下表现为可见的"重复刷新"，且修复效果不稳定。 alt-screen 的 needsEraseBeforePaint 路径和 prevFrameContaminated 字段保留， 它们仍服务于 handleResize / layout shift / selection 高亮。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * fix: /workflows 面板默认只显示运行中 run，根治 tab 行乱码 之前几次渲染层修复都失败，因为没动 tab 列表的数据源：打开 /workflows 会 自动 hydrate 最多 20 个历史 done/killed run，全部塞进一行 TabsBar，超出 终端宽度后 Ink 把字符画到屏外造成重影乱码。 - selectors.ts 加 filterActiveRuns（只留 status === 'running'）和 capTabsForDisplay（超额 fold 成 +N）两个 pure function - WorkflowsPanel 接线 activeRuns：focus clamp、focused、nextTab/prevTab、 TabsBar 全部基于过滤后的 activeRuns - TabsBar 复用 truncateLabel 限制每个 tab 名 18 字符 + 最多 6 个 tab， 多余显示 +N，从结构上钉死单行总宽度 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * fix: /workflows 面板 phase 状态在脚本省略 phase() 时显示错乱 ultracode canonical pipeline 脚本常在 agent() 直接传 opts.phase 而不调 phase() hook，导致 phase_started 从未发出；同时 phase_done 只在下次 phase() 触发，上一 个 phase 在 run.phases 里一直停在 running。mergePhases 之前把 actual 当权威， 于是出现 "Map 8/8 全 done 还显示 running、Find 1/4 running 反而显示 pending"。 改为派生层修复：mergePhases 新增 derivePhaseStatus——actual.status==='done' 权威；否则有 agents 就按 agents 状态推（全 done→done，否则 running）；否则看 actual 是否 running。再补一层遍历，让只在 agents 上出现的 phase 也进 sidebar。 不改 store 状态语义，已有 state.json 无需迁移。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> * docs: 更新 readme * fix: ACP 模式未读取 settings.local.json entry.ts 在 ACP 握手期调用的 applySafeConfigEnvironmentVariables 触发了 loadSettingsFromDisk，此时 getOriginalCwd() 还是进程启动 cwd（非项目目录）， 导致 localSettings/projectSettings 按错误路径解析为空并被 session cache 锁住， 后续 createSession 里 setOriginalCwd 也无法纠正。在 setOriginalCwd 与 chdir 之后清缓存并重新应用，让 settings.local.json 和项目级 env 对 readSettingsPermissionMode 及下游可见。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win> --------- Co-authored-by: glm-5.2 <zai-org@claude-code-best.win>
246 lines
15 KiB
Markdown
246 lines
15 KiB
Markdown
# Claude Code Best V5 (CCB)
|
||
|
||
[](https://github.com/claude-code-best/claude-code/stargazers)
|
||
[](https://github.com/claude-code-best/claude-code/graphs/contributors)
|
||
[](https://github.com/claude-code-best/claude-code/issues)
|
||
[](https://github.com/claude-code-best/claude-code/blob/main/LICENSE)
|
||
[](https://github.com/claude-code-best/claude-code/commits/main)
|
||
[](https://bun.sh/)
|
||
[](https://discord.gg/uApuzJWGKX)
|
||
|
||
> Which Claude do you like? The open source one is the best.
|
||
|
||
牢 A (Anthropic) 官方 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 完整复原的工程化项目。虽然很难绷, 但是它叫做 CCB(踩踩背)... 而且, 我们实现了企业版或者需要登陆 Claude 账号才能使用的特性, 并在此基础上扩展了更多好玩的特性。
|
||
|
||
[Peri Code](https://github.com/KonghaYao/peri)：Claude Code 兼容的 Rust Agent，多年大模型经验匠心制作，国内大模型（DeepSeek/GLM）精调，CPU/内存极致优化，在开发版/树莓派上也能跑 CC 一样的体验。
|
||
|
||
[文档在这里](https://ccb.agent-aura.top/) | [留影文档在这里](./Friends.md) | [Discord 群组，群主在线答疑](https://discord.gg/uApuzJWGKX)
|
||
|
||
| 特性 | 说明 | 文档 |
|
||
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| **🎯 Goal 持续驱动** | `/goal <objective>` 设定目标后，自动跨轮驱动 agent 直至完成；带 token budget、completion/blocked audit、`pause`/`resume`/`continue`/`clear` 子命令，网络中断自动暂停 | 源码 [`commands/goal/`](./src/commands/goal/) · [`services/goal/`](./src/services/goal/) |
|
||
| **📦 Artifacts（HTML 上传）** | 复刻 Anthropic 官方 Artifacts：模型把 HTML/数据看板/报告上传到公开 URL（7d/30d 自动过期），`/artifacts` 命令集中管理，Cloudflare Worker + R2 完全开源、可自托管 | [8 小时复刻报告](./docs/blog/2026-06-20-cloud-artifacts-8h-recap.md) · [在线 demo](https://cloud-artifacts.claude-code-best.win/30d/c2jfwi3E-y3fTZ1ors-KE.html) |
|
||
| **🧠 Ultracode 多 Agent 编排** | `/ultracode` 注入 workflow 编排手册 + `Workflow` 工具跑确定性 JS 脚本（`agent`/`pipeline`/`parallel`/`phase`）+ `/workflows` 双栏监控面板；支持 journal 重放、token budget、并发 cap | [文档](https://ccb.agent-aura.top/docs/features/workflow-scripts) |
|
||
| **Claude 群控技术** | Pipe IPC 多实例协作：同机 main/sub 自动编排 + LAN 跨机器零配置发现与通讯，`/pipes` 选择面板 + `Shift+↓` 交互 + 消息广播路由 | [Pipe IPC](https://ccb.agent-aura.top/docs/features/uds-inbox) / [LAN](https://ccb.agent-aura.top/docs/features/lan-pipes) |
|
||
| **ACP 协议一等一支持** | 支持接入 Zed、Cursor 等 IDE，支持会话恢复、Skills、权限桥接 | [文档](https://ccb.agent-aura.top/docs/features/acp-zed) |
|
||
| **Remote Control 私有部署** | Docker 自托管远程界面, 可以手机上看 CC | [文档](https://ccb.agent-aura.top/docs/features/remote-control-self-hosting) |
|
||
| **Langfuse 监控** | 企业级 Agent 监控, 可以清晰看到每次 agent loop 细节, 可以一键转化为数据集 | [文档](https://ccb.agent-aura.top/docs/features/langfuse-monitoring) |
|
||
| **Web Search** | 内置网页搜索工具, 支持 bing 和 brave 搜索 | [文档](https://ccb.agent-aura.top/docs/features/web-browser-tool) |
|
||
| **Poor Mode** | 穷鬼模式，关闭记忆提取和键入建议,大幅度减少并发请求 | /poor 可以开关 |
|
||
| **Channels 频道通知** | MCP 服务器推送外部消息到会话（飞书/Slack/Discord/微信等），`--channels plugin:name@marketplace` 启用 | [文档](https://ccb.agent-aura.top/docs/features/channels) |
|
||
| **自定义模型供应商** | OpenAI/Anthropic/Gemini/Grok 兼容 (`/login`) | [文档](https://ccb.agent-aura.top/docs/features/all-features-guide) |
|
||
| Voice Mode | 语音输入，支持豆包语言输入（`/voice doubao`） | [文档](https://ccb.agent-aura.top/docs/features/voice-mode) |
|
||
| Computer Use | 屏幕截图、键鼠控制 | [文档](https://ccb.agent-aura.top/docs/features/computer-use) |
|
||
| Chrome Use | 浏览器自动化、表单填写、数据抓取 | [自托管](https://ccb.agent-aura.top/docs/features/chrome-use-mcp) [原生版](https://ccb.agent-aura.top/docs/features/claude-in-chrome-mcp) |
|
||
| Sentry | 企业级错误追踪 | [文档](https://ccb.agent-aura.top/docs/internals/sentry-setup) |
|
||
| GrowthBook | 企业级特性开关 | [文档](https://ccb.agent-aura.top/docs/internals/growthbook-adapter) |
|
||
| /dream 记忆整理 | 自动整理和优化记忆文件 | [文档](https://ccb.agent-aura.top/docs/features/auto-dream) |
|
||
|
||
- 🚀 [想要启动项目](#-快速开始源码版)
|
||
- 🐛 [想要调试项目](#vs-code-调试)
|
||
- 📖 [想要学习项目](#teach-me-学习项目)
|
||
|
||
## ⚡ 快速开始(安装版)
|
||
|
||
不用克隆仓库, 从 NPM 下载后, 直接使用
|
||
|
||
```sh
|
||
npm i -g claude-code-best
|
||
|
||
# bun 安装比较多问题, 推荐 npm 装
|
||
# bun i -g claude-code-best
|
||
# bun pm -g trust claude-code-best @claude-code-best/mcp-chrome-bridge
|
||
|
||
ccb # 以 nodejs 打开 claude code
|
||
ccb-bun # 以 bun 形态打开
|
||
ccb update # 更新到最新版本
|
||
CLAUDE_BRIDGE_BASE_URL=https://remote-control.claude-code-best.win/ CLAUDE_BRIDGE_OAUTH_TOKEN=test-my-key ccb --remote-control # 我们有自部署的远程控制
|
||
```
|
||
|
||
> **安装/更新失败？** 先 `npm rm -g claude-code-best` 清理旧版本，再 `npm i -g claude-code-best@latest`。仍失败则指定版本号：`npm i -g claude-code-best@<版本号>`
|
||
|
||
## ⚡ 快速开始(源码版)
|
||
|
||
### ⚙️ 环境要求
|
||
|
||
一定要最新版本的 bun 啊, 不然一堆奇奇怪怪的 BUG!!! bun upgrade!!!
|
||
|
||
- 📦 [Bun](https://bun.sh/) >= 1.3.11
|
||
|
||
**安装 Bun：**
|
||
|
||
```bash
|
||
# Linux 和 macOS
|
||
curl -fsSL https://bun.sh/install | bash
|
||
|
||
# Windows (PowerShell)
|
||
powershell -c "irm bun.sh/install.ps1 | iex"
|
||
```
|
||
|
||
**安装后的操作：**
|
||
|
||
1. **让当前终端识别 `bun` 命令**
|
||
|
||
安装脚本会把 `~/.bun/bin` 写入对应的 shell 配置文件。macOS 默认 zsh 环境通常会看到：
|
||
|
||
```text
|
||
Added "~/.bun/bin" to $PATH in "~/.zshrc"
|
||
```
|
||
|
||
可以按安装脚本提示重启当前 shell：
|
||
|
||
```bash
|
||
exec /bin/zsh
|
||
```
|
||
|
||
如果你使用 bash，重新加载 bash 配置：
|
||
|
||
```bash
|
||
source ~/.bashrc
|
||
```
|
||
|
||
Windows PowerShell 用户关闭并重新打开 PowerShell 即可。
|
||
|
||
2. **验证 Bun 是否可用**
|
||
|
||
```bash
|
||
bun --help
|
||
bun --version
|
||
```
|
||
|
||
3. **如果已经安装过 Bun，更新到最新版本**
|
||
|
||
```bash
|
||
bun upgrade
|
||
```
|
||
|
||
- ⚙️ 常规的配置 CC 的方式, 各大提供商都有自己的配置方式
|
||
|
||
### 📍 命令执行位置
|
||
|
||
- 安装或检查 Bun 的命令可以在任意目录执行：
|
||
`curl -fsSL https://bun.sh/install | bash`、`bun --help`、`bun --version`、`bun upgrade`
|
||
- 安装本项目依赖、启动开发模式、构建项目时，必须先进入本仓库根目录，也就是包含 `package.json` 的目录。
|
||
|
||
### 📥 安装
|
||
|
||
```bash
|
||
cd /path/to/claude-code
|
||
bun install
|
||
```
|
||
|
||
### ▶️ 运行
|
||
|
||
```bash
|
||
# 开发模式, 看到版本号 888 说明就是对了
|
||
bun run dev
|
||
|
||
# 构建
|
||
bun run build
|
||
```
|
||
|
||
构建采用 code splitting 多文件打包（`build.ts`），产物输出到 `dist/` 目录（入口 `dist/cli.js` + 约 450 个 chunk 文件）。
|
||
|
||
构建出的版本 bun 和 node 都可以启动, 你 publish 到私有源可以直接启动
|
||
|
||
如果遇到 bug 请直接提一个 issues, 我们优先解决
|
||
|
||
### 👤 新人配置 /login
|
||
|
||
首次运行后，在 REPL 中输入 `/login` 命令进入登录配置界面，选择 **Anthropic Compatible** 即可对接第三方 API 兼容服务（无需 Anthropic 官方账号）。
|
||
选择 OpenAI 和 Gemini 对应的栏目都是支持相应协议的
|
||
|
||
需要填写的字段：
|
||
|
||
| 📌 字段 | 📝 说明 | 💡 示例 |
|
||
| ------------ | ------------- | ---------------------------- |
|
||
| Base URL | API 服务地址 | `https://api.example.com/v1` |
|
||
| API Key | 认证密钥 | `sk-xxx` |
|
||
| Haiku Model | 快速模型 ID | `claude-haiku-4-5-20251001` |
|
||
| Sonnet Model | 均衡模型 ID | `claude-sonnet-4-6` |
|
||
| Opus Model | 高性能模型 ID | `claude-opus-4-6` |
|
||
|
||
- ⌨️ **Tab / Shift+Tab** 切换字段，**Enter** 确认并跳到下一个，最后一个字段按 Enter 保存
|
||
|
||
> ℹ️ 支持所有 Anthropic API 兼容服务（如 OpenRouter、AWS Bedrock 代理等），只要接口兼容 Messages API 即可。
|
||
|
||
## Feature Flags
|
||
|
||
所有功能开关通过 `FEATURE_<FLAG_NAME>=1` 环境变量启用，例如：
|
||
|
||
```bash
|
||
FEATURE_BUDDY=1 FEATURE_FORK_SUBAGENT=1 bun run dev
|
||
```
|
||
|
||
各 Feature 的详细说明见 [`docs/features/`](docs/features/) 目录，欢迎投稿补充。
|
||
|
||
## VS Code 调试
|
||
|
||
TUI (REPL) 模式需要真实终端，无法直接通过 VS Code launch 启动调试。使用 **attach 模式**：
|
||
|
||
### 步骤
|
||
|
||
1. **终端启动 inspect 服务**：
|
||
|
||
```bash
|
||
bun run dev:inspect
|
||
```
|
||
|
||
会输出类似 `ws://localhost:8888/xxxxxxxx` 的地址。
|
||
2. **VS Code 附着调试器**：
|
||
|
||
- 在 `src/` 文件中打断点
|
||
- F5 → 选择 **"Attach to Bun (TUI debug)"**
|
||
|
||
## Teach Me 学习项目
|
||
|
||
我们新加了一个 teach-me skills, 通过问答式引导帮你理解这个项目的任何模块。(调整 [sigma skill 而来](https://github.com/sanyuan0704/sanyuan-skills))
|
||
|
||
```bash
|
||
# 在 REPL 中直接输入
|
||
/teach-me Claude Code 架构
|
||
/teach-me React Ink 终端渲染 --level beginner
|
||
/teach-me Tool 系统 --resume
|
||
```
|
||
|
||
### 它能做什么
|
||
|
||
- **诊断水平** — 自动评估你对相关概念的掌握程度，跳过已知的、聚焦薄弱的
|
||
- **构建学习路径** — 将主题拆解为 5-15 个原子概念，按依赖排序逐步推进
|
||
- **苏格拉底式提问** — 用选项引导思考，而非直接给答案
|
||
- **错误概念追踪** — 发现并纠正深层误解
|
||
- **断点续学** — `--resume` 从上次进度继续
|
||
|
||
### 学习记录
|
||
|
||
学习进度保存在 `.claude/skills/teach-me/` 目录下，支持跨主题学习者档案。
|
||
|
||
## 相关文档及网站
|
||
|
||
- **在线文档（Mintlify）**: [ccb.agent-aura.top](https://ccb.agent-aura.top/) — 文档源码位于 [`docs/`](docs/) 目录，欢迎投稿 PR
|
||
- **DeepWiki**: [https://deepwiki.com/claude-code-best/claude-code](https://deepwiki.com/claude-code-best/claude-code)
|
||
|
||
## Contributors
|
||
|
||
<a href="https://github.com/claude-code-best/claude-code/graphs/contributors">
|
||
<img src="contributors.svg" alt="Contributors" />
|
||
</a>
|
||
|
||
## 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>
|
||
|
||
## 致谢
|
||
|
||
- [doubaoime-asr](https://github.com/starccy/doubaoime-asr) — 豆包 ASR 语音识别 SDK，为 Voice Mode 提供无需 Anthropic OAuth 的语音输入方案
|
||
|
||
## 许可证
|
||
|
||
本项目仅供学习研究用途。Claude Code 的所有权利归 [Anthropic](https://www.anthropic.com/) 所有。
|