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およびWindows via WSLでは/etc/claude-code/policies.jsonにポリシーをデプロイできます。
Example settings.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は多数のオプションをサポートしています：

キー説明例
apiKeyHelper認証値を生成するために/bin/shで実行されるカスタムスクリプト。この値は通常、モデルリクエストのX-Api-Key、Authorization: Bearer、Proxy-Authorization: Bearerヘッダーとして送信されます/bin/generate_temp_api_key.sh
cleanupPeriodDaysチャット記録をローカルに保持する期間（デフォルト：30日）20
envすべてのセッションに適用される環境変数{"FOO": "bar"}
includeCoAuthoredBygitコミットとプルリクエストにco-authored-by Claude署名を含めるかどうか（デフォルト：true）false
permissionsallowとdenyキーは権限ルールのリストです{"allow": [ "Bash(npm run lint)" ]}

​
設定の優先順位

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

  1. エンタープライズポリシー（IAMドキュメントを参照）
  2. コマンドライン引数
  3. ローカルプロジェクト設定
  4. 共有プロジェクト設定
  5. ユーザー設定

​
環境変数

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

すべての環境変数はsettings.jsonでも設定できます。これは各セッションで環境変数を自動的に設定したり、チーム全体や組織全体に環境変数のセットを展開したりする方法として便利です。

変数目的
ANTHROPIC_API_KEYX-Api-Keyヘッダーとして送信されるAPIキー、通常はClaude SDK用（インタラクティブ使用の場合は/loginを実行）
ANTHROPIC_AUTH_TOKENAuthorizationおよびProxy-Authorizationヘッダーのカスタム値（ここで設定した値にはBearer が前置されます）
ANTHROPIC_CUSTOM_HEADERSリクエストに追加したいカスタムヘッダー（Name: Value形式）
ANTHROPIC_MODEL使用するカスタムモデルの名前（モデル設定を参照）
ANTHROPIC_SMALL_FAST_MODELバックグラウンドタスク用のHaikuクラスモデルの名前
BASH_DEFAULT_TIMEOUT_MS長時間実行されるbashコマンドのデフォルトタイムアウト
BASH_MAX_TIMEOUT_MSモデルが長時間実行されるbashコマンドに設定できる最大タイムアウト
BASH_MAX_OUTPUT_LENGTHbash出力が中央で切り詰められる前の最大文字数
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR各Bashコマンド後に元の作業ディレクトリに戻る
CLAUDE_CODE_API_KEY_HELPER_TTL_MS認証情報を更新する間隔（ミリ秒）（apiKeyHelper使用時）
CLAUDE_CODE_MAX_OUTPUT_TOKENSほとんどのリクエストの最大出力トークン数を設定
CLAUDE_CODE_USE_BEDROCKBedrockを使用（Bedrock & Vertexを参照）
CLAUDE_CODE_USE_VERTEXVertexを使用（Bedrock & Vertexを参照）
CLAUDE_CODE_SKIP_BEDROCK_AUTHBedrockのaws認証をスキップ（LLMゲートウェイ使用時など）
CLAUDE_CODE_SKIP_VERTEX_AUTHVertexのGoogle認証をスキップ（LLMゲートウェイ使用時など）
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICDISABLE_AUTOUPDATER、DISABLE_BUG_COMMAND、DISABLE_ERROR_REPORTING、DISABLE_TELEMETRYの設定と同等
DISABLE_AUTOUPDATER自動アップデーターを無効にするには1に設定
DISABLE_BUG_COMMAND/bugコマンドを無効にするには1に設定
DISABLE_COST_WARNINGSコスト警告メッセージを無効にするには1に設定
DISABLE_ERROR_REPORTINGSentryエラーレポートをオプトアウトするには1に設定
DISABLE_NON_ESSENTIAL_MODEL_CALLSフレーバーテキストなどの非重要パスのモデル呼び出しを無効にするには1に設定
DISABLE_TELEMETRYStatsigテレメトリをオプトアウトするには1に設定（Statsigイベントにはコード、ファイルパス、bashコマンドなどのユーザーデータは含まれません）
HTTP_PROXYネットワーク接続用のHTTPプロキシサーバーを指定
HTTPS_PROXYネットワーク接続用のHTTPSプロキシサーバーを指定
MAX_THINKING_TOKENSモデル予算の思考を強制
MCP_TIMEOUTMCPサーバー起動のタイムアウト（ミリ秒）
MCP_TOOL_TIMEOUTMCPツール実行のタイムアウト（ミリ秒）
MAX_MCP_OUTPUT_TOKENSMCPツールレスポンスで許可される最大トークン数（デフォルト：25000）

​
設定オプション

グローバル設定を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>を使用してください：

キー説明例
autoUpdaterStatus自動アップデーターを有効または無効にする（デフォルト：enabled）disabled
preferredNotifChannel通知を受信したい場所（デフォルト：iterm2）iterm2、iterm2_with_bell、terminal_bell、またはnotifications_disabled
themeカラーテーマdark、light、light-daltonized、またはdark-daltonized
verbose完全なbashおよびコマンド出力を表示するかどうか（デフォルト：false）true

​
Claudeが利用可能なツール

Claude Codeは、コードベースを理解し修正するのに役立つ強力なツールセットにアクセスできます：

ツール説明必要な権限
Agent複雑な多段階タスクを処理するサブエージェントを実行なし
Bash環境でシェルコマンドを実行あり
Edit特定のファイルに対象を絞った編集を行うあり
Globパターンマッチングに基づいてファイルを検索なし
Grepファイル内容のパターンを検索なし
LSファイルとディレクトリをリスト表示なし
MultiEdit単一ファイルに対して複数の編集をアトミックに実行あり
NotebookEditJupyterノートブックセルを修正あり
NotebookReadJupyterノートブックの内容を読み取り表示なし
Readファイルの内容を読み取りなし
TodoRead現在のセッションのタスクリストを読み取りなし
TodoWrite構造化されたタスクリストを作成・管理なし
WebFetch指定されたURLからコンテンツを取得あり
WebSearchドメインフィルタリングでWeb検索を実行あり
Writeファイルを作成または上書きあり

権限ルールは/allowed-toolsまたは権限設定で設定できます。

​
関連項目