Claude Codeの設定

Claude Codeはニーズに合わせて動作を設定するための様々な設定を提供しています。インタラクティブREPLを使用する際に/configコマンドを実行することでClaude Codeを設定できます。

​

設定ファイル

新しいsettings.jsonファイル形式は、階層的な設定を通じてClaude Codeを構成するための公式メカニズムです：

• ユーザー設定は~/.claude/settings.jsonで定義され、すべてのプロジェクトに適用されます。
• プロジェクト設定はプロジェクトディレクトリ内の.claude/settings.json（共有設定用）と.claude/settings.local.json（ローカルプロジェクト設定用）に保存されます。Claude Codeは作成時に.claude/settings.local.jsonをgitで無視するように設定します。
• Claude Codeのエンタープライズデプロイメントでは、エンタープライズ管理ポリシー設定もサポートしています。これらはユーザーおよびプロジェクト設定よりも優先されます。システム管理者はmacOSでは/Library/Application Support/ClaudeCode/policies.jsonに、LinuxおよびWSL経由のWindowsでは/etc/claude-code/policies.jsonにポリシーをデプロイできます。

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

​

利用可能な設定

settings.jsonは多くのオプションをサポートしています：

​

設定の優先順位

設定は優先順位の順に適用されます：

1. エンタープライズポリシー
2. コマンドライン引数
3. ローカルプロジェクト設定
4. 共有プロジェクト設定
5. ユーザー設定

​

権限

/permissionsを使用してClaude Codeのツール権限を表示・管理できます。このUIはすべての権限ルールとそれらが取得されるsettings.jsonファイルを一覧表示します。

• 許可ルールは、Claude Codeが指定されたツールを手動承認なしで使用できるようにします。
• 拒否ルールは、Claude Codeが指定されたツールを使用できないようにします。拒否ルールは許可ルールよりも優先されます。

権限ルールは次の形式を使用します：Tool(optional-specifier)

ツール名だけのルールは、そのツールのあらゆる使用に一致します。 例えば、許可ルールのリストにBashを追加すると、Claude Codeはユーザー承認を必要とせずにBashツールを使用できるようになります。Claudeが利用できるツールのリストを参照してください。

​

ツール固有の権限ルール

一部のツールでは、より細かい権限制御のためにオプションの指定子を使用します。 例えば、Bash(git diff:*)を含む許可ルールは、git diffで始まるBashコマンドを許可します。以下のツールは指定子を持つ権限ルールをサポートしています：

​

Bash

• Bash(npm run build) 正確なBashコマンドnpm run buildに一致します
• Bash(npm run test:*) npm run testで始まるBashコマンドに一致します。

​

Read & Edit

Editルールはファイルを編集するすべての組み込みツールに適用されます。 ClaudeはReadルールをGrep、Glob、LSなどのファイルを読み取るすべての組み込みツールに最善の努力で適用します。

ReadとEditのルールはどちらも gitignore仕様に従います。パターンは .claude/settings.jsonを含むディレクトリからの相対パスで解決されます。絶対パスを参照するには、//を使用します。ホームディレクトリからの相対パスには、~/を使用します。

