Claude Code の設定方法は？settings.json の場所とおすすめ設定

やっほー、ぼくてんびん丸！

「Claude Code の設定ってどこに書くの？」って調べに来たきみへ、先に答えを言うね。

Claude Code の設定は、settings.json という JSON のファイルに書くんだ。 自分のぜんぶのプロジェクトに効かせるなら ~/.claude/settings.json、チームで共有するならプロジェクトの .claude/settings.json、そのプロジェクトで自分だけなら .claude/settings.local.json だよ。日本語で使う人がまず入れたいのは、返事を日本語にする設定と、APIキーの入ったファイルを読ませない設定の2つ。

ここに書いた設定名と既定値は、ぜんぶ2026年10月23日に Claude Code の公式ドキュメントで確かめたものだよ。

設定ファイルはどこ？4つの場所と使い分け

Claude Code が読む設定ファイルは4種類あって、どのファイルに書くかで「誰に効くか」が決まるんだ。

~ はホームフォルダのことで、Windows なら %USERPROFILE%\.claude になるよ。環境変数 CLAUDE_CONFIG_DIR を設定すると、置き場所を別のフォルダに変えられるんだ。

インストールしただけでは、どのファイルも作られないよ。~/.claude/settings.json は、/config でテーマなどを変えたときに Claude Code が作る。.claude/settings.local.json は、確認画面で「Yes, and don't ask again」（今後は聞かない）を選んだときに作られて、そのとき git の対象からも自動で外してくれるんだ。自分の手で作ったときは、.gitignore に足すのを忘れないでね。

【2026年11月8日 追記】 自動で外すのは、その PC 全体の git の除外リスト（~/.config/git/ignore など）だけで、リポジトリの .gitignore には書かれない。別の PC で clone したときや、後から git 管理にしたフォルダでは外れないので、リポジトリの .gitignore にも .claude/settings.local.json を足しておこう。「今後は聞かない」で承認したコマンドがパスワードごとこのファイルに残り、公開 GitHub で見つかった件は settings.local.json の情報漏洩の記事にまとめたよ。

もう1つ、~/.claude.json（.claude フォルダの中ではなく、ホームフォルダ直下のファイル）があるけど、これは Claude Code が自分用に書くファイルで、アカウントや MCP の接続、プロジェクトの信頼の記録が入っている。自分で編集しなくていいと公式に書いてあるよ。

settings.json とは？

settings.json は、Claude Code の動き方を決める設定ファイルだよ。 どのモデルで始めるか、何を確認なしで動かしてよいか、どのファイルを読ませないか、を「"項目": 値」の形で書く。たとえるなら、新しく来たアシスタントに渡す「やっていいこと・だめなことの紙」なんだ。

書き方はこんな感じ。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "language": "japanese",
  "permissions": {
    "allow": ["Bash(npm run lint)", "Bash(npm run test *)"],
    "deny": ["Read(./.env)", "Read(./.env.*)"]
  }
}

1行目の $schema は、VS Code や Cursor で項目名の入力補完と書き間違いのチェックを効かせるための行だよ。

ここで一番つまずきやすいのは、JSON がとても厳しいこと。 // のメモ書きを入れたり、最後の項目のあとにカンマを残したりすると、それだけで文法エラーになって、次に起動したときに「Settings Error」と出るんだ。メモを残したいときは、別のファイルに書いておこう。

まず入れたいおすすめ設定は？

公式の見本ファイルは「推奨の土台ではない」と断ったうえで、個人用・チーム用・組織用の例を出している。そこから、日本語で使う人に効くものを選んだよ。

language は、日本語で使うなら真っ先に入れたい項目だよ。Claude Code はこの値を「いつもこの言葉で返事して」という指示としてそのまま渡すので、"japanese" と書けば日本語になる。値の確認はしないから、つづりを間違えると、そのまま間違った名前で渡されるんだ。

cleanupPeriodDays は見落としがちな項目なんだ。既定の30日を過ぎた会話は、知らせなしで消えて /resume の一覧に出なくなる。長く残したいなら 3650 のように大きな値にしよう（0 はエラーになる）。

権限モードはどれにする？6つのモードの違い

権限モードは、Claude が何を確認なしでやってよいかの基本線だよ。ターミナルでは Shift+Tab、VS Code では画面のモード表示、デスクトップアプリではモードの切り替えから変えられる。

知っておきたいのは、何も決めていないときの始まり方が変わったこと。 v2.1.283 以降、ターミナルと VS Code のセッションは、何も設定していないと auto モードで始まるんだ。毎回自分で確かめたいなら、~/.claude/settings.json にこう書いておけば Manual モードで始まるよ。

{
  "permissions": {
    "defaultMode": "default"
  }
}

