AIツール活用

Claude Codeのsettings.jsonの書き方!設定の場所と確かめ方

中島大介(なかじ)読了時間 約25分
Claude Codeのsettings.jsonの書き方と置き場所を解説する記事のアイキャッチ

Claude Codeに英語の資料を読ませると、返事まで英語になって読み直す手間がかかることがあります。毎回「日本語で答えて」と書き添えるのも手間です。

Claude Codeの動きは「settings.json」に書いておけば、毎回の起動で同じ設定が使われます。ただし、settings.jsonを置く場所は4つあり、置く場所によって効く人と範囲が違う仕組みです。書いたのに効かない、チームの設定を書き換えてしまった、といった失敗の多くは置き場所の取り違えが原因です。

この記事では、練習用のフォルダにsettings.jsonを作る手順から、/configとの違い、優先順位、効いたかの確かめ方、エラーの直し方までを実画面で解説します。

この記事を読めば、Claude Codeの設定を自分の目的に合う場所に書けるようになります。自分だけの設定はフォルダの「.claude/settings.local.json」に、チームで共有する設定は「.claude/settings.json」に書き、/statusで読み込まれたかを確かめれば迷いません。

目次

Claude Codeのsettings.jsonの置き場所と使い分け

Claude Codeのsettings.jsonは、置く場所によって効く範囲が変わります。Claude Codeが読む設定ファイルの置き場所と使い分けは、以下の表のとおりです。

置き場所効く範囲向いている設定
~/.claude/settings.json(ユーザーの設定)自分のパソコンのすべてのフォルダ見た目・既定のモデルなど自分の好み
フォルダの.claude/settings.json(共有の設定)そのフォルダで作業する全員チームでそろえる許可・フック
フォルダの.claude/settings.local.json(自分だけの設定)自分の、そのフォルダだけ共有の設定を自分だけ変えたいとき
会社が配る管理の設定会社が配った全員セキュリティの決まり

表の「~/.claude」は、ホームフォルダの中の「.claude」フォルダを指します。Windowsでは「%USERPROFILE%\.claude」です。環境変数のCLAUDE_CONFIG_DIRを設定している場合は、ユーザーの設定はCLAUDE_CONFIG_DIRで指定したフォルダに置かれます。

同じ項目が複数の場所に書かれているときは、上の層の値が使われます。上から順に、会社の管理の設定、起動のときの--settings、自分だけの設定、共有の設定、ユーザーの設定の順です。会社の管理の設定は、原則として自分のファイルでは変えられません(安全側に働く一部の項目を除く)。

インストールしただけの状態では、settings.jsonはまだ1つもない状態です。/configで項目を変えたときや、許可の確認で「今後は聞かない」を選んだときに、Claude Codeが自動で作ります。ホームフォルダには「~/.claude.json」もありますが、アカウントの情報などをClaude Codeが自分で書くファイルなので、手で直す必要はありません。

本記事で扱うのは、settings.jsonの置き場所・書き方・確かめ方・直し方です。許可するコマンドの書き方は権限設定の記事、決まった場面でコマンドを動かす設定はhooksの記事で解説しています。

Claude Codeの権限設定を徹底解説!自動承認を安全に使う方法も紹介

Claude Code Hooksとは?仕組みと設定・おすすめの3つを徹底解説

練習用のフォルダにsettings.jsonを作る手順

settings.jsonの書き方は、返事の言語を変える「language」の項目で試すと、効いたかが目で分かります。練習用のフォルダにsettings.jsonを作る手順は、以下の3つです。

  1. 設定する前の返事を確かめる
  2. .claudeフォルダにsettings.jsonを保存する
  3. 起動し直して返事が変わったか確かめる

languageの項目の説明は、Claude Code CLIの記事でも解説しています。

Claude Code CLIとは?インストールから使い方・コマンドまで解説

設定する前の返事を確かめる

設定の前後で比べるため、最初に何も設定していない状態の返事を確かめます。ターミナルを開いて、以下の2つのコマンドを順に入力します。

  1. 「mkdir -p ~/touchai-demo/settings-demo」で練習用のフォルダを作る
  2. 「cd ~/touchai-demo/settings-demo」で練習用のフォルダに移る

