Claude Codeのチームでの設定共有方法(.claude/settings.json)

チームでClaude Codeを使う場合、ルールや確認体制といった運用面の話は Claude Codeをチーム開発で使う際の注意点とベストプラクティス で紹介しました。この記事では、それを実現する具体的な仕組みである.claude/settings.jsonの共有方法にフォーカスします。

置き場所ごとの優先順位の基本は settings.json完全リファレンス を先にご覧ください。

Gitで共有する設定・しない設定を分ける

チーム開発では、次のようにファイルを分けて運用します。

• .claude/settings.json: チーム全員に適用したいルール。リポジトリにコミットする
• .claude/settings.local.json: 個人の好みの設定。.gitignoreに追加してコミットしない

.claude/settings.jsonに個人的な好みの設定(確認を極端に減らす等)を混ぜてコミットしてしまうと、他のメンバーの環境にまで影響してしまいます。「チーム共通で守ってほしいルールか、自分だけの好みか」を意識して振り分けることが基本方針になります。

共有すべき設定の例

• permissionsのdeny: 機密ファイルへのアクセス禁止、危険なコマンドの禁止など、チーム全員が守るべき安全策(permissions設定 全パターン解説 参照)
• hooks: フォーマッタ・リンターの自動実行など、成果物の品質を揃えるための仕組み(hooks設定方法とユースケース 参照)
• チーム共通のカスタムコマンド・サブエージェント: .claude/commands/や.claude/agents/配下のファイルも同様にリポジトリで共有できる

設定変更のレビュー体制

.claude/settings.jsonの変更は、通常のコードと同じようにプルリクエストを通すことをおすすめします。特にpermissionsのallowを緩める変更は、意図しない自動実行を増やすことにつながるため、通常のコード変更以上に慎重にレビューするとよいでしょう。

新メンバーのオンボーディング

新しくプロジェクトに参加したメンバーは、リポジトリをクローンした時点で.claude/settings.jsonとCLAUDE.mdが自動的に適用されます。オンボーディング資料に「Claude Codeの追加設定は不要、リポジトリの設定がそのまま使われる」と明記しておくと、初日から迷わず同じルールで作業を始められます。

まとめ

チームでの設定共有は、「何を.claude/settings.jsonに入れ、何を個人のsettings.local.jsonに留めるか」という線引きと、変更のレビュー体制さえ決めてしまえば、あとはGitの通常の運用に乗せられます。特別なツールを追加する必要はありません。

チームでの導入・設定設計は、「ClaudeCode ロケットスタート」でもご相談いただけます。