楽天ブラックフライデー開催中!セール会場へ

Claude Code│環境変数の一覧|プロキシ・タイムアウト・モデル指定の書き方

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_TIMEOUT_MS1200000(20分)
Claude が実行するコマンドを長く待つBASH_DEFAULT_TIMEOUT_MS300000(5分)
使うモデルを固定するANTHROPIC_MODELエイリアス(opus など)かモデル名
新しいセッションの既定のモデルを決めるANTHROPIC_DEFAULT_MODELエイリアスかモデル名
社内のプロキシを通すHTTPS_PROXYhttps://proxy.example.com:8080
社内の証明書(CA)を信頼するNODE_EXTRA_CA_CERTS証明書ファイルのパス
テレメトリを止めるDISABLE_TELEMETRY1
更新・テレメトリ・エラー報告などの通信をまとめて止めるCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1
自動更新だけ止めるDISABLE_AUTOUPDATER1
自動圧縮を止めるDISABLE_AUTO_COMPACT1
設定フォルダーを分けてアカウントを使い分けるCLAUDE_CONFIG_DIRフォルダーの絶対パス
Windows で Git Bash の場所を教えるCLAUDE_CODE_GIT_BASH_PATHbash.exe のパス
Claude Code 公式ドキュメント「環境変数」「ネットワーク構成」(2026年11月16日確認)をもとに作成

時間の値はミリ秒で書くので、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"
claude
REM Windows のコマンドプロンプト
set API_TIMEOUT_MS=1200000
claude

ターミナルを閉じると、設定した値は消えます。

ずっと使う:settings.json の env に書く

settings.json の "env" の中に、変数名と値を文字列で書きます。

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "DISABLE_AUTOUPDATER": "1"
  }
}

ファイルが無ければ作り、すでにあるファイルならほかの設定を残して "env" だけを足します。

ファイル効く範囲
~/.claude/settings.json自分の全プロジェクト
.claude/settings.jsonそのプロジェクトの全員(ソース管理に入れる)
.claude/settings.local.jsonそのプロジェクトの自分だけ
管理設定組織の全員(管理者が配る)

値は書いたとおりに環境へコピーされるので、~ や $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.local.json → .claude/settings.json → ~/.claude/settings.json の順で上のもの
ANTHROPIC_MODEL と設定の modelANTHROPIC_MODEL(--model と /model はさらに上)
CLAUDE_CODE_EFFORT_LEVEL と --effort・/effortCLAUDE_CODE_EFFORT_LEVEL
Claude Code 公式ドキュメント「環境変数」「設定ファイルと優先順位」(2026年11月16日確認)をもとに作成

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_KEYAPI キー。設定するとログイン中でもサブスクの代わりに使われる。対話モードは最初に1回承認を求められ、-p ではキーがあれば常に使われる
ANTHROPIC_AUTH_TOKENAuthorization ヘッダーの値(先頭に Bearer が付く)
ANTHROPIC_BASE_URLAPI の接続先を変える(プロキシ・ゲートウェイ)
CLAUDE_CODE_USE_BEDROCK・CLAUDE_CODE_USE_VERTEX・CLAUDE_CODE_USE_FOUNDRYAmazon 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_PROXY・HTTP_PROXYプロキシのサーバー
NO_PROXYプロキシを通さないドメイン・IP(スペース区切りでもカンマ区切りでもよい)
NODE_EXTRA_CA_CERTS社内の証明書(CA)のファイル。読み込めたかは claude --debug のログで確かめる
CLAUDE_CODE_CERT_STORE信頼する証明書の取り出し元をカンマ区切りで指定。既定は bundled,system。system はネイティブ版か Node 22.15 以降で読まれる

小文字の https_proxy なども使え、https_proxy・HTTPS_PROXY・http_proxy・HTTP_PROXY の順で最初に見つかったものが使われます。

SOCKS プロキシには対応していません。

書き方の例は、公式のネットワーク構成にあります。

時間と出力の上限(タイムアウト)

変数意味初期値
API_TIMEOUT_MSAPI への各リクエストが応答の先頭を受け取るまでの制限時間。受信が始まったあとの長さは制限しない600000(10分)
BASH_DEFAULT_TIMEOUT_MS前景の Bash・PowerShell ツールのコマンドの既定の待ち時間120000(2分)
BASH_MAX_TIMEOUT_MS前景のコマンドにモデルが設定できる上限。実際の上限は BASH_DEFAULT_TIMEOUT_MS と比べて大きいほう600000(10分)
BASH_MAX_OUTPUT_LENGTHBash の出力を読み込む最大文字数。bashOutputMaxChars 設定があればそちらを使う30000(最大150000)
MCP_TIMEOUTMCP サーバーの起動の待ち時間30000(30秒)
MCP_TOOL_TIMEOUTMCP ツールの実行の待ち時間100000000(約28時間)
MAX_MCP_OUTPUT_TOKENSMCP ツールの応答の最大トークン25000
CLAUDE_CODE_MAX_OUTPUT_TOKENS出力の最大トークンモデルごと
Claude Code 公式ドキュメント「環境変数」(2026年11月16日確認)をもとに作成

長い作業で止まるときは、API の待ちなら API_TIMEOUT_MS、Claude が実行するコマンドなら BASH_DEFAULT_TIMEOUT_MS を上げます。

モデルと考える深さ

変数意味
ANTHROPIC_MODEL使うモデル。設定ファイルの model より優先
ANTHROPIC_DEFAULT_MODEL新しいセッションが始まるときのモデル(v2.1.236 以降)
ANTHROPIC_DEFAULT_OPUS_MODEL など各エイリアスが指すモデル ID
CLAUDE_CODE_SUBAGENT_MODELほかの方法でモデルを決めていないサブエージェントのモデル
CLAUDE_CODE_EFFORT_LEVELeffort(low・medium・high・xhigh・max)。auto で effort を送らない。使える段階はモデルによる
MAX_THINKING_TOKENS思考の固定の予算。適応型推論のモデルでは正の値は原則として無視され、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_AUTOUPDATER自動更新だけ止める(手での claude update は使える)
DISABLE_UPDATES手での更新も止める
DISABLE_TELEMETRYテレメトリを止める。0 や false でも止まるので、戻すには変数を消す
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC更新・テレメトリ・エラー報告などの通信をまとめて止める。0 でも止まる
DISABLE_AUTO_COMPACT自動圧縮を止める(手での /compact は使える)
CLAUDE_CONFIG_DIR設定のフォルダー(初期値 ~/.claude)。アカウントの使い分けに
CLAUDE_CODE_GIT_BASH_PATHWindows で 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日に確認)。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

須澤 元貴のアバター 須澤 元貴 代表社員

MOTOKI合同会社 代表社員。
アニメ・映像業界とゲーム業界で、2D・UI・3D・アニメーション制作、映像編集、ツール制作に携わってきました。
現在はWordPressを中心にWebサイトの制作とカスタマイズを手がけています。
著書に『Unity デザイナーズ・バイブル』『Unityゲーム プログラミング・バイブル 2nd Generation』(ボーンデジタル)。
岡山県出身、埼玉県在住。

次に学ぶ・作業環境を選ぶ

学習を続けたい方や、作業環境を整えたい方は、目的に合うガイドをご覧ください。

生成AIのおすすめ書籍

周辺機器の優先度

目次