Claude Code の環境変数は、claude を起動する前にシェルで設定するか、settings.json の "env" に書くと効きます。
画面の設定に無いタイムアウト・プロキシ・モデル・通信の停止などを、環境変数で変えられます。
- その場だけ:PowerShell なら
$env:API_TIMEOUT_MS = "1200000"のあとにclaude - ずっと使う:
~/.claude/settings.jsonの"env"に書く - 同じ変数がシェルと
"env"にあると、多くのセッションでは"env"の値が使われる ANTHROPIC_API_KEYを設定すると、サブスクでログイン中でも API の従量課金になる- 効いたかは、シェルの
echoと Claude Code の/statusで確かめる
よく使う変数は次の早見表、細かな意味と初期値は後半の分類別の表で紹介します。
内容は2026年11月16日に、Claude Code の公式ドキュメント(環境変数・設定・ネットワーク・認証の各ページ)と照らし合わせました。
設定を書き換えての動作確認はしていないため、値と手順は公式の記載にもとづいています。
用途別の早見表:よく使う環境変数
やりたいことから、変数と書く値の例を選べます。
| やりたいこと | 変数 | 値の例 |
|---|---|---|
| API の応答待ちで止まるのを防ぐ | API_ | 1200000(20分) |
| Claude が実行するコマンドを長く待つ | BASH_ | 300000(5分) |
| 使うモデルを固定する | ANTHROPIC_ | エイリアス(opus など)かモデル名 |
| 新しいセッションの既定のモデルを決める | ANTHROPIC_ | エイリアスかモデル名 |
| 社内のプロキシを通す | HTTPS_ | https: |
| 社内の証明書(CA)を信頼する | NODE_ | 証明書ファイルのパス |
| テレメトリを止める | DISABLE_ | 1 |
| 更新・テレメトリ・エラー報告などの通信をまとめて止める | CLAUDE_ | 1 |
| 自動更新だけ止める | DISABLE_ | 1 |
| 自動圧縮を止める | DISABLE_ | 1 |
| 設定フォルダーを分けてアカウントを使い分ける | CLAUDE_ | フォルダーの絶対パス |
| Windows で Git Bash の場所を教える | CLAUDE_ | bash.exe のパス |
時間の値はミリ秒で書くので、20分なら1200000です。
オンとオフを切り替える変数は、オンが 1・true・yes・on、オフが 0・false・no・off です。
ただし DISABLE_TELEMETRY と CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC は設定されているかだけを見るため、0 を入れても止まったままです。
全部の変数と細かな条件は、公式の環境変数リファレンスにあります。
設定する場所:シェルと settings.json の env
シェルで設定した変数はそのターミナルの中だけ、settings.json に書いた変数は claude を起動するたびに効きます。
その場だけ使う:起動前にシェルで設定する
変数を設定してから、同じターミナルで claude を起動します。
# macOS・Linux・WSL
export API_TIMEOUT_MS="1200000"
claude# PowerShell(そのターミナルだけ)
$env:API_TIMEOUT_MS = "1200000"
claudeREM Windows のコマンドプロンプト
set API_TIMEOUT_MS=1200000
claudeターミナルを閉じると、設定した値は消えます。
ずっと使う:settings.json の env に書く
settings.json の "env" の中に、変数名と値を文字列で書きます。
{
"env": {
"API_TIMEOUT_MS": "1200000",
"DISABLE_AUTOUPDATER": "1"
}
}ファイルが無ければ作り、すでにあるファイルならほかの設定を残して "env" だけを足します。
| ファイル | 効く範囲 |
|---|---|
~/ | 自分の全プロジェクト |
. | そのプロジェクトの全員(ソース管理に入れる) |
. | そのプロジェクトの自分だけ |
| 管理設定 | 組織の全員(管理者が配る) |
値は書いたとおりに環境へコピーされるので、~ や $HOME は展開されません。
パスを書く変数には、絶対パスを書きます。
CLAUDE_CONFIG_DIR など一部の変数は、プロジェクトの .claude/settings.json と settings.local.json では無視されます。
こうした変数は、シェルか ~/.claude/settings.json に書きます。
ファイルを保存すると、足した値や変えた値は実行中のセッションにも反映されます。
ただし、起動時に一度だけ読む機能は再起動が要り、ファイルから消した変数は次に起動したときに消えます。
settings.json の書き方は、Claude Codeのsettings.jsonで紹介しています。
Windows でずっと使う
PowerShell では、次のコマンドでユーザーの環境変数に保存できます。
[Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User")コマンドプロンプトなら setx API_TIMEOUT_MS "1200000" です。
どちらも、新しいターミナルを開いてから claude を起動すると効きます。
macOS や Linux では、export の行を ~/.bashrc や ~/.zshrc に足します。
どの値が使われるか:優先順位
| 重なり方 | 使われる値 |
|---|---|
シェルと "env" に同じ変数 | 多くのセッションでは "env" の値 |
| Claude Desktop アプリなどが始めたセッション | 起動環境ですでに設定された値("env" は無視) |
| 複数の settings.json に同じ変数 | 管理設定 → --settings → settings. → . → ~/ の順で上のもの |
ANTHROPIC_ と設定の model | ANTHROPIC_(--model と /model はさらに上) |
CLAUDE_ と --effort・/effort | CLAUDE_ |
settings.json では変数を消せないため、シェルに残った変数を打ち消したいときは空の文字列を書きます。
公式資料の例は "CLAUDE_CODE_USE_VERTEX": "" で、空の値はプロバイダーの選択では未設定として扱われます。
空の値をどう扱うかは変数によって違うので、ほかの変数は各変数の説明を確かめてください。
ファイル同士の順番は、公式の設定ファイルと優先順位にまとまっています。
環境変数が効いているかを確かめる方法
シェルで値を表示する
代入しても何も表示されないので、同じシェルで値を表示して確かめます。
# macOS・Linux・WSL
echo $API_TIMEOUT_MS
# PowerShell
echo $env:API_TIMEOUT_MS
# コマンドプロンプト
echo %API_TIMEOUT_MS%何も表示されなければ、そのシェルには変数がありません。
Claude Code の中で確かめる
/status:Status タブの Setting sources に、読み込まれた設定ファイルが並ぶ(どのキーをどのファイルから読んだかは出ない)/status:Proxy の行に使っているプロキシが出て、読めない値には無効の印が付く/status:いまの認証方法がわかる(ログインと API キーの両方があると、使っていないほうに印が付く)claude --debug:ログが~/.claude/debug/に保存され、証明書を読み込めたかや、無視された変数の名前がわかるclaude doctor:設定ファイルの中で受け付けられなかった項目が並ぶ
環境変数が効かないときの確認点
- シェルで変えたあと、claude を起動し直したか(シェルの変数は起動時に読まれる)
- 変数を設定したターミナルと、claude を起動したターミナルが同じか
- Windows で
setxなどを使ったあと、新しいターミナルを開いたか - プロジェクトの settings.json に、そこでは使えない変数(
CLAUDE_CONFIG_DIRなど)を書いていないか "env"の値に~や$HOMEを使っていないか- Claude Desktop アプリから始めたセッションではないか(起動環境の値が優先される)
- モデルが変わらないときは、
--modelや/modelが優先されていないか - effort が変わらないときは、
CLAUDE_CODE_EFFORT_LEVELが設定されたままになっていないか
プロキシや証明書のエラーは、Claude CodeのSSL・プロキシのエラーで症状別に紹介しています。
主な環境変数の意味と初期値(分類別)
公式の一覧から、よく使うものを分類ごとに抜き出しました。
認証・接続先
| 変数 | 意味 |
|---|---|
ANTHROPIC_ | API キー。設定するとログイン中でもサブスクの代わりに使われる。対話モードは最初に1回承認を求められ、-p ではキーがあれば常に使われる |
ANTHROPIC_ | Authorization ヘッダーの値(先頭に Bearer が付く) |
ANTHROPIC_ | API の接続先を変える(プロキシ・ゲートウェイ) |
CLAUDE_・CLAUDE_・CLAUDE_ | Amazon Bedrock・Google Cloud の Agent Platform・Microsoft Foundry を使う |
公式ヘルプによると、ANTHROPIC_API_KEY が環境変数にあると、サブスクでログインしていても、そのキーの API アカウントで従量課金されます。
サブスクで使うなら、ANTHROPIC_API_KEY は設定しないでおくよう案内されています。
認証が重なったときの優先順位は、クラウドプロバイダーの変数、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY の順です。
/login でのサブスクのログインは、この順番の最後です。
サブスクに戻すときは、キーの設定元から消して新しいセッションを開き、/status で認証方法を確かめます。
その場で消すには、macOS・Linux なら unset ANTHROPIC_API_KEY を実行します。
PowerShell なら Remove-Item Env:ANTHROPIC_API_KEY です。
公式ヘルプは、シェルの設定ファイルに書いたまま忘れてしまうことを、よくある失敗に挙げています。
なお、クラウドセッションでは ANTHROPIC_API_KEY や ANTHROPIC_AUTH_TOKEN を設定しても、サブスクの認証は上書きされません。
ログイン方法の違いはサブスクとAPIキーの違い、料金と使用量はClaude Codeの料金と使用量で紹介しています。
ネットワーク(プロキシ・証明書)
| 変数 | 意味 |
|---|---|
HTTPS_・HTTP_PROXY | プロキシのサーバー |
NO_PROXY | プロキシを通さないドメイン・IP(スペース区切りでもカンマ区切りでもよい) |
NODE_ | 社内の証明書(CA)のファイル。読み込めたかは claude --debug のログで確かめる |
CLAUDE_ | 信頼する証明書の取り出し元をカンマ区切りで指定。既定は bundled,。system はネイティブ版か Node 22.15 以降で読まれる |
小文字の https_proxy なども使え、https_proxy・HTTPS_PROXY・http_proxy・HTTP_PROXY の順で最初に見つかったものが使われます。
SOCKS プロキシには対応していません。
書き方の例は、公式のネットワーク構成にあります。
時間と出力の上限(タイムアウト)
| 変数 | 意味 | 初期値 |
|---|---|---|
API_ | API への各リクエストが応答の先頭を受け取るまでの制限時間。受信が始まったあとの長さは制限しない | 600000(10分) |
BASH_ | 前景の Bash・PowerShell ツールのコマンドの既定の待ち時間 | 120000(2分) |
BASH_ | 前景のコマンドにモデルが設定できる上限。実際の上限は BASH_ と比べて大きいほう | 600000(10分) |
BASH_ | Bash の出力を読み込む最大文字数。bash 設定があればそちらを使う | 30000(最大150000) |
MCP_ | MCP サーバーの起動の待ち時間 | 30000(30秒) |
MCP_ | MCP ツールの実行の待ち時間 | 100000000(約28時間) |
MAX_ | MCP ツールの応答の最大トークン | 25000 |
CLAUDE_ | 出力の最大トークン | モデルごと |
長い作業で止まるときは、API の待ちなら API_TIMEOUT_MS、Claude が実行するコマンドなら BASH_DEFAULT_TIMEOUT_MS を上げます。
モデルと考える深さ
| 変数 | 意味 |
|---|---|
ANTHROPIC_ | 使うモデル。設定ファイルの model より優先 |
ANTHROPIC_ | 新しいセッションが始まるときのモデル(v2.1.236 以降) |
ANTHROPIC_ など | 各エイリアスが指すモデル ID |
CLAUDE_ | ほかの方法でモデルを決めていないサブエージェントのモデル |
CLAUDE_ | effort(low・medium・high・xhigh・max)。auto で effort を送らない。使える段階はモデルによる |
MAX_ | 思考の固定の予算。適応型推論のモデルでは正の値は原則として無視され、0 でも思考を止められないモデルがある |
モデルは /model、--model、ANTHROPIC_MODEL、設定の model、ANTHROPIC_DEFAULT_MODEL の順に優先されます。
一方、CLAUDE_CODE_EFFORT_LEVEL は --effort や /effort より優先されます。
セッションの中で effort を変えても効かないときは、この変数の設定元を確かめます。
公式資料では、Opus 5.5・Sonnet 5.5・Haiku 5.5・Fable は思考をオフにできないとされています。
更新・送信・そのほか
| 変数 | 意味 |
|---|---|
DISABLE_ | 自動更新だけ止める(手での claude update は使える) |
DISABLE_ | 手での更新も止める |
DISABLE_ | テレメトリを止める。0 や false でも止まるので、戻すには変数を消す |
CLAUDE_ | 更新・テレメトリ・エラー報告などの通信をまとめて止める。0 でも止まる |
DISABLE_ | 自動圧縮を止める(手での /compact は使える) |
CLAUDE_ | 設定のフォルダー(初期値 ~/.claude)。アカウントの使い分けに |
CLAUDE_ | Windows で PATH に無い Git Bash の bash.exe の場所 |
DISABLE_TELEMETRY などで機能フラグの取得も止まると、/import、/skill-doctor、アカウント側で有効にしたスキル・プラグインの同期などが使えなくなります。
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC を設定すると、Remote Control も使えません。
止めたい通信と必要な機能は、公式の影響一覧で照らし合わせてください。
自動圧縮のしくみは、Claude Codeの/compactで紹介しています。
まとめ
- ふだん使う値は
~/.claude/settings.jsonの"env"、試すだけならシェルに書く - 同じ変数はふつう
"env"の値が使われ、モデルは--modelや/modelが優先される ANTHROPIC_API_KEYを設定すると API の従量課金になるので、/statusで認証方法を確かめる- タイムアウトは
API_TIMEOUT_MSとBASH_DEFAULT_TIMEOUT_MSで延ばす
使用量の上限に当たったときは、Claudeの利用制限で対処を紹介しています。
参考:Claude Code 公式ドキュメント「環境変数」「設定ファイルと優先順位」「ネットワーク構成」「認証」、Claude ヘルプセンター「Claude Codeで API キー環境変数を管理する」(2026年11月16日に確認)。
