環境変数一覧

環境変数は、モデルの選択・認証・リクエストの経路・機能のオン／オフを制御します。多くは設定ファイルのキーや CLI フラグ、セッション内のコマンドでも同じことができます。このページは、シェルや設定ファイルでの設定方法、優先順位、全変数の表をまとめています。

• シェルで export するとそのターミナルのセッション中だけ、設定ファイルの env に書くと claude を起動するたびに効く
• 同じ変数をシェルと設定ファイルの両方に書くと、たいていは設定ファイルの値が優先される
• 数値の変数は 2e3（2000）や 64_000（64000）の書き方も受け付ける（説明に「プレーンな数字のみ」とある変数を除く）
• オン／オフの変数は 1・true・yes・on でオン、0・false・no・off でオフ（大文字小文字は問わない）
• 一部の変数は「設定されているか」だけを見るので、0 でもオンになる

設定キー側の説明は 設定キー一覧、設定ファイルの置き場所は 設定ファイルの仕組み を見てください。

環境変数の設定方法#

シェルで設定する#

claude を起動する前に設定します。

export API_TIMEOUT_MS="1200000"
claude

$env:API_TIMEOUT_MS = "1200000"
claude

set API_TIMEOUT_MS=1200000
claude

• 毎回有効にするには、macOS・Linux・WSL なら ~/.bashrc や ~/.zshrc などに export を書く
• Windows PowerShell なら [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User") を実行して新しいターミナルを開く
• Windows CMD なら setx API_TIMEOUT_MS "1200000" を実行して新しいターミナルを開く
• 設定できたかは同じシェルで echo $API_TIMEOUT_MS（PowerShell は echo $env:API_TIMEOUT_MS、CMD は echo %API_TIMEOUT_MS%）で確かめる

設定ファイルで設定する#

settings.json の env キーに書きます。ファイルが無ければ作ります。claude の起動方法に関係なく効きます。

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

• 動作中のセッションは、ファイルを保存すると新しい値・変更した値を環境に反映する
• 起動時に一度だけ読む機能（OpenTelemetry による監視など）は、再起動するまで起動時の値のまま
• 変数をファイルから消しても、動作中のセッションでは解除されない。次の起動から効く
• ファイル同士の重なり方は 設定ファイルの仕組み の優先順位に従う

優先順位#

環境変数と専用の設定キーの両方がある動作では、どちらを先に読むかがキーごとに違います。

• ANTHROPIC_MODEL と CLAUDE_CODE_AUTO_CONNECT_IDE は、変数を先に読み、未設定のときだけ model・autoConnectIde の設定を使う
• シェルと env の両方に同じ変数があると、たいていは設定ファイルの値が、シェルから引き継いだ値を置き換える。置き換えられないセッションと適用時期、特別扱いの変数、プロジェクト／ローカル設定で無視される変数は 設定キー一覧 の env の項にある
• 設定ファイルでは変数を「設定」できても「解除」はできない。シェルのプロファイルが出す CLAUDE_CODE_USE_VERTEX のような変数を打ち消すには、env で空文字にする（"CLAUDE_CODE_USE_VERTEX": ""）。プロバイダー選択では未設定として扱われるが、サブプロセスには空の値が引き継がれる
• 設定ファイル同士では、管理設定がユーザー・プロジェクトの設定より優先される
• CLI フラグやセッション内コマンドとの関係は機能ごとに違う。例：--model と /model は ANTHROPIC_MODEL より優先され、CLAUDE_CODE_EFFORT_LEVEL は --effort と /effort より優先される
• シェルの変数は起動時に読むので、変更は次の起動から効く

変数一覧#

「バージョン」は、公式ドキュメントが「Requires Claude Code vX 以降」と書いているものです。

認証・API 接続・プロバイダー#

Bash・タイムアウト・出力#

CLAUDE_ で始まる変数（A〜CLAUDE_BYTE）#

CLAUDE_CODE_ で始まる変数（A〜D）#

CLAUDE_CODE_ で始まる変数（DISABLE_OFFICIAL〜OTEL）#

CLAUDE_CODE_ で始まる変数（OTEL〜USE_）#

CLAUDE_CODE_USE_ 以降〜 ENABLE_ で始まる変数#

D〜H で始まる変数#

M 以降で始まる変数（前半）#

M 以降で始まる変数（後半）〜 VERTEX_REGION_#

OpenTelemetry の標準変数#

標準の OpenTelemetry エクスポーター変数（OTEL_METRICS_EXPORTER・OTEL_LOGS_EXPORTER・OTEL_EXPORTER_OTLP_ENDPOINT・OTEL_EXPORTER_OTLP_PROTOCOL・OTEL_EXPORTER_OTLP_HEADERS・OTEL_METRIC_EXPORT_INTERVAL・OTEL_RESOURCE_ATTRIBUTES と、シグナル別の変種）にも対応しています。詳しい設定は 利用状況の計測 を見てください。

• CLAUDE_CODE_ENABLE_TELEMETRY と、エクスポートをオンにする・送信先を選ぶ・内容を取り込む OpenTelemetry 変数は、シェル・ユーザー設定・管理設定で設定する。プロジェクト／ローカル設定では（オフの値を除き）無視される
• OTEL_RESOURCE_ATTRIBUTES と、エクスポート間隔・タイムアウト・圧縮の変数（OTEL_METRIC_EXPORT_INTERVAL など）は、プロジェクト／ローカル設定からでも有効

サブプロセス環境のスクラブが取り除くもの#

CLAUDE_CODE_SUBPROCESS_ENV_SCRUB を 1 にすると、Claude Code は起動するサブプロセス（Bash コマンド・フック・stdio MCP サーバーなど）の環境から資格情報を取り除きます。シェル展開を通じてプロンプトインジェクションが読み取れるものを減らす機能です。Claude Code 本体は自分の API 呼び出しのため資格情報を保持します。

変数名と値の形で資格情報かどうかを判定するので、これだけに頼らず、絞った権限ルールと組み合わせて使います。変数ごとの扱いは次のとおりです。

• スクラブは GITHUB_TOKEN を残すので、GitHub Actions のジョブには必要最小限の permissions を与える。サンドボックスの Bash コマンドから GitHub トークンを外すには、sandbox.credentials に deny の項目を足す（詳しくは サンドボックス）
• 取り除かれる変数をサブプロセスが必要とするなら、スクラブは未設定のままにする
• Linux では、Bash サブプロセスを分離した PID 名前空間で動かし、/proc からホストの環境を読めなくする。副作用として、ps などのプロセス一覧・シグナル送信のコマンドがホストのプロセスを見られず、送れない

フィーチャーフラグの取得が必要な機能#

Claude Code は一部の機能を、Anthropic から取得するフィーチャーフラグでオンにします。次のセッションでは、その取得を行いません。

• DISABLE_GROWTHBOOK・DISABLE_TELEMETRY・DO_NOT_TRACK・CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC のいずれかを設定したセッション（どの値で取得が止まるかは各変数の行を参照）
• 第三者プロバイダー（Bedrock・Claude Platform on AWS・Agent Platform・Foundry）のセッション。ただし Claude Code を組み込むホストが CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST を設定している場合を除く
• Claude apps gateway のセッション

取得をしないと、次のことができなくなります。

• /auto-mode-setup で autoMode.environment の項目を下書きする
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC か DISABLE_GROWTHBOOK を設定した状態で Remote Control を使う（DISABLE_TELEMETRY・DO_NOT_TRACK の場合は Remote Control の要件を参照）
• Remote Control が使えないとき、このマシンの外のセッションへメッセージを送る（このマシン内のセッション同士は取得なしでも動く）
• claude import や /import を実行する
• /skill-doctor を実行する、/plugin の「Stats」タブでそのレポートを開く
• claude.ai アカウントで有効なスキルとプラグインをターミナルのセッションに同期する
• advisor ツールを使う
• アーティファクトのコメントを読む・返信する
• 他の組織が公開したアーティファクトを Claude に読ませる
• MCP_PROTOCOL_NEGOTIATION=auto を設定しないかぎり、claude.ai コネクタと stdio サーバーへの MCP プロトコルリビジョン 2026-07-28 の打診
• Git Bash のある Windows で、claude.ai・Console アカウントの PowerShell ツールを既定で使う（CLAUDE_CODE_USE_POWERSHELL_TOOL=1 を設定しないかぎり、シェルコマンドは Git Bash 経由。Git Bash の無い Windows ではツールは有効のまま）
• Claude が下書きするフィードバック
• 大きな貼り付けを「貼り付けたもの」として Claude に扱わせる（Pasted text #N のプレースホルダーの中身は印なしで Claude に届く）
• API が拒否する入力スキーマを持つ MCP ツールの除外（スキーマはそのまま送られ、それを含むリクエストは、位置でツールを示す 400 エラーで失敗する）

インストールやアップグレード後の最初のセッション#

Claude Code をインストールした後、または機能が増えるバージョンへアップグレードした後の最初のセッションでは、フラグで制御される機能が無いことがあります。そのセッションは、あとのセッションと違う権限モードで始まることもあります。フラグはそのセッション中に取得されてそのマシンに保存されるので、そのマシンでの次のセッションから機能と通常の開始権限モードになります。

新規インストールの直後の非対話セッション（claude -p・Agent SDK・VS Code 拡張）では、開始権限モードを選ぶ前にフラグを取得できる場合がありますが、取得を待つとは限りません。

次のような構成では、2 回目以降のセッションも新しく取得したフラグなしで始まります。

• 毎回まっさらな環境：実行ごとに CI コンテナなど、以前のセッションが保存したフラグの無い環境で始まるなら、毎回が最初のセッションになる
• API キー無しのゲートウェイトークン：ANTHROPIC_AUTH_TOKEN で認証し API キーが無く、ANTHROPIC_BASE_URL が Anthropic 以外のホスト（LLM ゲートウェイなど）を指していると、フラグを取得するための資格情報が無い

こうした構成で開始する権限モードを決めるには、権限モード の「別の権限モードで始める」を参照してください。

関連ページ#

• 設定ファイルの仕組み：env キーを含む settings.json の設定
• 設定キー一覧：env の適用時期と無視される変数
• CLI のコマンドとフラグ：起動時のフラグ
• ネットワークと LLM ゲートウェイ：プロキシと TLS の設定
• 利用状況の計測：OpenTelemetry の設定