Chaos and Order

💡 왼쪽 원문을 읽으면서 오른쪽에 따라 써보세요. Tab 키로 힌트를 받을 수 있습니다.

なぜチームで 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 は、確認なしで使うと最も危険になりやすい。