可能性/Claude-Composer：Claudeコードを強化するためのツール

クロードコードを強化するためのツール

Claude Composerは、ClaudeコードのCLIラッパーであり、自動化、UX、および構成に関する小さな強化を追加します。

• 中断の減少：構成可能なルールに基づいて、許可ダイアログを自動的に処理します
• 柔軟な制御：ルールセットでは、自動的に許可するアクションを正確に定義できます
• ツール管理：ツールセットは、Claudeが使用できるツールの構成を簡素化します
• 可視性の向上：システム通知コンテキストを切り替えることなく、お知らせします

npm install -g claude-composer
# or
yarn global add claude-composer
# or
pnpm add -g claude-composer

# Initialize global configuration
claude-composer cc-init

# Start Claude Code with automatic dialog dismissal
claude-composer  # Uses the ruleset configured during cc-init

# Use a more permissive ruleset
claude-composer --ruleset internal:yolo

見る docs/installation.md 詳細なインストール手順。

• node.js 18以降
• NPM、糸、またはPNPMパッケージマネージャー
• claudeコードがインストールされ、構成されています

Claude Composerをグローバルにインストールする：

pnpm add -g claude-composer

または他のパッケージマネージャーと：

yarn global add claude-composer
npm install -g claude-composer

走る claude-composer cc-init 初期構成を作成するには：

# Create global configuration (default)
claude-composer cc-init

# Or create project-specific configuration
claude-composer cc-init --project

デフォルトでは、 claude-composer cc-init すべてのプロジェクトに適用されるグローバル構成を作成します。

• 構成場所： ~/.claude-composer/config.yaml
• ルールセットとツールセットの選択のインタラクティブプロンプト
• オーバーライドされていない限り、すべてのClaude Composerの呼び出しに適用されます

使用 claude-composer cc-init --project プロジェクト固有の構成を作成するには：

• 作成します .claude-composer/config.yaml 現在のディレクトリで
• 存在する場合、グローバル構成よりも優先されます
• プロジェクト固有のルールとツール設定に最適です

グローバル構成：

~/.claude-composer/
├── config.yaml          # Global configuration
├── rulesets/           # Custom global rulesets (unprefixed)
│   ├── my-workflow.yaml
│   └── backend-dev.yaml
└── toolsets/           # Custom global toolsets (unprefixed)
    ├── my-tools.yaml
    └── web-dev.yaml

プロジェクト構成（で --project）：

your-project/
├── .claude-composer/
│   ├── config.yaml     # Project configuration
│   ├── rulesets/       # Custom project rulesets
│   └── toolsets/       # Custom project toolsets
└── ... (your project files)

claude-composer [claude-composer-options] [claude-code-args]

Claude Composerは、Claude Codeを中心にラッパーとして機能し、サポートされているすべての引数をClaude Codeに通します。

# Use global configuration
claude-composer

# Use project configuration (if present)
cd your-project
claude-composer

# Override with specific ruleset
claude-composer --ruleset internal:safe

# Pass model selection to Claude Code
claude-composer --model claude-3-opus-20240229

# Combine composer options with Claude Code args
claude-composer --ruleset internal:yolo --model claude-3-opus-20240229

# Safe mode - all dialogs require confirmation
claude-composer --ruleset internal:safe

# Cautious mode - auto-accept project-level operations
claude-composer --ruleset internal:cautious

# YOLO mode - auto-accept all operations
claude-composer --ruleset internal:yolo

# Global custom ruleset (no prefix needed)
claude-composer --ruleset my-workflow

# Project-specific ruleset
claude-composer --ruleset project:my-custom-rules

# Chain multiple rulesets
claude-composer --ruleset internal:safe --ruleset my-overrides

見る docs/examples.md より多くの使用例と高度なワークフローについて。

mkdir my-project && cd my-project
claude-composer cc-init --project
claude-composer  # Uses the configuration created by cc-init

# Use YOLO mode if you are truly living in the moment
claude-composer --ruleset internal:yolo

# This effectively disables accepting all confirmations
claude-composer --ruleset internal:safe

# Enable built-in tools
claude-composer --toolset internal:core --ruleset internal:cautious

# Use global custom toolset
claude-composer --toolset my-tools --ruleset my-workflow

