核心用法
cc 是一个 Claude Code 中继会话的快捷操作封装器,通过简洁的斜杠命令实现对远程开发会话的管理。用户可通过 /cc projects 查看可用项目,/cc on <project> 启动或复用会话,/cc tail 查看最近输出,/cc off 关闭会话。在无参数调用时,系统会展示交互式按钮菜单(若平台支持)。
进入中继模式后,该 skill 转变为透明管道——所有用户消息直接转发至目标 Claude Code 实例,不做任何解释或处理,仅返回 Claude Code 的最终输出。这一设计确保了远程开发体验的完整性与一致性。
显著优点
- 极简交互:将复杂的 tmux + Claude 命令序列封装为直观的短指令
- 多项目支持:模糊匹配项目名,支持别名映射,轻松在多个代码库间切换
- 透明中继:严格的消息转发契约,避免助手与远程 Claude 实例的双重响应冲突
- 状态可视化:
tail与status命令提供会话健康度与历史输出的即时洞察 - 环境可配置:通过环境变量灵活定义项目根目录与别名映射文件路径
潜在局限
- 依赖链复杂:硬性依赖
tmux、claude二进制文件及claude-relayskill,任一缺失即失效 - 平台差异:按钮菜单功能受限于底层平台支持,非交互环境回退至纯文本
- 无本地缓存:频繁依赖磁盘读取项目映射,高并发场景下可能存在性能瓶颈
- 权限隐式:对
CLAUDE_RELAY_ROOT目录的读写权限未显式校验,错误配置可能导致静默失败
适合人群
- 需要同时管理多个代码库远程开发会话的技术团队
- 习惯 tmux 工作流、追求命令行效率的资深开发者
- 已通过
claude-relay部署 Claude Code 远程会话的基础设施维护者
常规风险
- 会话泄露:
tail默认返回 120 行历史输出,可能暴露敏感日志片段 - 中继劫持:若项目别名映射文件遭篡改,用户消息可能被路由至非预期会话
- 状态漂移:
claude-relay进程异常退出时,skill 状态与实际 tmux 会话可能不一致,需手动status校验