trailofbits/claude-code-config

何を解決するか

このプロジェクトは、Claude Code の使用に向けた意図的なデフォルト、構成、ワークフローのセットを提供します。特に、セキュリティ監査や研究など、高セキュリティ環境に特化しています。自律型AIエージェントを高スループットで実行（権限プロンプトをバイパス）しながらも、サンドボックス化と厳格なガードレールによって安全性を維持するという一般的な課題に対処します。

仕組み

このプロジェクトは、Claude Code の制御と最適化に多層的なアプローチを採用しています：

• サンドボックス化と隔離： macOS では Seatbelt、Linux では bubblewrap を活用し、開発コンテナやリモートクラウドドロップレットの構成を提供することで、エージェントをホストシステムから隔離します。
• フック： PreToolUse および PostToolUse フックを使用して、リアルタイムでツール呼び出しをインターセプトします。これにより、rm -rf のような危険なコマンドをブロックしたり、メインブランチへの直接プッシュを防ぐなどの特定のワークフローを強制したりできます。エラー情報をエージェントにフィードバックすることで実現します。
• メモリ管理： 一般的な指示用のグローバル CLAUDE.md ファイルと、パススコープのルール（例：rules/python.md）を活用。エージェントが特定のファイルタイプとやり取りする際のみルールが読み込まれるため、コンテキストウィンドウの肥大化を抑えることができます。
• カスタムツール： 端末内に直接モデル使用状況、セッションコスト、プロンプトキャッシュヒット率を追跡するカスタムステータスラインスクリプトを含んでいます。

対象ユーザー

セキュリティ、監査可能性、効率性を重視して、Claude Code をプロフェッショナルなワークフローに統合したい開発者、セキュリティ研究者、チーム向けです。

主な特徴

• セキュリティガードレール： SSHキー、クラウド資格情報、暗号ウォレットなど、機密性の高いファイルへのアクセスをブロックする事前構成済みの拒否ルール。
• --dangerously-skip-permissions ワークフロー： 権限バイパスモードと厳格なサンドボックス化を組み合わせた推奨設定。エージェントのスループットを最大化します。
• コンテキスト効率的なルール： パススコープのルールにより、エージェントが関連する言語固有のガイダンスのみを受信するようにします。
• 監査ログ： CLIツールの変更やbashコマンドログに対する監査トレースを生成するフックの例を提供しています。
• ローカルモデル対応： LM Studio を通じてローカルモデルで Claude Code を実行するための構成とシェルエイリアスを提供しています。