1つ落とし穴がある。プロジェクトの .claude/settings.json や settings.local.json に "auto" や "bypassPermissions" を書いても効かないんだ。誰かが配ったリポジトリで、勝手に確認なしのモードにされないための仕組みだよ。

セキュリティで気をつけることは？

いちばん大事なのは、deny（読ませない設定）だけでは穴があると知っておくこと。

• Read(./.env) は、Claude が .env を開いたり cat .env のように名前を出して読んだりするのは止める。でも、grep -r でフォルダごと検索するような、ファイル名を出さずに読むコマンドは止めない。
• だから公式は、確実に守りたいならサンドボックス（コマンドを囲いの中で動かす仕組み）を有効にするよう書いている。"sandbox": {"enabled": true} を足すと、deny に書いたファイルは囲いの中のどのコマンドからも読めなくなる。
• Bash(git push *) のようなルールは書いたとおりにしか当たらない。git -C . push のように書き方を変えたコマンドはすり抜けるんだ。

そのうえで、覚えておくと安心な決まりが3つあるよ。

知らないページの文章に「AIへの命令」がまぎれこむプロンプトインジェクションのような手口もあるから、確認を減らす設定ほど、deny とサンドボックスを先に入れておくのがいいと思うよ。

CLAUDE.md との違いは？

settings.json は「Claude Code という道具の設定」、CLAUDE.md は「Claude に渡す作業のメモ」だよ。

• settings.json：モデル・権限・読ませないファイルなど、決まりとして必ず守られるもの
• CLAUDE.md：「テストを回してから終えて」「API の処理は src/api に置く」など、毎回説明したくない約束ごと

公式は、CLAUDE.md は「強制される設定ではなく、読む材料」だと書いている。だから「絶対に消させたくない」ようなことは CLAUDE.md ではなく、settings.json の deny やフック（決まった操作の前に自動で走らせるチェック）で止めるんだ。

CLAUDE.md の置き場所は、自分全体なら ~/.claude/CLAUDE.md、プロジェクトなら ./CLAUDE.md か ./.claude/CLAUDE.md、自分だけなら ./CLAUDE.local.md。1ファイル200行までを目安に短く書くのがいいとされていて、/init を打つと最初の版を作ってくれるよ。

CLAUDE.md の書き方は、Anthropic 公式の無料コース「Claude Code 101」でも扱っているよ。設定だけじゃなく使い方を最初から順番に覚えたいなら、Claude Code を学べる講座の選び方に、無料のコースと有料の講座の違いをまとめたよ。

設定が効かないときは？

まず優先順位を知っておくと迷わないよ。上ほど強いんだ。

1. 会社の管理設定（自分では上書きできない）
2. 起動するときの --settings 指定（そのセッションだけ）
3. .claude/settings.local.json
4. .claude/settings.json（プロジェクト）
5. ~/.claude/settings.json

permissions.allow のような一覧の項目は、上が下を消すのではなく足し合わされるよ。

よくあるつまずきを、症状ごとにまとめたよ。

ほとんどの項目は、ファイルを保存すれば再起動しなくても今のセッションに反映されるよ。何が読み込まれなかったかの詳細は、claude doctor で一覧にできるんだ。

ぼくの見解

ぼくが一番大事だと思うのは、auto モードが既定になったぶん、設定ファイルを1つも持たないまま使い始める人が増えそうってことなんだ。

Codex の設定を調べたときは、公式の標準は「作業フォルダの中は自動、外への書き込みとネット接続は確認」という、つまみ2つの組み合わせだった。Claude Code の auto モードは、確認そのものを別のAIに任せる作りで、考え方がちょっと違う。手間はぐっと減るけど、何を止めるかの最後の線は、きみが settings.json に書いた deny とサンドボックスになる。

このサイトの AIモデル一覧でも、Claude Code の初心者向け度は5段階の2にしているよ。できることが多いぶん、最初に決めておくことも多い道具なんだ。だから、最初の5分で language と .env の deny だけでも入れておくと、そのあとずっと安心して任せられると思うな。インストールやログインでつまずいたときは、Claude Code ができないときの直し方も見てね。

まとめ

1. ~/.claude/settings.json を作る（無ければ自分で作っていい）
2. "language": "japanese" を書いて、返事を日本語にする
3. permissions.deny に Read(./.env) と Read(./.env.*) を足し、確実にするなら sandbox.enabled も true にする
4. 全部自分で確かめたいなら permissions.defaultMode を "default" にする
5. 効かないときは /status で、どのファイルが読み込まれているかを見る

設定は一度書けば毎回効くから、最初にほんの少し時間を使うだけで、Claude Code に安心して仕事を任せられるようになるよ。