本記事では、ホームフォルダの中の「touchai-demo」フォルダに練習用のフォルダを作りました。フォルダの名前は自由に変えてかまいません。

フォルダに移ったら「claude」と入力してClaude Codeを起動します。初めてのフォルダでは、フォルダを信頼するかの確認が出ます。下矢印キーで「Yes, I trust this folder」を選び、Enterキーを押してください。

画像の黒い帯は、撮影に使ったパソコンのユーザー名や契約の情報を隠した部分です。入力欄の上に出る大きな黒い帯は、アカウントの利用状況の行を隠したもので、以降の画像も同じ扱いにしました。

入力欄に英語で「What is the capital of Japan? Answer in one sentence.」と送ると、英語で返事が返ってきました。

画面の下の「auto mode on」は、撮影に使ったClaude Codeの権限のモードの表示で、本記事の手順には関係ありません。確かめたら、入力欄に「/exit」と入力してEnterキーを押し、Claude Codeを終えます。

.claudeフォルダにsettings.jsonを保存する

共有の設定は、フォルダの中の「.claude」フォルダにsettings.jsonとして置きます。settings.jsonに書く内容は、以下の1行です。

  • {"$schema": "https://json.schemastore.org/claude-code-settings.json", "language": "japanese"}

1つ目の「$schema」は、編集ソフトが入力の候補を出すための行で、書かなくても動きます。2つ目の「language」が、返事の言語を日本語にする設定になります。

ファイルを作る手順は、以下の3つです。

  1. ターミナルで「mkdir -p .claude」と入力して.claudeフォルダを作る
  2. 上の1行をコピーし、ターミナルで「pbpaste > .claude/settings.json」と入力する
  3. 「cat .claude/settings.json」と入力して中身を表示する

「pbpaste」は、コピーした文字をそのままファイルに書き出すMacのコマンドです。テキストエディットで作る場合は、フォーマットのメニューで標準テキストにしてから書いてください。テキストエディットの初期の設定では「"」が別の形の引用符に変わり、設定のファイルが壊れます。

画像では、読みやすいように1つの項目を1行に分けて保存しました。改行の位置は自由で、1行のままでも同じように読み込まれます。

起動し直して返事が変わったか確かめる

settings.jsonを保存したら、同じフォルダで「claude」と入力してClaude Codeを起動し直します。設定の前と同じ英語の質問を送ると、今度は日本語で返事が返ってきました。

返事が日本語に変わったことから、settings.jsonのlanguageが読み込まれたと分かりました。多くの項目は、起動中に保存しても次の依頼から反映されます。ただし、モデルの「model」や考える深さの「effortLevel」のように、起動し直すまで変わらない項目もあります。

/configで変えた設定の保存先を確かめる手順

Claude Codeの「/config」を使うと、settings.jsonを開かずに画面で設定を変えられます。/configで変えた設定が保存される場所を確かめる手順は、以下の3つです。

  1. /configのConfigタブを開く
  2. Show tipsをオフにする
  3. settings.local.jsonに書かれたか確かめる

/configのConfigタブを開く

Claude Codeの入力欄に「/config」と入力してEnterキーを押すと、設定の画面が開きます。開いた直後は「Config」のタブが選ばれていて、変えられる項目が並びます。

Configタブに並ぶのは、見た目や表示に関わる一部の項目だけです。settings.jsonに書ける項目の一覧は、Claude Code公式ドキュメントの設定項目のページで確かめられます。

Show tipsをオフにする

下矢印キーで「Show tips」の行を選びます。Show tipsは、Claude Codeが作業している間に使い方のヒントを1行で表示する設定です。

Show tipsの行でEnterキーを押すと、値が「true」から「false」に変わりました。値が変わった時点で、設定は保存されています。

settings.local.jsonに書かれたか確かめる

Escキーで設定の画面を閉じ「/exit」でClaude Codeを終えます。ターミナルで「ls -a .claude」と「cat .claude/settings.local.json」を順に入力すると、保存先が分かります。

Show tipsの設定は、フォルダの「.claude/settings.local.json」に「spinnerTipsEnabled」の項目として保存されていました。/configの多くの項目はユーザーの設定に保存されますが、Show tipsのように自分だけの設定に保存される項目もあります。撮影の前後でユーザーの設定ファイルを見比べ、Show tipsの切り替えでは書き換わっていないことも確かめました。

