メインコンテンツへスキップ
見出し画像

Claude Codeをチームに「そのまま」渡す前に知っておく設定の基本

    「Claudeをそのまま使ってください」。設定を何も決めずに、メンバーへそう言って渡していた時期が約1年ありました。

    その間に、AIが .env(パスワードなどを書いておくファイル)を読みました。フォルダやファイルの削除事故も起きました。逆に、確認のダイアログが多すぎて使われなくなった人もいます。

    その後、約40人のチームへ設定を配る側に回りました。

    メンバーに渡すと事故や確認疲れが心配な人に向けて、設定の置き場所と優先順位、配る前の確かめ方をまとめます。

    「Claudeをそのまま使って」と渡していた1年に起きたこと

    当時起きていたのは、事故と確認疲れの両方です。

    事故のほうは、.env を読まれたことと、フォルダ・ファイルの削除です。確認疲れのほうは、もう少し地味でした。細かいことをいちいち聞かれて、そのたびに手が止まる。業務が止まる場面が多く、だんだん使われなくなりました。

    新人に会社のPCを「そのまま使って」と渡す場面に近いと思っています。PCなら、共有フォルダの権限や見てはいけないサイトが、渡す前に決まっています。Claude Codeは何も決めずに渡すと、触ってよい範囲を毎回本人に聞くか、聞かずに触るかのどちらかに寄ります。.env を読まれたのは、聞かずに触った側でした。

    それを直す手段が設定の配布だ、というのが私の結論です。

    設定ファイルは「誰に効くか」で置き場所が違う

    Claude Codeの設定は、会社全体、プロジェクト、個人のどこに書くかで、効く相手と強さが変わります。

    管理設定は、会社の管理者が配るものです。利用者は原則として自分のファイルで上書きできませんが、一部の制限系の項目では、下位の厳しい値が優先される例外があります。

    プロジェクト設定は、リポジトリの中の .claude/settings.json です。gitにコミットしておけば、cloneした全員に届きます。私のチームでは、元の設定から許可するドメインを業務で使うものに合わせ、テストやビルドのコマンドの許可をリポジトリごとに合わせて配りました。

    ユーザー設定は、各自のホームにある .claude/settings.json で、その人の全プロジェクトに効きます。

    個人用のプロジェクト設定 .claude/settings.local.json もあり、確認ダイアログで「今後確認しない」を選んだ許可はここに保存されます。

    就業規則・部署のルール・個人のメモ、の関係で考えると分かりやすいです。部署のルール(プロジェクト設定)は、個人のメモ(ユーザー設定)より強い。ここまでは、たとえどおりに動きます。

    画像

    優先順位は、上から管理設定、コマンドラインで渡した設定、個人用プロジェクト設定、共有プロジェクト設定、ユーザー設定です。同じ項目が複数の場所にあれば、上の値が使われます。

    私が実際に使ったのは、このうち2つでした。リポジトリで共有するプロジェクト設定と、claude.ai の管理画面から配る管理設定です。

    「上書き」ではなく「足し算」になる設定がある


    画像

    先ほどのたとえが崩れるのが、ここです。

    許可(allow)や禁止(deny)のようなリストは、上の値で置き換わりません。複数のファイルに書いた分が、全部合わさります。会社が配った許可と、個人が足した許可は並んで効きます。管理設定で allowManagedPermissionRulesOnly を指定したときだけ、個人の追加が無視されます。

    一方で、禁止はどの階層の許可でも解除できません。ルールは禁止、確認、許可の順に見られ、最初に当てはまったもので決まるからです。

    ただし、コマンドの禁止は書いた形の文字列にしか当たらず、書き換えた形のコマンドは止まりません。削除を確実に止める手段は、実践編で扱います。

    配ったあと、メンバーが各自で許可を足していました。私はそれを止めませんでした。

    禁止は管理設定で固めてあったので、足し算で外れることはありません。危ない側は管理設定で固定し、便利にする側の足し算は各自に任せる、という分け方です。

    配ったのに効かない、の典型

    配った直後、メンバーから「設定が効いていない」「確認が減らない」と言われました。

    まず分かったのは、そのメンバーがフォルダを信頼していなかったことです。共有プロジェクト設定の許可は、各自がそのフォルダを信頼するまで効きません。禁止と確認のほうは、信頼の前からすぐ効きます。守りは効いているのに、楽にする設定だけが止まっている状態です。本人からすると「何も変わっていない」に見えます。

    ルールの書き方も間違っていました。Bash(npm test) と書いていたため、引数付きの実行に一致せず確認が出続けました。WebFetch(domain:...) のドメインの指定も違っていました。

    何が読み込まれたかは、Claude Codeの中で /status を打つと、Setting sources の行で確かめられます。ただ、どのファイルがどの値を出したかまでは表示されません。書き方の誤りのような中身の間違いは、別の道具で見る必要があります。許可と禁止のルールなら、/permissions で出どころのファイルまで見られます。

    配る前に claude doctor を通す。ただしキー名の打ち間違いは見つからない

    claude doctor は、ターミナルで打つと、会話を始めずに設定とインストールを点検して結果を表示するだけのコマンドです。何かを書き換えることはありません。

    これを配る前に通しておく理由があります。設定ファイルの一部の項目が不正でも、Claude Codeはその項目だけを無視して、残りを有効のまま動きます。止まらないので、壊れていても気づきにくいのです。

    2026-11-10に、手元の Claude Code v2.1.289 で試しました。

    わざと値を間違えた設定、たとえば defaultMode に 123、sandbox.enabled に "yes" を入れたものは、Invalid settings として出ました。修正案も一緒に表示されます。

    ところが、キー名を permisions や enabeld と打ち間違えたものは、何も言われませんでした。

    公式の説明では、doctor は型と値の誤りを報告するとされています。キー名の打ち間違いが素通りするのは、私の手元での検証結果です。doctor が何も言わなかったからといって、設定が正しいとは限りません。

    なので、キー名は公式の設定一覧と1つずつ見比べてください。配布前チェックとしての手順は実践編で扱います。

    管理設定を会社のPCへ届ける経路(MDM・claude.ai管理画面・ファイル配置)

    管理設定の届け方は、主に次のとおりです。

    • claude.ai の管理画面: Teams か Enterprise のプランで、Owner か Primary Owner の役割の人が設定する。私のチームはここから配った

    • MDM: 会社が社員の端末へ設定やアプリを一括で配り、勝手に外されないようにする仕組み

    • ファイル配置: OSごとに決まったフォルダに managed-settings.json を置く。macOSなら /Library/Application Support/ClaudeCode/、LinuxとWSLなら /etc/claude-code/、Windowsなら C:\Program Files\ClaudeCode\

    管理設定が複数の経路から同じPCに届くと、既定では最も順位の高い1経路だけが使われ、残りは無視されます。無視されたことの警告は出ないので、/status で確かめます。なお、プロジェクト設定はこの話とは別の階層です。管理画面とプロジェクト設定を併用しても、片方が無視されることはありません。

    管理画面からの配布には弱点もあります。起動したあと設定の取得が終わるまでの短い間は、制限が効きません。MDMで端末を管理しているなら、端末側で配るほうが保証は強い、と公式も説明しています。

    管理設定でも止められない範囲があります。端末の管理者権限を持つ人は、管理設定のファイル自体を書き換えられます。Claude Code以外のツールにも、管理設定は効きません。

    MDMで端末を管理していれば端末側、していなければ管理画面が目安です。私の場合は、管理画面とプロジェクト設定の組み合わせで配りました。

    次に読む1本

    配ってから4か月、削除事故は0件でした。導入前の1年では約5件です(概数で、正式な集計はしていません)。確認待ちが減り、AIに任せられるようになったのがいちばんの手応えです。

    実践編では、確認をどこまで減らすかを、配布用の設定と配る前の点検の形にまとめています。


    参考リンク


    関連記事

    リスクを止める設定と確認を減らす設定を、配布用の形と配る前の点検にまとめた実践編です。

    関連記事|マルチファイル実装が崩れないコンテキスト設計は、こちらにまとめました

    関連記事|Claude CodeのSkills全訳に挑んだ記録は、こちらにまとめました

     
     
    経歴:宇宙学→機械学習→生成AI(現在)→起業(未来) 実績:Signateグランドマスター / 総合7位。 「再現性ある成果を出し続けるエンジニア」になるための 実践知を発信しています。 特に生成AIツールの活用・AI実装を発信しています。

    あなたへのおすすめ