克劳德作曲家

---

此仓库已毕业。这意味着我不再使用它，祝愿任何想要复刻、继续使用、接管或进行其他让自己开心活动的人好运与快乐。今后我将使用钩子来实现“YOLO模式”：

https://github.com/possibilities/claude-code-generic-hooks

并且我使用权限模式以计划模式启动：

https://docs.anthropic.com/en/docs/claude-code/iam#permission-modes

同时使用 DIRTY-CONFIRM 来获得与 CLAUDE-COMPOSER 在非 Git 和脏 Git 目录中提供的相同确认提示：

https://github.com/possibilities/dirty-confirm

一个为 Claude Code 添加小增强的工具

特性

• 减少打断：自动接受确认提示
• 工具管理：工具集可配置 Claude 可使用的工具
• 增强可见性：系统通知让您随时了解情况（已损坏，即将迎来重大更新）

快速入门

# 安装
npm install -g claude-composer

# 初始化配置
claude-composer cc-init

# 使用默认设置运行
claude-composer

# 使用 YOLO 模式（接受所有提示）
claude-composer --yolo

安装

先决条件：Node.js 18+、npm/yarn/pnpm，以及已安装的 Claude Code

# 全局安装
pnpm add -g claude-composer
# 或
yarn global add claude-composer
# 或
npm install -g claude-composer

命令行选项

核心选项

# 配置
--yolo                           # 自动接受所有提示
--toolset <name...>              # 使用指定工具集
--mode <mode>                    # 以 'act' 或 'plan' 模式启动
--ignore-global-config           # 忽略全局配置

# 安全
--dangerously-allow-in-dirty-directory
--dangerously-allow-without-version-control
--dangerously-suppress-yolo-confirmation

# 通知
--show-notifications / --no-show-notifications
--sticky-notifications / --no-sticky-notifications

# 调试
--quiet                          # 抑制预检消息
--allow-buffer-snapshots         # 启用 Ctrl+Shift+S 截图
--log-all-pattern-matches        # 记录到 ~/.claude-composer/logs/

所有未识别的选项会传递给 Claude Code。

完整参考请参阅 docs/cli-reference.md。

配置

运行 claude-composer cc-init 创建配置：

# 全局配置（默认）
claude-composer cc-init

# 项目特定配置
claude-composer cc-init --project

基本配置

# config.yaml
yolo: false # 设置为 true 以自动接受所有提示

toolsets:
  - internal:core
  - my-tools

roots:
  - ~/projects/work
  - ~/projects/personal

show_notifications: true
sticky_notifications: false

详细信息请参阅 docs/configuration.md。

YOLO 模式

当通过 --yolo 标志或在配置中设置 yolo: true 启用时，Claude Composer 将自动接受所有提示而无需确认。请谨慎使用！

工具集

配置 Claude 可使用的工具及 MCP 服务器连接。

详细信息请参阅 docs/toolsets.md。

受信根目录

使用受信根目录定义受信的父目录，以便自动接受初始信任提示。

详细信息请参阅 docs/roots-config.md。

环境变量

详细信息请参阅 docs/environment-variables.md。

许可证

本项目属于公有领域。详情请参阅 UNLICENSE 文件。

Claude Composer 快速上手指南

⚠️ 重要提示：本仓库已停止维护（Graduated）。作者建议转向使用 claude-code-generic-hooks 实现 YOLO 模式，配合 dirty-confirm 处理目录确认。以下内容仅作为现有版本的参考指南。

Claude Composer 是一个为 Claude Code 提供增强功能的工具，主要特性包括自动确认提示、工具集管理以及系统通知（注：通知功能目前暂不可用，即将更新）。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS 或 Windows
• Node.js：版本 18 或更高
• 包管理器：npm, yarn 或 pnpm (任选其一)
• 前置依赖：必须已安装并配置好 Claude Code

安装步骤

您可以选择任意一种包管理器进行全局安装。国内开发者若遇到网络问题，可配置相应的 npm 镜像源（如淘宝镜像）加速下载。

使用 npm 安装：

npm install -g claude-composer

使用 yarn 安装：

yarn global add claude-composer

使用 pnpm 安装：

pnpm add -g claude-composer

基本使用

1. 初始化配置

首次使用前，需要生成配置文件。默认生成全局配置：

claude-composer cc-init

若需为当前项目生成独立配置，请使用：

claude-composer cc-init --project

2. 启动运行

使用默认设置启动工具：

claude-composer

3. 启用 YOLO 模式（自动确认）

如果您希望工具自动接受所有提示而无需人工确认（类似“自动驾驶”模式），可以使用 --yolo 标志：

claude-composer --yolo

注意：YOLO 模式下工具将自动执行操作，请在受控环境或明确知晓后果的情况下谨慎使用。