Claude Code Best (CCB) — 全功能使用指南

本文档覆盖我们通过 13 个 PR 为 CCB 恢复/新增的全部功能，按类别组织，每个功能包含说明、使用方法和示例。

Buddy 伴侣系统
Remote Control 远程控制
定时任务 /schedule
Voice Mode 语音模式
Chrome 浏览器控制
Computer Use 屏幕操控
Feature Flags 与 GrowthBook
/ultraplan 高级规划
Daemon 后台守护
Pipe IPC 多实例协作
LAN Pipes 局域网群控
Monitor 后台监控
Workflow 工作流脚本
Coordinator 多Worker协调
Proactive 自主模式
History / Snip 历史管理
Fork 子Agent
其他恢复的工具

1. Buddy 伴侣系统

PR: #82 refactor(buddy): align companion system with official CLI Feature Flag: BUDDY

说明

Buddy 是一个后台运行的伴侣 AI，在你主对话进行的同时，异步观察会话内容并提供建议。

使用

# 启动时自动加载（feature 默认开启）
bun run dev

# 在对话中，Buddy 会在适当时机自动提供建议
# 例如当你在调试时，Buddy 可能提示你检查日志

2. Remote Control 远程控制

PR: #60 feat: enable Remote Control (BRIDGE_MODE) + #170 feat: restore daemon supervisor Feature Flag: BRIDGE_MODE

说明

通过 WebSocket 远程控制 Claude Code 会话。支持自托管私有部署。

使用

# 启动远程控制模式
bun run dev -- remote-control

# 使用自托管服务器
CLAUDE_BRIDGE_BASE_URL=https://your-server.com CLAUDE_BRIDGE_OAUTH_TOKEN=your-token bun run dev --remote-control

# 或通过 /remote-control 命令在会话中启动
/remote-control

命令

claude remote-control / claude rc — 启动远程控制客户端
claude bridge — 同上（别名）

3. 定时任务 /schedule

PR: #88 feat: enable /schedule by adding AGENT_TRIGGERS_REMOTE Feature Flag: AGENT_TRIGGERS_REMOTE

说明

创建定时执行的远程 agent 任务，支持 cron 表达式。

使用

/schedule create "每天检查依赖更新" --cron "0 9 * * *" --prompt "检查 package.json 中的过期依赖并创建更新 PR"
/schedule list          — 列出所有定时任务
/schedule delete <id>   — 删除指定任务

4. Voice Mode 语音模式

PR: #92 feat: enable /voice mode with native audio binaries Feature Flag: VOICE_MODE

说明

Push-to-Talk 语音输入，音频通过 WebSocket 流式传输到 Anthropic STT（Nova 3）。需要 Anthropic OAuth 认证（非 API key）。

使用

# 确保已通过 OAuth 登录
claude auth login

# 在会话中按住指定键说话
# 松开后自动转写为文字输入

前提条件

Anthropic OAuth 认证（不支持 API key 模式）
系统麦克风权限

5. Chrome 浏览器控制

PR: #93 feat: enable Claude in Chrome MCP with full browser control Feature Flag: CHICAGO_MCP

说明

通过 Chrome 扩展控制浏览器：导航、点击、填表、截图、执行 JS。

使用

# 启动带 Chrome 控制的模式
bun run dev -- --chrome

# 安装 Chrome 扩展后，AI 可以：
# - 打开网页、点击按钮
# - 填写表单
# - 截取页面内容
# - 执行 JavaScript

AI 可用工具

navigate — 导航到 URL
click / find / form_input — 页面交互
get_page_text / read_page — 读取内容
javascript_tool — 执行 JS
gif_creator — 录制操作 GIF

6. Computer Use 屏幕操控

PR: #98 + #137 feat: Computer Use — 跨平台 Executor + Python Bridge + GUI 无障碍 Feature Flag: CHICAGO_MCP

说明

