Skip to main content

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

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

​
目录

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

​
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_STATSAPI 调用统计
TOKEN_BUDGETToken 预算控制
PROMPT_CACHE_BREAK_DETECTIONPrompt 缓存命中检测

​
8. /ultraplan 高级规划

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

​
说明

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

​
使用

/ultraplan 实现一个完整的用户认证系统，包括注册、登录、密码重置、OAuth 集成
AI 会生成：
  1. 任务分解（多阶段）
  2. 每阶段的 agent 分配
  3. 依赖关系图
  4. 并行执行计划

​
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
选择面板操作：
  1. 按 Shift+↓ 展开面板
  2. ↑/↓ 移动光标
  3. Space 选中/取消 pipe
  4. Enter 确认关闭
  5. ←/→ 切换路由模式（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 在处理复杂任务时会：
  1. 分析任务可并行的部分
  2. 自动创建 worker 分支
  3. 分配子任务
  4. 汇总结果

​
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建议创建后台 PRAI 发现可独立的变更时提议
ListPeersTool列出已发现的 peerAI 查询多实例状态时调用

​
附录：全部 Feature Flags

Flag默认说明
BUDDY✅ dev only伴侣系统
BRIDGE_MODE✅ dev only远程控制
VOICE_MODE✅ dev+build语音模式
CHICAGO_MCP✅ dev+buildComputer Use + Chrome
AGENT_TRIGGERS_REMOTE✅ dev+build定时任务
SHOT_STATS✅ dev+buildAPI 统计
TOKEN_BUDGET✅ dev+buildToken 预算
PROMPT_CACHE_BREAK_DETECTION✅ dev+build缓存检测
ULTRAPLAN✅ dev+build高级规划
DAEMON✅ dev+build后台守护
UDS_INBOX✅ dev onlyPipe IPC
LAN_PIPES✅ dev onlyLAN 群控
MONITOR_TOOL✅ dev+build后台监控
WORKFLOW_SCRIPTS✅ dev+build工作流脚本
FORK_SUBAGENT✅ dev+build子 Agent
KAIROS✅ dev+buildKairos 调度
COORDINATOR_MODE✅ dev+build多 Worker
HISTORY_SNIP✅ dev+build历史管理
CONTEXT_COLLAPSE✅ dev+build上下文折叠
ULTRATHINK✅ dev+build扩展思考
EXTRACT_MEMORIES✅ dev+build自动记忆提取
VERIFICATION_AGENT✅ dev+build验证 Agent
KAIROS_BRIEF✅ dev+buildBrief 模式
AWAY_SUMMARY✅ dev+build离开摘要
ACP✅ dev+buildACP 协议
LODESTONE✅ dev+build深度链接
BUILTIN_EXPLORE_PLAN_AGENTS✅ dev+build内置 Explore/Plan agent
AGENT_TRIGGERS✅ dev+build本地定时任务
BG_SESSIONS✅ dev only后台会话
TEMPLATES✅ dev only模板系统
TRANSCRIPT_CLASSIFIER✅ dev only对话分类
手动启用任意 flag： 
FEATURE_FLAG_NAME=1 bun run dev

​
附录：PR 列表

PR日期标题
#602026-04-02feat: enable Remote Control (BRIDGE_MODE)
#822026-04-03refactor(buddy): align companion system
#882026-04-03feat: enable /schedule (AGENT_TRIGGERS_REMOTE)
#892026-04-03feat: built-in status line
#922026-04-03feat: enable /voice mode
#932026-04-03feat: enable Chrome MCP
#982026-04-03feat: enable Computer Use (macOS + Windows + Linux)
#1372026-04-05feat: Computer Use v2 — 跨平台 Executor
#1402026-04-05feat: enable SHOT_STATS, TOKEN_BUDGET
#1532026-04-06feat: enable GrowthBook local gate defaults
#1562026-04-06feat: enable /ultraplan
#1702026-04-07feat: restore daemon supervisor
#2412026-04-11feat: restore pipe IPC, LAN pipes, monitor tool