Claude Composerは、YAML構成ファイルを使用して動作を定義します。構成は、次の優先順位（最高から最低）の複数のソースからロードされます。

1. コマンドラインフラグ
2. プロジェクト構成（.claude-composer/config.yaml））
3. グローバル構成（~/.claude-composer/config.yaml））
4. 内蔵デフォルト

• グローバル： ~/.claude-composer/config.yaml
• プロジェクト： .claude-composer/config.yaml
• カスタムルールセット： {config-dir}/rulesets/*.yaml
• カスタムツールセット： {config-dir}/toolsets/*.yaml

# Rulesets to apply (in order)
rulesets:
  - internal:cautious # Built-in ruleset
  - my-defaults # Global custom ruleset
  - project:custom-rules # Project-specific ruleset

# Toolsets to enable
toolsets:
  - internal:core # Built-in toolset
  - development-tools # Global custom toolset
  - project:my-tools # Project-specific toolset

# Trusted root directories
roots:
  - ~/projects/work
  - ~/projects/personal

# UI preferences
show_notifications: true
sticky_notifications: false

見る docs/configuration.md 包括的な構成ドキュメント用。

Claude Composerは、構成の環境変数をサポートしています。

• CLAUDE_COMPOSER_CONFIG_DIR – 構成ディレクトリの場所をオーバーライドします
• CLAUDE_COMPOSER_NO_NOTIFY – すべての通知を無効にします
• FORCE_COLOR – 色の出力を制御します

見る docs/Environment-Variables.md 詳細については。

ルーツは、Claude Codeの最初の信頼プロンプトが自動的に受け入れられる信頼できる親ディレクトリを定義します。見る docs/rootsconfig.md 詳細な構成オプション。

roots:
  - ~/projects # Trust direct children of ~/projects
  - /tmp/sandbox # Trust direct children of /tmp/sandbox
  - $WORK_DIR/repos # Environment variable expansion supported

ディレクトリでClaude Composerを開始するとき 親 ルーツにリストされています：

• 「このフォルダーのファイルを信頼していますか？」プロンプトは自動的に受け入れられます
• 自動受容確認プロンプトは抑制されます

重要：ルートディレクトリの直接の子供のみが信頼されています。たとえば、if ~/projects 次に、ルートです ~/projects/my-app 信頼されていますが、 ~/projects/my-app/src そうではありません。

ルールセットは、どの許可ダイアログが自動的に受け入れられるか拒否されるかを制御します。それらは、クロードコードとシステムとの相互作用を細かく制御します。

ルールセットは、定義するYAMLファイルです。

• 自動的に受け入れるか拒否するダイアログ
• ファイルおよびディレクトリ操作のパスベースのルール
• パターンベースのコマンドフィルタリング
• WebリクエストのドメインAllowlists

Claude Composerには、3つの組み込みルールセットが含まれています。見る docs/internal-rulesets.md 各ルールセットの詳細については。

最大セキュリティ – すべてのダイアログには、手動で確認が必要です。操作の自動受け入れはありません。

バランスの取れたアプローチ – グローバルな操作とWebリクエストの確認を要求しながら、プロジェクトレベルの操作（ファイル編集、作成、バッシュコマンド）を自動的に受け入れます。

最大自動化 – グローバルファイル操作やWebリクエストなど、確認なしですべての操作を受け入れます。注意して使用してください。

見る docs/rulesets.md 詳細なルールセットドキュメントとカスタムルールセットの作成については。

プロジェクトにカスタムルールセットを作成します .claude-composer/rulesets/ ディレクトリ：

# .claude-composer/rulesets/backend.yaml
name: backend
description: Rules for backend development

# Accept file operations with path restrictions
accept_project_edit_file_prompts:
  paths:
    - 'src/**/*.js'
    - 'src/**/*.ts'
    - 'test/**'
    - '!**/*.env'

accept_project_bash_command_prompts: true
accept_fetch_content_prompts: false

# Use internal ruleset
claude-composer --ruleset internal:cautious

# Use global custom ruleset (no prefix)
claude-composer --ruleset my-workflow

# Use project ruleset
claude-composer --ruleset project:backend

# Chain multiple rulesets (later rules override earlier)
claude-composer --ruleset internal:cautious --ruleset my-defaults --ruleset project:backend

カスタムルールセットにより、自動化を細かく制御できます。見る docs/rulesets.md 完全な構文と例については。