/configの画面を開かずに1つの項目だけを変えたいときは「/config verbose=true」のように「/config 項目の名前=値」の形で入力します。

settings.jsonとsettings.local.jsonの優先順位を試す手順

同じ項目が共有の設定と自分だけの設定の両方にあるときは、自分だけの設定の値が使われます。優先順位を確かめる手順は、以下の3つです。

  1. settings.local.jsonに英語を指定する
  2. 自分だけの設定が勝つことを確かめる
  3. 項目を消して共有の設定に戻す

settings.local.jsonに英語を指定する

自分だけの設定のsettings.local.jsonに、共有の設定とは反対の英語を指定します。settings.local.jsonに書く内容は、以下の1行です。

  • {"spinnerTipsEnabled": false, "language": "english"}

1行をコピーしてから、ターミナルで「pbpaste > .claude/settings.local.json」と入力して上書きします。「cat .claude/settings.local.json」で中身を確かめてください。

自分だけの設定が勝つことを確かめる

Claude Codeを起動し、今度は日本語で「日本の首都はどこですか?1文で答えてください。」と送ります。共有の設定はjapaneseのままですが、返事は英語でした。

返事が英語になったのは、同じlanguageの項目で、自分だけの設定のenglishが共有の設定のjapaneseより優先されたためです。チームの共有の設定を書き換えずに、自分だけ違う設定にしたいときに使えます。

許可するコマンドを並べる「permissions」の「allow」のような一覧の項目は、上の層が勝つのではなく、それぞれのファイルの一覧が合わせて使われます。一覧の項目の扱いは、権限設定の記事で確かめてください。

項目を消して共有の設定に戻す

Claude Codeを「/exit」で終え、settings.local.jsonからlanguageの項目を消します。消した後の内容は、以下の1行です。

  • {"spinnerTipsEnabled": false}

1行をコピーして「pbpaste > .claude/settings.local.json」で上書きしてから、Claude Codeを起動し直します。同じ日本語の質問を送ると、返事が日本語に戻りました。

自分だけの設定から項目を消すと、下の層の共有の設定にあるjapaneseが使われます。どの層にも項目がなければ、Claude Codeの初期の動きに戻ります。項目を消しても、書く前の値に戻るとは限らない点に注意してください。

Claude Codeに読み込まれた設定ファイルを確かめる手順

設定が効かないと感じたら、どの設定ファイルが読み込まれているかを確かめます。Claude Codeの入力欄に「/status」と入力してEnterキーを押すと、Statusタブが開きます。

上の画像は、Statusタブの「Setting sources」の行だけを切り抜いたものです。Statusタブにはアカウントのメールアドレスも出るため、画面を人に見せるときは注意してください。

Setting sourcesの行に出る名前と、設定ファイルの対応は以下のとおりです。

  • User settings: ユーザーの設定(~/.claude/settings.json)
  • Shared project settings: 共有の設定(.claude/settings.json)
  • Project local settings: 自分だけの設定(.claude/settings.local.json)

Setting sourcesの行で分かるのは、読み込まれたファイルの種類だけです。どの項目の値がどのファイルから来たかまでは表示されないため、値は実際の動きで確かめてください。

/statusの画面はEscキーで閉じ、Claude Codeを「/exit」で終えましょう。ターミナルに戻って「claude doctor」と入力すると、インストールの状態が分かります。設定のファイルに受け付けられない項目があるときは、claude doctorの結果に表示されます。

--settingsで1回だけ設定を変えて試す手順

設定を試したいだけなら、ファイルを書き換えずに、起動するときの「--settings」で1回だけ変えられます。ターミナルで、以下のコマンドを入力します。

  • claude --settings '{"language": "english"}'

「--settings」の後ろの「'」は半角のシングルクォートで、設定の内容を1つにまとめるための記号です。

設定ファイルにはenglishが書かれていませんが、--settingsを付けて起動したClaude Codeに日本語で質問すると、英語で返事が返ってきました。

--settingsで指定した値は、その起動の間だけ使われ、設定ファイルは変わりません。--settingsの値は、会社の管理の設定を除くすべての設定ファイルより優先されます。

settings.jsonのエラーや設定が効かないときの直し方

