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

Claude Code の安全設定、最初に見る5項目｜settings.json・.claudeignore・API キー（Windows・コードを書かない人向け）

    なお｜手順書・マニュアル作成

    ※ 個人の体験記録です。Anthropic の公式情報ではありません。

    Claude Code を入れたけれど、「設定はどこを見ればいいの？」「.claudeignore に書いたのに大丈夫？」と不安な方へ。

    コードを書けない私が、Windows 11 でアプリを作りながら実際にハマったことから、最初に見ておきたい5項目をまとめました。どれも、自分の PC で確かめたことです（Claude Code 2.1.309〜2.1.311、2026年10月）。

    最初に見る5項目

    赤＝すぐ直す、黄＝理由がなければ直す、緑＝問題なし、の目安です。

    1. 起動したときのモード
    目安：何も書いていない → 黄
    どうするか：慣れるまでは .claude/settings.json に "defaultMode": "default" を書く

    2. .env（パスワードなどのファイル）を読ませない設定
    目安：.claudeignore だけ → 赤
    どうするか：設定ファイルの禁止リスト（deny）に Read(.env*) などを書く

    3. Windows で「Bash の禁止」だけを書いていないか
    目安：Bash だけ → 黄
    どうするか：同じ禁止を PowerShell(...) でも書く

    4. PC 全体に API キーが入っていないか
    目安：入っている → 黄
    どうするか：使う理由がなければ、アプリのフォルダの .env.local だけに置く

    5. .gitignore に .env が入っているか
    目安：入っていない → 赤
    どうするか：.env* を .gitignore に足す

    ※ この5項目は全部の点検ではありません。これで安全になるわけでもありません。最初に見る入口として使ってください。

    1. 起動したときのモード

    何も設定しないで Claude Code を起動すると、ファイルの書き換えやコマンドを AI が自分で判断して進めるモード（auto）で始まりました。公式ドキュメント（Permission modes）によると、ターミナル版は v2.1.283 から、これが最初の設定になっています。なお、プロジェクトの設定に auto を書いても無視されますが、default は効きます。

    慣れるまでは、1つずつ確かめながら進めるほうが安心です。設定ファイルの書き方は、1〜3をまとめて下の「設定ファイルの見本」に載せています。

    2. .claudeignore は効かない

    パスワードなどが入った .env を読ませないように、講座で見かけた .claudeignore を作っていました。でも、公式ドキュメント（Permissions）では「.claudeignore には効果がない。読ませたくないものは Read の禁止に書く」とされていました。

    いまは、設定ファイルの禁止リスト（deny）に Read(.env*) と Read(**/.env*) を書いています（下の見本に入っています）。

    私の試験用フォルダ（もっと多くの禁止を入れた状態）では、わざと許可を付けても、.env を読む操作やコマンド（Get-Content .env・cat .env）は止まりました。この2行だけで同じになるかは、版や書き方でも変わるので、中身がダミーの .env を作って自分で確かめてください。本物のパスワードで試さないでください。

    3. Windows で Bash の禁止だけを書くと、PowerShell の道具が消える

    ネットの例を見て、禁止リストを Bash(...) の形だけで書いていました。すると、Windows の主な道具である PowerShell が、何の警告もなく使えなくなっていました。

    公式ドキュメント（Tools reference）によると、Git for Windows を入れると一緒に入る Git Bash がある PC では、Bash の禁止を書くと PowerShell の道具がオフになります。PowerShell 用の禁止も書けば、オンのままです。

    設定ファイルの見本（1〜3をまとめたもの）

    アプリのフォルダの中に .claude というフォルダを作り、その中に settings.json という名前で保存します。

    {
  "permissions": {
    "defaultMode": "default",
    "deny": [
      "Read(.env*)",
      "Read(**/.env*)",
      "Bash(rm *)",
      "PowerShell(Remove-Item *)"
    ]
  }
}

    • メモ帳で保存するときは「ファイルの種類：すべてのファイル」を選び、名前の最後が .txt になっていないか確かめてください

    • すでに settings.json がある人は、ファイルを丸ごと置き換えないでください。 permissions の中の deny の [ ] に行を足します。行と行の間のカンマが抜けたり余ったりすると、設定全体が読まれなくなります

    • 書いたら Claude Code を起動し直します

    • 削除の禁止（rm・Remove-Item）は例です。実際には、入れる・消す・送る操作ごとに、似たコマンドまで並べる必要があります

    4. PC 全体に API キーを入れていないか

    環境変数（PC に覚えさせておく設定の値）の ANTHROPIC_API_KEY が PC 全体に入っていると、プランでログインしていても、API の従量課金が使われることがあります（公式ドキュメントで確認）。

    PowerShell に次の1行を貼ると、キーの中身は出さずに「あり／なし」だけを表示します。

    foreach ($s in 'Process','User','Machine') { if ([Environment]::GetEnvironmentVariable('ANTHROPIC_API_KEY', $s)) { "$s：あり" } else { "$s：なし" } }

    3行とも「なし」なら、この項目は問題ありません。「あり」なら、自分で入れた理由があるかを確かめてください。

    5. .gitignore に .env が入っているか

    GitHub を使っているなら、.gitignore に .env* が入っているかを見てください。入っていないと、パスワードの入ったファイルを公開してしまうことがあります。見本のファイル（.env.example）を上げたい人は、!.env.example の行も足します。

    すでに上げてしまったら、まずキーを発行元ですぐに無効にして作り直してください。公開されたリポジトリのキーは、短い時間で悪用されることがあります。.gitignore に足すだけでは、上げたファイルも過去の記録も消えません。

    残りの点検について

    この5項目は、私が使っている点検の一部です。

    全部で13項目を、自分の Claude Code に貼るだけで赤・黄・緑の表にしてくれる指示文と、新しいアプリのフォルダに置く初期設定のひな形、実際にハマった19件のつまずき解決録を、わざと許可を付けて禁止が効くか確かめた試験の記録つきで、有料記事（980円）にまとめています。

    コードを書かない私が使っている AI の係（エージェント）の話は、連載にしています。

    連載の1回目「意地悪なテスト係」：https://note.com/nao_mojiokoshi/n/n87806827a315

    ※ Claude Code に対応した非公式の記事で、Anthropic とは関係ありません。Claude は Anthropic の商標です。

    ※ Windows 11、Claude Code 2.1.309〜2.1.311（2026年10月）で確かめた内容です。版が変わると結果が変わることがあります。安全を保証するものではありません。

    あなたへのおすすめ