跨平台屏幕操控：截图、键鼠模拟、应用管理。支持 macOS + Windows，Linux 后端待完成。

使用

# 启动后 AI 可自动调用屏幕操控工具
bun run dev

# AI 可以：
# - 截取屏幕/窗口截图
# - 模拟键盘输入和鼠标操作
# - 列出运行的应用
# - 使用剪贴板

平台支持

平台	截图	键鼠	应用管理
macOS	✅	✅	✅
Windows	✅	✅	✅
Linux	⏳	⏳	⏳

7. Feature Flags 与 GrowthBook

PR: #140 + #153 feat: enable GrowthBook local gate defaults Feature Flags: SHOT_STATS, PROMPT_CACHE_BREAK_DETECTION, TOKEN_BUDGET

说明

本地 GrowthBook gate defaults 机制，绕过远程 feature flag 服务，确保功能在无网络时也可使用。

使用

# 通过环境变量启用任意 feature
FEATURE_PROACTIVE=1 bun run dev

# dev/build 模式有各自的默认启用列表
# 查看 scripts/dev.ts 中的 DEFAULT_FEATURES

关键 feature flags

Flag	说明
`SHOT_STATS`	API 调用统计
`TOKEN_BUDGET`	Token 预算控制
`PROMPT_CACHE_BREAK_DETECTION`	Prompt 缓存命中检测

8. /ultraplan 高级规划

PR: #156 feat: enable /ultraplan and harden GrowthBook fallback chain Feature Flag: ULTRAPLAN

说明

高级多 agent 规划模式。将复杂任务分解为多个阶段，每阶段可分配给不同 agent 并行执行。

使用

/ultraplan 实现一个完整的用户认证系统，包括注册、登录、密码重置、OAuth 集成

AI 会生成：

任务分解（多阶段）
每阶段的 agent 分配
依赖关系图
并行执行计划

9. Daemon 后台守护

PR: #170 feat: restore daemon supervisor and remoteControlServer command Feature Flag: DAEMON

说明

Daemon 模式允许 Claude Code 作为后台长驻进程运行，管理多个 worker。

使用

# 启动 daemon
claude daemon start

# 查看状态
claude daemon status

# 停止
claude daemon stop

# 启动远程控制服务器
bun run rcs

10. Pipe IPC 多实例协作

PR: #241 feat: restore pipe IPC, LAN pipes, monitor tool Feature Flag: UDS_INBOX

说明

同一台机器上的多个 Claude Code 实例通过 UDS（Unix Domain Socket / Windows Named Pipe）自动发现并协作。首个启动的实例成为 main，后续自动注册为 sub。

使用

启动多实例：

# 终端 1
bun run dev
# → 自动成为 main

# 终端 2
bun run dev
# → 自动成为 sub-1，被 main attach

管理实例：

/pipes                — 显示所有实例，Shift+↓ 展开选择面板
/pipes select <name>  — 选中实例
/pipes all            — 全选
/pipes none           — 取消全选
/attach <name>        — 手动 attach 某实例
/detach <name>        — 断开连接
/send <name> <msg>    — 向指定实例发送消息
/claim-main           — 强制声明为 main
/pipe-status          — 显示详细状态
/peers                — 列出所有已发现的 peer

选择面板操作：

按 Shift+↓ 展开面板
↑/↓ 移动光标
Space 选中/取消 pipe
Enter 确认关闭
←/→ 切换路由模式（selected pipes ↔ local main）

消息广播：选中 pipe 后，输入的消息自动路由到所有选中的 slave 执行，结果流式回传到 main。

权限转发： slave 执行需要权限的工具时（如 BashTool），权限请求自动转发到 main 的确认队列。

11. LAN Pipes 局域网群控

PR: #241（同上） Feature Flag: LAN_PIPES

说明

在 Pipe IPC 基础上增加 TCP 传输层和 UDP Multicast 发现，实现跨机器零配置协作。

使用

局域网多机器：

