Claude Codeの設定が置かれる場所と環境変数

Claude Codeが扱うファイルには ~/.claude ディレクトリと ~/.claude.json ファイルの2つがある。これらの設定は $CLAUDE_CONFIG_DIR 環境変数で移動できる。

公式ドキュメントは探せていない。

.claude

主に会話ログやキャッシュを扱うディレクトリ。主なファイルとして projects/ や settings.json などがある。CLAUDE_CONFIG_DIR を設定すると中身がそのまま移動する。

settings.json

設定が入っているJSONファイル。MCPサーバーの許可設定やClaude Codeにおける各種ツールセットの役割で挙げた出力スタイルの設定などが含まれる。

settings.local.json

ローカル用らしいが現在は推奨されない。

commands

commands/ 以下にファイルを配置することでカスタムスラッシュコマンドを定義する。

output-styles

output-styles/ 以下にファイルを配置することでカスタム出力スタイルを定義する。

projects

claude を実行したときのファイルパスから / を - に置き換えたファイルが置いてある。内容を見る限りセッション履歴のようだが、詳しくは知らない。

.claude.json

このファイルはユーザー設定ファイルらしい。ログイントークンなどが入っているようだがユーザー設定という割には雑多なものが色々書かれている印象がある。

CLAUDE_CONFIG_DIR を設定すると $CLAUDE_CONFIG_DIR/.claude.json となる。設定の有無で置かれる階層が変わるの難しすぎると思う。