- なぜチームで Claude Code を見るべきか
- Claude Code でできること
- settings は階層で管理する
- memory もスコープで分ける
- subagents はコンテキスト分離に役立つ
- hooks は強力だが、最初に必ず理解する
- チーム導入では shared memory と policy が重要
- GitHub 中心の背景実行型エージェントとの違い
- よくある失敗
- おすすめの導入順
- References
なぜチームで Claude Code を見るべきか
Claude Code は Anthropic の agentic coding tool で、ターミナルの中で動く。ここが本質だ。新しいチャット画面を足すのではなく、開発者がすでに使っているターミナルに入り込み、ファイル編集、コマンド実行、コミット作成、そして claude -p によるスクリプト的実行までこなせる。
つまり、会話型アシスタントというより、ターミナル作業に接続された実行型エージェントに近い。
Claude Code でできること
公式文書では、Claude Code は次のことができる。
- ファイルを直接編集する
- コマンドを実行する
- コミットを作成する
- MCP で外部ツールにつなぐ
claude -pでスクリプトのように呼び出す
このため、単発の質問応答よりも、実際の作業フローに向いている。ローカル検証、リファクタ、lint 修正、PR 準備と相性がよい。
settings は階層で管理する
Claude Code の設定は階層構造になっている。
~/.claude/settings.jsonはユーザー全体の設定.claude/settings.jsonはチームで共有するプロジェクト設定.claude/settings.local.jsonは個人用のローカル設定
この構成の利点は、チーム規約と個人の好みを分離できることだ。共有すべき内容はリポジトリに置き、実験的な変更はローカルに閉じ込められる。
memory もスコープで分ける
memory の文書も重要だ。
./CLAUDE.mdはプロジェクト memory~/.claude/CLAUDE.mdはユーザー memory- enterprise policy memory は組織全体に適用される
実務では ./CLAUDE.md にプロジェクト構造、ビルド方法、テストコマンド、よくある落とし穴、レビュー基準を書いておくと効果が高い。個人用 memory は自分のショートカットや好みだけに絞ると整理しやすい。
subagents はコンテキスト分離に役立つ
Claude Code の subagents は別々の context window を持ち、特定の tools を設定できる。大きなリポジトリではとても有効だ。
- レビュー専用 subagent
- テスト作成専用 subagent
- ドキュメント専用 subagent
- 移行作業専用 subagent
こう分けると、1 つのセッションに何でも詰め込んで文脈が濁る問題を減らせる。
hooks は強力だが、最初に必ず理解する
hooks は実行中の特定ポイントで shell command を走らせられる。検証、ログ記録、セキュリティチェック、ワークフロー自動化に便利だ。ただし、公式文書もはっきり注意している。追加する前に hook command をレビューし、理解する必要がある。
基本原則は次の通りだ。
- 追加前に内容を読む
- スクリプトは絶対パスにする
- 機密ファイルは除外する
- 検証用 hook と破壊的操作を混ぜない
hooks は自由な自動化ではなく、管理された自動化として扱うべきだ。
チーム導入では shared memory と policy が重要
Claude Code をチームでうまく運用するには、機能よりも運用ルールが先だ。
./CLAUDE.mdにプロジェクト基準を書く- 共有設定は
.claude/settings.jsonに置く - 個人設定は
.claude/settings.local.jsonに分ける - 危険なコマンドは permissions か deny で制限する
- hooks はレビュー手順を通してから使う
- 繰り返し作業は subagent に分ける
この順番なら、チーム全体で共通の土台を持ちつつ、個人の試行錯誤も安全に保てる。
GitHub 中心の背景実行型エージェントとの違い
Claude Code はターミナル優先だ。開発者がすでにいる場所で直接働く。一方で GitHub Copilot cloud agent は GitHub 優先で、Issue、ブランチ、PR、レビューの流れの中で作業する。
違いはかなり明確だ。
- ローカルで即座に修正して確認したいなら Claude Code
- GitHub の中で非同期に任せたいなら cloud agent
- ポリシー、設定、hooks を細かく管理したいなら Claude Code が有利
競合というより、開発フローの別々の地点に置く道具だと考えるのが実用的だ。
よくある失敗
導入時の失敗はだいたい似ている。
CLAUDE.mdを個人メモとしてしか使わない- 共有設定とローカル設定を混ぜる
- 1 つの大きなセッションにすべてを任せる
- hooks を確認せず追加する
- MCP の権限を早く広げすぎる
特に hooks は、確認なしで使うと最も危険になりやすい。
おすすめの導入順
CLAUDE.mdでプロジェクト基準を決める- 共有設定とローカル設定を分ける
- 繰り返し作業を subagent に分割する
- 必要な場合だけ MCP を追加する
- hooks は検証用途から始める
- 危険なコマンドと機密ファイルを明示的に制限する
この順番なら、ターミナル自動化の速さを保ちながら、チームの安全性も守れる。