# 机器 A (192.168.50.22)
bun run dev

# 机器 B (192.168.50.27)
bun run dev

# 两边启动后 3-5 秒自动发现和 attach
# /pipes 显示 [LAN] 标记的远端实例

防火墙配置（每台机器都需要）：

Windows（管理员 PowerShell）：

New-NetFirewallRule -DisplayName "CCB LAN Beacon (UDP)" -Direction Inbound -Protocol UDP -LocalPort 7101 -Action Allow -Profile Private
New-NetFirewallRule -DisplayName "CCB LAN Pipes (TCP)" -Direction Inbound -Protocol TCP -LocalPort 1024-65535 -Program (Get-Command bun).Source -Action Allow -Profile Private
New-NetFirewallRule -DisplayName "CCB LAN Beacon Out (UDP)" -Direction Outbound -Protocol UDP -RemotePort 7101 -Action Allow -Profile Private

macOS：

# 首次运行时系统弹对话框，点"允许"即可

Linux：

sudo firewall-cmd --zone=trusted --add-port=7101/udp --permanent
sudo firewall-cmd --zone=trusted --add-port=1024-65535/tcp --permanent
sudo firewall-cmd --reload

通知显示格式：

# 本机 sub
Routed to [sub-1]; main can continue other tasks

# LAN peer
Routed to [main] vmwin11/192.168.50.27; main can continue other tasks

12. Monitor 后台监控

PR: #241（同上） Feature Flag: MONITOR_TOOL

说明

在后台运行 shell 命令持续监控输出（类似 watch 命令）。AI 也可自主调用 MonitorTool。

使用

用户命令：

/monitor tail -f /var/log/syslog
/monitor watch -n 5 docker ps
/monitor "while true; do curl -s localhost:3000/health; sleep 10; done"

查看监控：

按 Shift+Down 展开后台任务面板
查看监控输出和状态

Windows 兼容： watch -n <sec> <cmd> 自动转为 PowerShell 循环：

while($true){ <cmd>; Start-Sleep -Seconds <sec> }

AI 调用： AI 可在对话中自动调用 MonitorTool 监控日志、构建输出等。

13. Workflow 工作流脚本

PR: #241（同上） Feature Flag: WORKFLOW_SCRIPTS

说明

执行 .claude/workflows/ 目录下的用户定义工作流脚本。

使用

创建工作流：

mkdir -p .claude/workflows
cat > .claude/workflows/deploy.sh << 'EOF'
#!/bin/bash
echo "Running tests..."
bun test
echo "Building..."
bun run build
echo "Deploying..."
EOF
chmod +x .claude/workflows/deploy.sh

列出可用工作流：

/workflows

AI 调用： AI 可通过 WorkflowTool 自动执行工作流：

请执行 deploy 工作流

14. Coordinator 多Worker协调

PR: #241（同上） Feature Flag: COORDINATOR_MODE

说明

启用 coordinator 模式后，AI 可自动将任务分配给多个 worker 并行执行。

使用

/coordinator       — 切换 coordinator 模式开/关

启用后，AI 在处理复杂任务时会：

分析任务可并行的部分
自动创建 worker 分支
分配子任务
汇总结果

15. Proactive 自主模式

PR: #241（同上） Feature Flag: PROACTIVE / KAIROS

说明

启用后 AI 会主动发起操作（而不仅回应用户输入），例如自动检测文件变更、主动提出优化建议。

使用

/proactive         — 切换 proactive 模式开/关

16. History / Snip 历史管理

PR: #241（同上） Feature Flag: HISTORY_SNIP

说明

查看和管理对话历史，支持手动截断以释放上下文窗口空间。

使用

/history           — 显示对话历史摘要
/force-snip        — 强制在当前位置截断历史

AI 也可通过 SnipTool 自动截断过长的对话：

对话太长了，请帮我截断历史

17. Fork 子Agent

