settings.json

なぜ、許可を押す前に「読ませないもの」を決めるのか

Claude Code は、作業の前に「この操作をしてよいか」とたずねます。たずねられるたびに許可を押していると、だんだん中身を読まなくなります。そのとき、秘密のファイル（パスワードや API キー（外部のサービスを使うための合言葉）が書かれた .env など）を読む操作を、うっかり許可してしまうかもしれません。

一度読まれた内容は、会話の一部として Anthropic に送られ、取り消せません。消せるのは画面の表示だけです。押し間違いを減らす努力より、読む操作そのものを最初から禁止しておくほうが確実です。禁止を書いておくのは数分で、書いていなかった期間の分は取り戻せません。

図の見方：上の段は、許可を押し続けて慣れた場合です。秘密のファイルを読む操作をうっかり許可し、会話に載って取り消せなくなります。下の段は、先に禁止を書いておいた場合です。許可の画面が出る前に止まり、読まれずに済みます。

設定は、次の5段に重なっています。上にあるほど強く、同じ項目が重なっていたら上が勝ちます。

1. 管理設定（会社や学校の管理者が決める。個人で使うなら、ふつうは無い）
2. 起動するときに渡す設定（その1回の起動だけ）
3. 自分だけのプロジェクト設定：作業フォルダの .claude/settings.local.json
4. 共有するプロジェクト設定：作業フォルダの .claude/settings.json（git ＝ファイルの変更履歴を管理し共有する仕組み、でチームに配る）
5. ユーザー設定：ホームフォルダ（自分のユーザー名のフォルダ）の ~/.claude/settings.json（この Mac のすべての作業に効く）

個人で使うときに触るのは、3・4・5の3つです。「どの作業でも効かせたい自分のルール」は5、「このフォルダだけ」は4、「このフォルダだけで、自分だけ」は3に書きます。

.claude のように名前の先頭が点のフォルダは、Finder（Mac でファイルを見るアプリ）では隠されています。Finder のメニュー「移動」→「フォルダへ移動」を選び、~/.claude と入力すると開けます。ファイルを自分で編集するのが不安なら、AI に「~/.claude/settings.json に、次の設定を足して」と頼むこともできます。ただし、書き換えの許可の表示は、必ず中身を読みます。

秘密のファイルを読ませない設定は、permissions の deny（禁止）に書きます。ユーザー設定（~/.claude/settings.json）に書けば、どの作業でも効きます。次が書き方の例です。

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(**/.env)",
      "Read(./secrets/**)"
    ]
  }
}

Read(./.env) は作業フォルダの直下の .env、Read(**/.env) は作業フォルダの中のどの深さの .env も、Read(./secrets/**) は secrets フォルダの中のすべてを指します。自分の秘密の置き場所に合わせて、同じ形で足していきます。すでに設定ファイルがあるときは、中身を消さず、deny の欄にだけ足します。

許可の判断は、禁止 → 確認 → 許可の順に見られ、禁止が当たった時点で止まります。どの層（ユーザー・プロジェクト）に書いた禁止でも、別の層の許可では覆せません。

つまずき集（症状から引く）