ツールセットは、ClaudeがMCP（モデルコンテキストプロトコル）サーバーを使用および構成できるツールを制御します。彼らは、プロジェクトごとまたはグローバルベースでクロードの能力を管理する柔軟な方法を提供します。

ツールセットは、次のことを定義するYAMLファイルです。

• Claudeが使用できるツール
• Claudeの使用が明示的にブロックされるツール
• 追加のツール機能のMCPサーバー構成

Claude Composerには、組み込みのツールセットが1つ含まれています。見る docs/internal-toolsets.md 詳細については。

Context7ドキュメントツールへのアクセスを提供し、Claudeが最新のライブラリドキュメントを取得できるようにします。

プロジェクトにカスタムツールセットを作成します .claude-composer/toolsets/ ディレクトリ：

# .claude-composer/toolsets/dev-tools.yaml
allowed:
  - Read
  - Write
  - Edit
  - MultiEdit
  - Bash

disallowed:
  - WebSearch

mcp:
  my-server:
    type: stdio
    command: node
    args:
      - ./tools/mcp-server.js

# Use internal toolset
claude-composer --toolset internal:core

# Use global custom toolset (no prefix)
claude-composer --toolset my-tools

# Use project toolset
claude-composer --toolset project:dev-tools

# Chain multiple toolsets
claude-composer --toolset internal:core --toolset project:backend-tools

ツールセットは、ClaudeがMCPサーバーを使用および構成できるツールを制御します。見る docs/toolsets.md 完全なドキュメントについて。

見る docs/cli-reference.md 完全なコマンドラインドキュメント。

• --ruleset – 指定されたルールセットを使用します（複数回使用できます）
• --toolset – 指定されたツールセットを使用します（複数回使用できます）
• --ignore-global-config – グローバル構成ファイルを無視します

• --dangerously-allow-in-dirty-directory – コミットされていないGitの変更で実行できるようにします
• --dangerously-allow-without-version-control – 外部バージョン制御を許可します
• --dangerously-suppress-automatic-acceptance-confirmation – 確認プロンプトをスキップします

• --show-notifications / --no-show-notifications – デスクトップ通知を有効/無効にします
• --sticky-notifications / --no-sticky-notifications – 却下されるまで通知を維持します
• --show-work-complete-notifications / --no-show-work-complete-notifications – 作業完了通知を表示/非表示にします

• --quiet -Preflightメッセージを抑制します
• --allow-buffer-snapshots -Ctrl+Shift+S端子スナップショットを有効にします
• --log-all-pattern-matches – ログパターンが一致します ~/.claude-composer/logs/

新しい構成ファイルの初期化：

# Create global config
claude-composer cc-init

# Create project config
claude-composer cc-init --project

# Specify ruleset during init
claude-composer cc-init --use-cautious-ruleset

オプション：

• --project – 現在のディレクトリに構成を作成します
• --use-yolo-ruleset -Yoloルールセットを使用します
• --use-cautious-ruleset – 慎重なルールセットを使用する（推奨）
• --use-safe-ruleset – 安全なルールセットを使用します
• --use-core-toolset / --no-use-core-toolset – コアツールセットを有効/無効にします

認識されていないすべてのオプションは、クロードコードに渡されます。

# These go to Claude Code
claude-composer --model claude-3-opus-20240229
claude-composer --print
claude-composer --help  # Shows both claude-composer and claude help

どの通知が表示されるかを微調整します：

# Control specific notification types
claude-composer --no-show-edit-file-confirm-notify
claude-composer --show-accepted-confirm-notify
claude-composer --sticky-work-complete-notifications

見る docs/notifications.md 詳細な通知設定用。

貢献は大歓迎です！お願いします：

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature））
3. あなたの変更をコミットします（git commit -m 'Add amazing feature'））
4. 枝に押します（git push origin feature/amazing-feature））
5. プルリクエストを開きます

このプロジェクトでは、NPMとGitHubを介して自動リリースを使用しています。見る docs/releaseprocess.md 詳細なリリース手順については。

クイックリリースコマンド：

npm run release:patch  # Bug fixes (0.1.0 → 0.1.1)
npm run release:minor  # New features (0.1.0 → 0.2.0)
npm run release:major  # Breaking changes (0.1.0 → 1.0.0)