PR: #241（同上） Feature Flag: FORK_SUBAGENT

说明

在当前对话上下文中 fork 一个独立的子 agent，继承完整会话状态独立执行。

使用

/fork              — 基于当前上下文 fork 子 agent

子 agent 会：

继承当前的全部对话历史
在独立的执行环境中运行
不影响主会话状态

18. 其他恢复的工具

以下工具从 stub 恢复为完整实现：

工具	说明	使用
`SleepTool`	暂停执行指定时间	AI 在轮询场景自动调用
`WebBrowserTool`	终端内网页交互	AI 需要查看网页时调用
`SubscribePRTool`	订阅 GitHub PR 变更	`/subscribe-pr` 或 AI 调用
`PushNotificationTool`	推送桌面通知	AI 在长任务完成时调用
`CtxInspectTool`	检查上下文窗口使用	AI 判断上下文剩余空间
`TerminalCaptureTool`	截取终端屏幕	AI 需要看终端输出时调用
`SendUserFileTool`	向用户发送文件	AI 导出文件时调用
`REPLTool`	启动子 REPL 会话	AI 需要独立交互环境时调用
`VerifyPlanExecutionTool`	验证执行计划完成度	AI 完成计划后自动验证
`SuggestBackgroundPRTool`	建议创建后台 PR	AI 发现可独立的变更时提议
`ListPeersTool`	列出已发现的 peer	AI 查询多实例状态时调用

附录：全部 Feature Flags

Flag	默认	说明
`BUDDY`	✅ dev/build	伴侣系统
`BRIDGE_MODE`	✅ dev/build	远程控制
`VOICE_MODE`	✅ dev/build	语音模式
`CHICAGO_MCP`	✅ dev/build	Computer Use + Chrome
`AGENT_TRIGGERS_REMOTE`	✅ dev/build	定时任务
`SHOT_STATS`	✅ dev/build	API 统计
`TOKEN_BUDGET`	✅ dev/build	Token 预算
`PROMPT_CACHE_BREAK_DETECTION`	✅ dev/build	缓存检测
`ULTRAPLAN`	✅ dev/build	高级规划
`DAEMON`	✅ dev/build	后台守护
`UDS_INBOX`	✅ dev/build	Pipe IPC
`LAN_PIPES`	✅ dev/build	LAN 群控
`MONITOR_TOOL`	✅ dev/build	后台监控
`WORKFLOW_SCRIPTS`	✅ dev/build	工作流脚本
`FORK_SUBAGENT`	✅ dev/build	子 Agent
`KAIROS`	✅ dev/build	Kairos 调度
`COORDINATOR_MODE`	✅ dev/build	多 Worker
`HISTORY_SNIP`	✅ dev/build	历史管理
`CONTEXT_COLLAPSE`	✅ dev/build	上下文折叠

手动启用任意 flag：

FEATURE_FLAG_NAME=1 bun run dev

附录：PR 列表

PR	日期	标题
#60	2026-04-02	feat: enable Remote Control (BRIDGE_MODE)
#82	2026-04-03	refactor(buddy): align companion system
#88	2026-04-03	feat: enable /schedule (AGENT_TRIGGERS_REMOTE)
#89	2026-04-03	feat: built-in status line
#92	2026-04-03	feat: enable /voice mode
#93	2026-04-03	feat: enable Chrome MCP
#98	2026-04-03	feat: enable Computer Use (macOS + Windows + Linux)
#137	2026-04-05	feat: Computer Use v2 — 跨平台 Executor
#140	2026-04-05	feat: enable SHOT_STATS, TOKEN_BUDGET
#153	2026-04-06	feat: enable GrowthBook local gate defaults
#156	2026-04-06	feat: enable /ultraplan
#170	2026-04-07	feat: restore daemon supervisor
#241	2026-04-11	feat: restore pipe IPC, LAN pipes, monitor tool

FilesExpand file tree

all-features-guide.md

Latest commit

History