settings.jsonは書き方の決まりが厳しく、記号1つの間違いでファイル全体が読み込まれなくなります。settings.jsonのエラーや設定が効かないときの直し方は、以下の4つです。

  • JSONの書き間違いはSettings Errorの画面から直す
  • 上の層が同じ項目を決めていないか確かめる
  • 起動し直すまで変わらない項目は起動し直す
  • フォルダを信頼するまで効かない項目に注意する

JSONの書き間違いはSettings Errorの画面から直す

settings.jsonの最後の項目の後ろに「,」(カンマ)を付けたまま保存すると、Claude Codeの起動時に「Settings Error」の画面が出ます。練習で使う、書き間違いを入れたsettings.jsonの内容は、以下の4行です。

  1. {
  2. "$schema": "https://json.schemastore.org/claude-code-settings.json",
  3. "language": "japanese",
  4. }

3行目の最後の「,」が、わざと入れた書き間違いです。4行をコピーして「pbpaste > .claude/settings.json」で上書きし「claude」で起動すると、以下の画面になりました。

画面の「Files with errors are skipped entirely」は、エラーのあるファイルが中の正しい項目も含めてまるごと読み飛ばされることを表します。Settings Errorの画面の選択肢は、以下の3つです。

選択肢意味
1. Fix with ClaudeClaude Codeに直してもらう
2. Exit and fix manuallyClaude Codeを終えて自分で直す
3. Continue without these settingsエラーのファイルを読まずに続ける

「1. Fix with Claude」を選ぶと、Claude Codeが最後のカンマを消してファイルを直しました。

直した直後の返事が英語なのは、エラーのあったsettings.jsonが読み飛ばされ、languageの設定がまだ効いていないためです。公式の説明によると、Claude Codeは保存された設定ファイルを起動したまま読み直すため、直した後の依頼からはlanguageの設定が効きます。

settings.jsonでは「//」で始まるメモの行もエラーになります。設定の理由を残したいときは、settings.jsonの外にメモを残してください。

上の層が同じ項目を決めていないか確かめる

書いた値が効かないときは、上の層の設定ファイルが同じ項目に別の値を書いている場合があります。自分だけの設定のsettings.local.jsonや、起動のときの--settingsは、共有の設定より優先されます。

会社のパソコンでは、会社が配った管理の設定がすべてに優先する仕組みです。/statusのSetting sourcesに管理の設定の名前が出ていたら、社内の管理者に確かめてください。

起動し直すまで変わらない項目は起動し直す

Claude Codeは設定ファイルの保存を見張っていて、多くの項目は起動したままでも反映されます。一方で、モデルの「model」と考える深さの「effortLevel」を読み込むのは、起動したときだけです。

起動中にモデルを変えたいときは「/model」、考える深さを変えたいときは「/effort」を使います。settings.jsonに書いた値を使いたいときは、Claude Codeを起動し直してください。

フォルダを信頼するまで効かない項目に注意する

共有の設定に書いた許可の一覧や環境変数の多くは、そのフォルダを信頼するまで使われません。初めて開いたフォルダで「Yes, I trust this folder」を選ぶ前は、共有の設定の一部が効かない状態になります。

他人が作ったフォルダの設定は、信頼する前に中身を確かめることが大切です。共有の設定には、Claude Codeに自動で実行させるコマンドも書けるからです。

settings.jsonをチームで共有するときのファイルの分け方

チームで同じ設定を使うときは、共有の設定と自分だけの設定を分けて管理します。settings.jsonをチームで共有するときのファイルの分け方は、以下の2つです。

  • 共有の設定のsettings.jsonはコミットして配る
  • 自分だけの設定のsettings.local.jsonはGitの除外に入る

共有の設定のsettings.jsonはコミットして配る

フォルダの「.claude/settings.json」は、Gitで管理していればコミットしてチームに配れます。練習用のフォルダで「git init」を実行してから「git add .claude」と「git status --short --ignored」を順に入力しました。

「A」の印が付いたsettings.jsonはコミットの対象に入り「!!」の印が付いたsettings.local.jsonは除外されました。

自分だけの設定のsettings.local.jsonはGitの除外に入る

