Claude Codeの設定 - 環境変数
提供: MochiuWiki : SUSE, EC, PCB
📢 Webサイト閉鎖と移転のお知らせ
このWebサイトは2026年9月に閉鎖いたします。
新しい記事は移転先で追加しております。（旧サイトでは記事を追加しておりません）
概要
Claude Codeは、設定のカスタマイズに多数の環境変数をサポートしている。
認証、モデル選択、クラウドプロバイダー統合、パフォーマンス調整、テレメトリ制御など、動作の細部にわたる制御が環境変数を通じて可能である。
主要カテゴリは以下の通りである。
- 認証関連
- APIキー、OAuth、カスタムヘッダー
- モデル設定
- デフォルトモデル、エイリアス上書き、推論努力レベル
- トークン・出力制御
- 最大出力トークン、思考トークン
- ネットワーク・プロキシ
- APIエンドポイント、プロキシ設定
- クラウドプロバイダー統合
- AWS Bedrock、Google Vertex AI、Microsoft Foundry
- テレメトリ・監視
- テレメトリ制御、OpenTelemetry設定
- 動作制御・パフォーマンス
- タイムアウト、MCP設定
- 機能制御
- メモリ、バックグラウンドタスク、自動更新
環境変数の設定方法
シェル環境変数による設定
export コマンドを使用して、現在のシェルセッションに環境変数を一時的に設定できる。
Fishシェルでは、set -x コマンド または set -Ux コマンドを使用することもできる。
永続化する場合は、~/.profile または ~/.zprofile 等に設定する。
# 一時的な設定 (現在のセッションのみ有効)
export ANTHROPIC_API_KEY="sk-ant-xxxx"
export ANTHROPIC_MODEL="claude-sonnet-4-5"
# Bash / Zsh での永続化 (~/.bashrc または ~/.zshrc に追記)
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxx"' >> ~/.bashrc
source ~/.bashrc
# Fish シェルでの設定
set -x ANTHROPIC_API_KEY "sk-ant-xxxx"
# Fish シェルでの永続化
set -Ux ANTHROPIC_API_KEY "sk-ant-xxxx"
settings.jsonによる設定
settings.json の "env" フィールドを使用して環境変数を永続的に設定できる。
セッション間で自動的に適用されるため、シェルプロファイルでの設定が不要になる。
設定ファイルの配置場所は以下の通りである。
- ユーザ設定
- ~/.claude/settings.json
- 全プロジェクト共通の設定
- プロジェクト共有設定
- <プロジェクトルート>/.claude/settings.json
- チームで共有可能な設定
- プロジェクトローカル設定
- <プロジェクトルート>/.claude/settings.local.json
- 個人用、.gitignore への追加を推奨
{
"env": {
"ANTHROPIC_MODEL": "claude-sonnet-4-5",
"BASH_DEFAULT_TIMEOUT_MS": "180000",
"MCP_TIMEOUT": "60000",
"DISABLE_TELEMETRY": "1"
}
}
設定の優先度
Claude Codeの設定は階層的に管理されており、複数のスコープで同じ設定が定義された場合は、より高い優先度の設定が適用される。
| 優先度 | スコープ | 設定場所 | 説明 |
|---|---|---|---|
| 1 (最高) | Managed | Enterprise管理設定 | IT/DevOpsが展開するポリシー設定 |
| 2 | Command Line | CLIフラグ | コマンドラインで直接指定 |
| 3 | Local | .claude/settings.local.json | プロジェクトローカル設定 (個人用) |
| 4 | Project | .claude/settings.json | プロジェクト共有設定 |
| 5 (最低) | User | ~/.claude/settings.json | ユーザ全体設定 |
同じキーが異なるスコープで定義された場合、高い優先度のスコープの値が適用される。
パーミッション等の配列はマージされる。
認証関連
APIキーの設定
環境変数 ANTHROPIC_API_KEY は、Anthropic APIの主要な認証方法である。
設定するとAPIの従量課金が適用される。
Maxサブスクリプション使用時は、予期しない課金を防ぐため設定しないことが推奨される。
# APIキーの設定
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxxxx"
# 設定の確認
echo $ANTHROPIC_API_KEY
OAuth認証
CLAUDE_CODE_OAUTH_TOKEN- OAuth認証トークンを設定する。
ANTHROPIC_AUTH_TOKEN- カスタムエンドポイント使用時の認証トークンを設定する。
- 環境変数
ANTHROPIC_BASE_URLと組み合わせて使用する。
カスタムヘッダ
環境変数 ANTHROPIC_CUSTOM_HEADERS は、APIリクエストに追加のカスタムヘッダを付加する環境変数である。
フォーマットは Name:Value 形式であり、複数ヘッダはカンマまたは改行で区切る。
モデル設定
デフォルトモデルの指定
環境変数 ANTHROPIC_MODEL は、Claude Codeで使用するデフォルトモデルを指定する環境変数である。
完全なモデルIDまたはエイリアスを使用できる。
利用可能なエイリアスは以下の通りである。
- claude-opus-4-6
- claude-sonnet-4-5
- claude-haiku-4-5
- sonnet
- opus
- haiku
モデルエイリアスの上書き
| 環境変数 | 説明 | 設定例 |
|---|---|---|
ANTHROPIC_DEFAULT_OPUS_MODEL |
opusエイリアスに使用するモデル | claude-opus-4-6 |
ANTHROPIC_DEFAULT_SONNET_MODEL |
sonnetエイリアスに使用するモデル | claude-sonnet-4-5 |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
haikuエイリアスに使用するモデル | claude-haiku-4-5 |
CLAUDE_CODE_SUBAGENT_MODEL |
サブエージェントに使用するモデル | claude-sonnet-4-5 |
推論努力レベル
環境変数 CLAUDE_CODE_EFFORT_LEVEL は、推論と計算の深さを制御する環境変数である。
Opus 4.5 / 4.6 のみ対応している。
| レベル | 説明 |
|---|---|
| low | 高速・低コスト、単純なタスク向け |
| medium | バランス型、一般的な用途向け |
| high (デフォルト) | 最大限の推論深度、複雑な問題向け |
トークン・出力制御
CLAUDE_CODE_MAX_OUTPUT_TOKENS- 最大出力トークン数を設定する。
- デフォルト値は、16384 トークンである。
MAX_THINKING_TOKENS- 拡張思考 (Extended Thinking) の最大トークン数を設定する。
- この変数を設定すると、全リクエストが思考リクエストとして送信される場合がある。
MAX_MCP_OUTPUT_TOKENS- MCPツール出力の最大トークン数を設定する。
ネットワーク・プロキシ
APIエンドポイントの変更
環境変数 ANTHROPIC_BASE_URL は、カスタムAPIエンドポイントを指定する環境変数である。
デフォルト値は、https://api.anthropic.com である。
プロキシサーバやLiteLLM等の互換エンドポイントを使用する場合に設定する。
プロキシサーバーの設定
企業ネットワーク等でプロキシサーバを経由する場合に使用する環境変数を以下に示す。
# プロキシサーバの設定
export HTTPS_PROXY="http://proxy.example.com:8080"
export HTTP_PROXY="http://proxy.example.com:8080"
# プロキシを経由しないホストの設定
export NO_PROXY="localhost,127.0.0.1,.internal.example.com"
# 自己署名証明書を使用するプロキシ環境
export NODE_EXTRA_CA_CERTS="/path/to/ca-bundle.crt"
クラウドプロバイダー統合
AWS Bedrock
AWS上でホストされるClaudeモデルを使用するための設定である。
AWS上の認証方法 (IAM、プロファイル、SSO) を利用する。
関連する環境変数は以下の通りである。
CLAUDE_CODE_USE_BEDROCK- 値を
1に設定して、有効化する。
- 値を
AWS_REGION- AWSリージョンを指定する。(必須)
- .aws/configファイル からは自動読み込みされないため、明示的に設定が必要である。
AWS_ACCESS_KEY_ID- アクセスキーIDを設定する。
AWS_SECRET_ACCESS_KEY- シークレットアクセスキーを設定する。
AWS_SESSION_TOKEN- 一時的なセッショントークンを設定する。
AWS_BEARER_TOKEN_BEDROCK- Bedrock認証トークンを設定する。(代替認証方法)
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION- Haikuモデル専用のリージョンを指定する。
BEDROCK_DISABLE_STREAMING- 値を
1に設定して、ストリーミングを無効化する。
- 値を
# AWS Bedrockの有効化
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION="us-east-1"
# IAM認証の設定
export AWS_ACCESS_KEY_ID="AKIAXXXXXXXXXXXXXXXX"
export AWS_SECRET_ACCESS_KEY="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# Bedrockでのモデル指定 (オプション)
export ANTHROPIC_MODEL="us.anthropic.claude-sonnet-4-5-20250929-v1:0"
Google Vertex AI
Google Cloud上でホストされるClaudeモデルを使用するための設定である。
gcloud CLIベースの認証を利用する。
関連する環境変数は以下の通りである。
CLAUDE_CODE_USE_VERTEX- 値を
1に設定して、有効化する。
- 値を
ANTHROPIC_VERTEX_PROJECT_ID- Google CloudプロジェクトIDを設定する。(必須)
CLOUD_ML_REGION- リージョンを指定する。
- 推奨値:
global
認証前提として、gcloud auth login および gcloud auth application-default login の実行が必要である。
# Google Vertex AIの有効化
export CLAUDE_CODE_USE_VERTEX=1
export ANTHROPIC_VERTEX_PROJECT_ID="my-gcp-project"
export CLOUD_ML_REGION="global"
# 事前に必要なgcloud認証
# gcloud auth login
# gcloud auth application-default login
# gcloud config set project my-gcp-project
Microsoft Foundry
Microsoft Azure上のAI Foundryを使用するための設定である。
関連する環境変数は以下の通りである。
CLAUDE_CODE_USE_FOUNDRY- 値を
1に設定して、有効化する。
- 値を
ANTHROPIC_FOUNDRY_RESOURCE- Azureリソース名を設定する。
ANTHROPIC_FOUNDRY_BASE_URL- FoundryベースURLを設定する。
ANTHROPIC_FOUNDRY_RESOURCEの代替
ANTHROPIC_FOUNDRY_API_KEY- Foundry APIキーを設定する。(Entra ID認証の代替)
テレメトリ・監視
以下に示す環境変数でテレメトリとエラー報告を制御できる。
DISABLE_TELEMETRY- 値を
1に設定して、Statsigテレメトリを無効化する。
- 値を
DISABLE_ERROR_REPORTING- 値を
1に設定して、Sentryエラー報告を無効化する。
- 値を
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC- 値を
trueに設定して、テレメトリ、エラー報告等の非必須トラフィックを一括無効化する。 DISABLE_TELEMETRYとDISABLE_ERROR_REPORTINGの両方を同時に有効化する。
- 値を
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY- 値を
1に設定して、フィードバックアンケートを無効化する。
- 値を
OpenTelemetryによる監視データ収集に関する環境変数は以下の通りである。
CLAUDE_CODE_ENABLE_TELEMETRY- 値を
1に設定して、OpenTelemetry送信を有効化する。
- 値を
OTEL_METRICS_EXPORTER- メトリクス出力先を指定する。
otlp、console
OTEL_LOGS_EXPORTER- ログ出力先を指定する。
otlp、console
OTEL_EXPORTER_OTLP_PROTOCOL- プロトコルを指定する。
grpc、http
OTEL_EXPORTER_OTLP_ENDPOINT- エンドポイントURLを指定する。
- 例: http://localhost:4317
動作制御・パフォーマンス
Bashコマンド設定
BASH_DEFAULT_TIMEOUT_MS- Bashコマンドのデフォルトタイムアウト (ミリ秒) を設定する。
- デフォルトは、
120000(2分) である。
BASH_MAX_TIMEOUT_MS- Bashコマンドの最大タイムアウト (ミリ秒) を設定する。
- デフォルトは、
600000(10分) である。
BASH_MAX_OUTPUT_LENGTH- Bashコマンド出力の最大文字数を設定する。
- 大量出力によるコンテキスト過負荷を防止する。
MCPサーバ設定
MCP_TIMEOUT- MCPサーバの起動タイムアウト (ミリ秒) を設定する。
- 初期化に時間を要するサーバの場合に増加させる。
MCP_TOOL_TIMEOUT- MCPツール個別の実行タイムアウト (ミリ秒) を設定する。
ファイル監視設定
CHOKIDAR_INTERVAL- ファイルウォッチングの間隔 (ミリ秒) を設定する。
- chokidarライブラリのポーリング間隔を制御する。
機能制御
メモリ・バックグラウンド機能
CLAUDE_CODE_DISABLE_AUTO_MEMORY- 値を
1に設定して自動メモリ機能を無効化する。
- 値を
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS- 値を
1に設定してバックグラウンドタスクを無効化する。 - リソース制約環境で有用な設定である。
- 値を
プロンプトキャッシュ・ツール検索
DISABLE_PROMPT_CACHING- 設定するとプロンプトキャッシュを無効化する。
ENABLE_TOOL_SEARCH- MCPツールの遅延読み込み最適化を制御する。
- コンテキストの10[%]を超えるツールは動的に読み込まれる。
その他の機能制御
CLAUDE_CODE_SHELL- シェル自動検出を上書きする。
- bash、zsh、fish等
DISABLE_AUTOUPDATER- 値を
1に設定して自動更新を無効化する。 - バージョン固定が必要な環境向けの設定である。
- 値を
FORCE_CODE_TERMINAL- ターミナルモードを強制する。
DISABLE_INSTALLATION_CHECKS- 値を
1に設定してインストール状態チェックを無効化する。
- 値を
システム・設定
CLAUDE_CODE_TMPDIR- テンポラリディレクトリのパスを指定する。
- デフォルトは、OSのデフォルト (/tmpディレクトリ) である。
- セッションアーティファクト、プランファイル等が保存される。
CLAUDE_CONFIG_DIR- Claude Codeの設定ディレクトリの場所を指定する。
- デフォルトは、~/.claudeディレクトリ である。
環境変数一覧
下表に、全環境変数のクイックリファレンスを示す。
| 環境変数 | カテゴリ | 説明 | デフォルト値 |
|---|---|---|---|
ANTHROPIC_API_KEY |
認証 | APIキー | - |
CLAUDE_CODE_OAUTH_TOKEN |
認証 | OAuthトークン | - |
ANTHROPIC_AUTH_TOKEN |
認証 | 認証トークン | - |
ANTHROPIC_CUSTOM_HEADERS |
認証 | カスタムHTTPヘッダー | - |
ANTHROPIC_MODEL |
モデル | デフォルトモデル | claude-sonnet-4-5 |
ANTHROPIC_DEFAULT_OPUS_MODEL |
モデル | Opusモデルの指定 | 最新のOpus |
ANTHROPIC_DEFAULT_SONNET_MODEL |
モデル | Sonnetモデルの指定 | 最新のSonnet |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
モデル | Haikuモデルの指定 | 最新のHaiku |
CLAUDE_CODE_SUBAGENT_MODEL |
モデル | サブエージェントモデル | - |
CLAUDE_CODE_EFFORT_LEVEL |
モデル | 推論努力レベル | high |
CLAUDE_CODE_MAX_OUTPUT_TOKENS |
トークン | 最大出力トークン数 | 16384 |
MAX_THINKING_TOKENS |
トークン | 最大思考トークン数 | - |
MAX_MCP_OUTPUT_TOKENS |
トークン | MCP最大出力トークン数 | - |
ANTHROPIC_BASE_URL |
ネットワーク | APIエンドポイント | https://api.anthropic.com |
HTTPS_PROXY |
ネットワーク | HTTPSプロキシ | - |
HTTP_PROXY |
ネットワーク | HTTPプロキシ | - |
NO_PROXY |
ネットワーク | プロキシ除外ホスト | - |
NODE_EXTRA_CA_CERTS |
ネットワーク | CA証明書パス | - |
CLAUDE_CODE_USE_BEDROCK |
Bedrock | Bedrock有効化 | - |
AWS_REGION |
Bedrock | AWSリージョン | - |
AWS_ACCESS_KEY_ID |
Bedrock | AWSアクセスキーID | - |
AWS_SECRET_ACCESS_KEY |
Bedrock | AWSシークレットキー | - |
AWS_SESSION_TOKEN |
Bedrock | AWSセッショントークン | - |
AWS_BEARER_TOKEN_BEDROCK |
Bedrock | Bedrock認証トークン | - |
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION |
Bedrock | Haiku専用リージョン | - |
BEDROCK_DISABLE_STREAMING |
Bedrock | ストリーミング無効化 | - |
CLAUDE_CODE_USE_VERTEX |
Vertex AI | Vertex AI有効化 | - |
ANTHROPIC_VERTEX_PROJECT_ID |
Vertex AI | GCPプロジェクトID | - |
CLOUD_ML_REGION |
Vertex AI | リージョン | global |
CLAUDE_CODE_USE_FOUNDRY |
Foundry | Foundry有効化 | - |
ANTHROPIC_FOUNDRY_RESOURCE |
Foundry | Azureリソース名 | - |
ANTHROPIC_FOUNDRY_BASE_URL |
Foundry | FoundryベースURL | - |
ANTHROPIC_FOUNDRY_API_KEY |
Foundry | Foundry APIキー | - |
DISABLE_TELEMETRY |
テレメトリ | テレメトリ無効化 | - |
DISABLE_ERROR_REPORTING |
テレメトリ | エラー報告無効化 | - |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC |
テレメトリ | 非必須通信一括無効化 | - |
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY |
テレメトリ | フィードバックアンケート無効化 | - |
CLAUDE_CODE_ENABLE_TELEMETRY |
テレメトリ | OpenTelemetry有効化 | - |
OTEL_METRICS_EXPORTER |
テレメトリ | メトリクス出力先 | - |
OTEL_LOGS_EXPORTER |
テレメトリ | ログ出力先 | - |
OTEL_EXPORTER_OTLP_PROTOCOL |
テレメトリ | OTLPプロトコル | - |
OTEL_EXPORTER_OTLP_ENDPOINT |
テレメトリ | OTLPエンドポイントURL | - |
BASH_DEFAULT_TIMEOUT_MS |
パフォーマンス | Bashデフォルトタイムアウト | 120000 |
BASH_MAX_TIMEOUT_MS |
パフォーマンス | Bash最大タイムアウト | 600000 |
BASH_MAX_OUTPUT_LENGTH |
パフォーマンス | Bash最大出力長 | - |
MCP_TIMEOUT |
パフォーマンス | MCPサーバータイムアウト | - |
MCP_TOOL_TIMEOUT |
パフォーマンス | MCPツールタイムアウト | - |
CHOKIDAR_INTERVAL |
パフォーマンス | ファイル監視間隔 | - |
CLAUDE_CODE_DISABLE_AUTO_MEMORY |
機能 | 自動メモリ無効化 | - |
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS |
機能 | バックグラウンドタスク無効化 | - |
DISABLE_PROMPT_CACHING |
機能 | プロンプトキャッシュ無効化 | - |
ENABLE_TOOL_SEARCH |
機能 | ツール検索 | - |
CLAUDE_CODE_SHELL |
機能 | シェル指定 | 自動検出 |
DISABLE_AUTOUPDATER |
機能 | 自動更新無効化 | - |
FORCE_CODE_TERMINAL |
機能 | ターミナルモード強制 | - |
DISABLE_INSTALLATION_CHECKS |
機能 | インストールチェック無効化 | - |
CLAUDE_CODE_TMPDIR |
システム | テンポラリディレクトリ | /tmp |
CLAUDE_CONFIG_DIR |
システム | 設定ディレクトリ | ~/.claude |
実用的なユースケース
企業環境でのプロキシ設定
企業ネットワークでプロキシサーバーを経由してClaude Codeを使用する場合の設定例を以下に示す。
# 企業プロキシ設定
export HTTPS_PROXY="http://proxy.corporate.com:8080"
export HTTP_PROXY="http://proxy.corporate.com:8080"
export NO_PROXY="localhost,127.0.0.1,.internal.corporate.com"
# 自社プロキシのTLS検査に対応するCA証明書の設定
export NODE_EXTRA_CA_CERTS="/etc/ssl/certs/corporate-ca-bundle.crt"
# テレメトリの無効化 (企業ポリシーに応じて)
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=true
AWS Bedrockを使用した構成
AWS Bedrockを使用して、AWS上でホストされるClaudeモデルを利用する場合の設定例を以下に示す。
# Bedrock有効化
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION="us-east-1"
# IAM認証
export AWS_ACCESS_KEY_ID="AKIAXXXXXXXXXXXXXXXX"
export AWS_SECRET_ACCESS_KEY="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# モデルの指定 (オプション)
export ANTHROPIC_MODEL="us.anthropic.claude-sonnet-4-5-20250929-v1:0"
# Haikuモデルに別リージョンを使用 (オプション)
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION="us-west-2"
コスト最適化のための設定
APIコストを抑えるための環境変数の設定例を以下に示す。
# 軽量モデルをデフォルトに設定
export ANTHROPIC_MODEL="claude-haiku-4-5"
# 出力トークンを制限
export CLAUDE_CODE_MAX_OUTPUT_TOKENS="8192"
# 推論努力レベルを下げる
export CLAUDE_CODE_EFFORT_LEVEL="low"
# プロンプトキャッシュを有効化 (デフォルト)
# DISABLE_PROMPT_CACHING は設定しない
セキュリティ上の注意事項
- APIキーやトークンは、環境変数 または settings.json で管理し、ソースコードにハードコードしない。
- settings.local.json を使用する場合は、.gitignore に追加してバージョン管理から除外する。
- チームで共有する settings.json にはAPIキーを含めない。
- AWS認証情報やGCP認証情報は、一時的なセッショントークンやIAMロールの使用を推奨する。
- 環境変数
ANTHROPIC_CUSTOM_HEADERSに機密情報を含める場合はシェルプロファイルで設定し、settings.json には記載しない。
参考リンク
- Claude Code公式ドキュメント - Settings
- Claude Code公式ドキュメント - Amazon Bedrock
- Claude Code公式ドキュメント - Google Vertex AI
- Claude Code公式ドキュメント - Monitoring