• Edit(docs/**) プロジェクトのdocsディレクトリ内のファイルの編集に一致します
• Read(~/.zshrc) ~/.zshrcファイルの読み取りに一致します
• Edit(//tmp/scratch.txt) /tmp/scratch.txtの編集に一致します

​

WebFetch

• WebFetch(domain:example.com) example.comへのフェッチリクエストに一致します

​

MCP

• mcp__puppeteer puppeteerサーバー（Claude Codeで設定された名前）によって提供されるあらゆるツールに一致します
• mcp__puppeteer__puppeteer_navigate puppeteerサーバーによって提供されるpuppeteer_navigateツールに一致します

​

自動更新プログラムの権限オプション

Claude Codeがグローバルnpmプレフィックスディレクトリ（自動更新に必要）に書き込むための十分な権限がないことを検出すると、このドキュメントページを指す警告が表示されます。自動更新プログラムの問題に関する詳細なソリューションについては、トラブルシューティングガイドを参照してください。

​

推奨：新しいユーザー書き込み可能なnpmプレフィックスを作成する

# まず、既存のグローバルパッケージのリストを後で移行するために保存します
npm list -g --depth=0 > ~/npm-global-packages.txt

# グローバルパッケージ用のディレクトリを作成します
mkdir -p ~/.npm-global

# 新しいディレクトリパスを使用するようにnpmを設定します
npm config set prefix ~/.npm-global

# 注意：~/.bashrcを、お使いのシェルに適した~/.zshrc、~/.profile、または他の適切なファイルに置き換えてください
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# 新しいPATH設定を適用します
source ~/.bashrc

# 新しい場所にClaude Codeを再インストールします
npm install -g @anthropic-ai/claude-code

# オプション：以前のグローバルパッケージを新しい場所に再インストールします
# ~/npm-global-packages.txtを見て、保持したいパッケージをインストールします
# npm install -g package1 package2 package3...

このオプションを推奨する理由：

• システムディレクトリの権限を変更する必要がありません
• グローバルnpmパッケージ用のクリーンで専用の場所を作成します
• セキュリティのベストプラクティスに従います

Claude Codeは積極的に開発中であるため、上記の推奨オプションを使用して自動更新を設定することをお勧めします。

​

自動更新プログラムの無効化

権限を修正する代わりに自動更新プログラムを無効にしたい場合は、DISABLE_AUTOUPDATER 環境変数を1に設定できます

​

ターミナル設定の最適化

Claude Codeは、ターミナルが適切に設定されている場合に最も効果的に動作します。以下のガイドラインに従って、エクスペリエンスを最適化してください。

サポートされているシェル：

• Bash
• Zsh
• Fish

​

テーマと外観

Claudeはターミナルのテーマを制御できません。それはターミナルアプリケーションによって処理されます。オンボーディング中または/configコマンドを使用していつでもClaude Codeのテーマをターミナルに合わせることができます

​

改行

Claude Codeに改行を入力するためのいくつかのオプションがあります：

• クイックエスケープ：\に続けてEnterを押して改行を作成します
• キーボードショートカット：適切な設定でOption+Enter（Meta+Enter）を押します

Option+Enterをターミナルで設定するには：

Mac Terminal.appの場合：

1. 設定 → プロファイル → キーボードを開きます
2. 「Optionをメタキーとして使用」をチェックします

iTerm2とVSCodeターミナルの場合：

1. 設定 → プロファイル → キーを開きます
2. 一般の下で、左/右のOptionキーを「Esc+」に設定します

iTerm2とVSCodeユーザーへのヒント：Claude Code内で/terminal-setupを実行して、より直感的な代替手段としてShift+Enterを自動的に設定します。

​

通知設定

適切な通知設定により、Claudeがタスクを完了したときを見逃さないようにします：

​

ターミナルベル通知

タスクが完了したときにサウンドアラートを有効にします：

claude config set --global preferredNotifChannel terminal_bell

macOSユーザーの場合：システム設定 → 通知 → [ターミナルアプリ]で通知権限を有効にすることを忘れないでください。

​

iTerm 2システム通知

タスクが完了したときにiTerm 2アラートを表示するには：

1. iTerm 2環境設定を開きます
2. プロファイル → ターミナルに移動します
3. 「ベルを無音にする」と「フィルターアラート」→「エスケープシーケンス生成アラートを送信する」を有効にします
4. 希望する通知遅延を設定します

これらの通知はiTerm 2に固有のものであり、デフォルトのmacOSターミナルでは利用できないことに注意してください。

​

大量の入力の処理

広範なコードや長い指示を扱う場合：

• 直接貼り付けを避ける：Claude Codeは非常に長い貼り付けられたコンテンツで苦労する場合があります
• ファイルベースのワークフローを使用する：コンテンツをファイルに書き込み、Claudeに読み取りを依頼します
• VS Codeの制限に注意する：VS Codeターミナルは特に長い貼り付けを切り詰める傾向があります

​

Vimモード

Claude Codeは/vimまたは/configを介して有効にできるVimキーバインディングのサブセットをサポートしています。

サポートされているサブセットには以下が含まれます：

• モード切り替え：Esc（NORMALモードへ）、i/I、a/A、o/O（INSERTモードへ）
• ナビゲーション：h/j/k/l、w/e/b、0/$/^、gg/G
• 編集：x、dw/de/db/dd/D、cw/ce/cb/cc/C、.（繰り返し）

​

環境変数

Claude Codeは、その動作を制御するために以下の環境変数をサポートしています：

​

設定オプション

グローバル設定をsettings.jsonに移行する過程にあります。

claude configはsettings.jsonに置き換えられる予定です

設定を管理するには、次のコマンドを使用します：

• 設定の一覧表示：claude config list
• 設定の表示：claude config get <key>
• 設定の変更：claude config set <key> <value>
• 設定への追加（リスト用）：claude config add <key> <value>
• 設定からの削除（リスト用）：claude config remove <key> <value>

デフォルトでは、configはプロジェクト設定を変更します。グローバル設定を管理するには、--global（または-g）フラグを使用します。

​

グローバル設定

グローバル設定を設定するには、claude config set -g <key> <value>を使用します：