settings.local.jsonが除外された理由は、画像の「git check-ignore -v」の結果で分かります。除外の設定は、フォルダの「.gitignore」ではなく、自分のパソコンのGit全体の除外ファイル(撮影の環境では「~/.config/git/ignore」)に書かれていました。

Claude Codeは、Gitのフォルダでsettings.local.jsonを初めて書くとき、Git全体の除外ファイルにsettings.local.jsonを除外する行を足します。settings.local.jsonを自分で作った場合は、フォルダの.gitignoreに「.claude/settings.local.json」の行を足しておきましょう。

Claude Codeのsettings.jsonに関するよくある質問

Claude Codeのsettings.jsonについて、よくある質問と答えをまとめました。

CLAUDE.mdとsettings.jsonはどう使い分けますか?

CLAUDE.mdはClaude Codeに読ませる指示書で、settings.jsonはClaude Codeの動きを決める設定です。作業の進め方や社内のルールのような文章で伝えることはCLAUDE.mdに、許可・返事の言語・表示のような決まった項目はsettings.jsonに書きます。

CLAUDE.mdとは?書き方と置き場所を徹底解説!効かないときの直し方も紹介

デスクトップアプリやVS Codeでも/configは使えますか?

/configは、ターミナルで動かすClaude Codeの機能です。VS Codeの拡張機能やデスクトップアプリのチャットの画面では開けないため、settings.jsonを直接書くか、それぞれのアプリの設定の画面を使います。

まとめ

Claude Codeのsettings.jsonは、置き場所で効く範囲が決まります。迷ったときの選び方は、以下の3つです。

  • 自分のすべてのフォルダで使う好みは、ユーザーの設定に書く
  • チームでそろえる設定は、フォルダの.claude/settings.jsonに書いてコミットする
  • 共有の設定を自分だけ変えたいときは、.claude/settings.local.jsonに書く

書いた後は、/statusのSetting sourcesで読み込まれたファイルを確かめ、実際の動きが変わったかを見ます。Settings Errorが出たら、最後のカンマや「//」のメモがないかを確かめてください。

設定の置き場所が分かれば、毎回の書き添えや確認の手間を減らせます。まずは練習用のフォルダで、languageの設定を書いて返事が変わるところまで試してみましょう。

参考リンク

この記事の監修者

中島大介(なかじ)

中島大介(なかじ)

株式会社メリル 代表取締役 / 記事監修

株式会社メリル代表取締役。SEO歴20年以上。最新AIやセキュリティについて発信するYouTube「ウェブ職TV」は登録者15万人以上。著書「ChatGPT & Copilotの教科書」は10万部突破!

プロフィールを見る

関連する記事

Cursorのプラグイン「pstack」の使い方を解説する記事のアイキャッチ
AIツール活用

pstackの使い方|Cursor・Claude Codeへの入れ方と頼み方

pstackを使ってみたい方は必見!この記事では、pstackの入れ方と/poteto-modeでの頼み方を解説します。実は、pstackで最初に覚えるコマンドは2つだけです。記事を読めば、AIに確かめさせながら作業を任せられます。

中島大介(なかじ)監修 / Touch AI編集部25 分で読めます
MetaのAIエージェント「Muse」の使い方を解説する記事のアイキャッチ
AIツール活用

Museの使い方|Meta Museの始め方・初期設定・料金を解説

Museを使い始めたい方は必見!この記事では、Meta Museの始め方・初期設定・料金を解説します。実は、Museとのやり取りをAIの学習に使う設定は最初からオンです。記事を読めば、任せる範囲を決めてから使い始められます。

中島大介(なかじ)監修 / Touch AI編集部26 分で読めます
Claude Codeで複数ファイルを一括置換する方法を解説する記事のアイキャッチ
AIツール活用

複数ファイルの文字列を一括置換するには?Claude Codeで残す語を指定

製品名の変更で複数のファイルを直したい方は必見!この記事では、Claude Codeで複数のファイルの文字を一括置換する手順を解説します。実は、残す語を決めてから置き換えられます。記事を読めば、コピーから元に戻す方法も分かります。

中島大介(なかじ)監修 / Touch AI編集部19 分で読めます

次のステップ

最新動向を学びに変える

話題のAIアップデートを、現役講師が背景と実務への影響まで解きほぐします。Touch AI の最新講座で、変化に追いつくための視点を得てください。

受講できる講座を見る