Environment Variables

อ้างอิงสำหรับ environment variables ที่ควบคุม Claude Code behavior

Environment variables สามารถควบคุม Claude Code behavior เช่น model selection, authentication, request routing และ feature toggles พฤติกรรมเดียวกันหลายอย่างสามารถกำหนดค่าได้ผ่าน settings file, CLI flag หรือ in-session command เช่น /model

ตั้ง environment variables

ใน shell ของคุณ

ตั้ง variable ก่อน launch claude:

macOS, Linux, WSL:

export API_TIMEOUT_MS="1200000"
claude

เพื่อตั้งสำหรับทุก session เพิ่มบรรทัด export ใน ~/.bashrc, ~/.zshrc หรือไฟล์ profile ของ shell

Windows PowerShell:

$env:API_TIMEOUT_MS = "1200000"
claude

Windows CMD:

set API_TIMEOUT_MS=1200000
claude

ใน settings files

เพิ่ม variables ภายใต้ key env ใน settings.json:

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

ไฟล์	ใช้กับ
~/.claude/settings.json	คุณ ในทุกโปรเจกต์
.claude/settings.json	ทุกคนที่ทำงานในโปรเจกต์
.claude/settings.local.json	คุณ ในโปรเจกต์นี้เท่านั้น
Managed settings	ทุกคนในองค์กร

ลำดับความสำคัญ

environment variable มีความสำคัญเหนือกว่า settings field เมื่อพฤติกรรมเดียวกันมีทั้งสองอย่าง

Claude Code อ่าน environment variables เมื่อเริ่มต้น ดังนั้นการเปลี่ยนแปลงมีผลเมื่อ launch claude ครั้งถัดไป

ตัวแปร

Authentication

ตัวแปร	คำอธิบาย
ANTHROPIC_API_KEY	API key สำหรับยืนยันตัวตนกับ Anthropic API โดยตรง
ANTHROPIC_AUTH_TOKEN	OAuth token สำหรับ claude.ai subscription authentication
ANTHROPIC_AWS_API_KEY	Workspace API key สำหรับ Claude Platform on AWS
ANTHROPIC_FOUNDRY_API_KEY	API key สำหรับ Microsoft Foundry
CLAUDE_CODE_OAUTH_TOKEN	OAuth token สำหรับ Claude Code authentication

Endpoint configuration

ตัวแปร	คำอธิบาย
ANTHROPIC_BASE_URL	Base URL ของ Anthropic API
ANTHROPIC_AWS_BASE_URL	Base URL override สำหรับ Claude Platform on AWS
ANTHROPIC_VERTEX_BASE_URL	Base URL override สำหรับ Google Vertex AI
ANTHROPIC_BEDROCK_BASE_URL	Base URL override สำหรับ Amazon Bedrock
CLAUDE_CODE_USE_ANTHROPIC_AWS	ตั้งเป็น 1 เพื่อ route requests ผ่าน Claude Platform on AWS
CLAUDE_CODE_USE_BEDROCK	ตั้งเป็น 1 เพื่อใช้ Amazon Bedrock
CLAUDE_CODE_USE_VERTEX	ตั้งเป็น 1 เพื่อใช้ Google Vertex AI
ANTHROPIC_AWS_WORKSPACE_ID	Workspace ID สำหรับ Claude Platform on AWS
AWS_REGION	AWS region สำหรับ Bedrock หรือ Claude Platform on AWS

Model configuration

ตัวแปร	คำอธิบาย
ANTHROPIC_MODEL	Model ID หรือ alias ที่ใช้ใน session
ANTHROPIC_DEFAULT_HAIKU_MODEL	Model ID สำหรับ haiku alias
ANTHROPIC_DEFAULT_SONNET_MODEL	Model ID สำหรับ sonnet alias
ANTHROPIC_DEFAULT_OPUS_MODEL	Model ID สำหรับ opus alias
ANTHROPIC_DEFAULT_FABLE_MODEL	Model ID สำหรับ fable alias
MAX_THINKING_TOKENS	Budget tokens สำหรับ extended thinking
CLAUDE_CODE_EFFORT_LEVEL	Override effort level

Timeout และ performance

ตัวแปร	คำอธิบาย
API_TIMEOUT_MS	Per-request timeout เป็น milliseconds (ค่าเริ่มต้น: 600000)
BASH_DEFAULT_TIMEOUT_MS	Default timeout สำหรับ Bash commands
BASH_MAX_TIMEOUT_MS	Maximum timeout ที่ Claude สามารถขอสำหรับ Bash commands
CLAUDE_CODE_MAX_RETRIES	จำนวน retry attempts (ค่าเริ่มต้น: 10)
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY	จำนวนสูงสุดของ tool calls ที่รัน parallel

Feature toggles

ตัวแปร	คำอธิบาย
CLAUDE_CODE_DISABLE_AGENT_VIEW	ตั้งเป็น 1 เพื่อปิดใช้งาน agent view
CLAUDE_CODE_DISABLE_WORKFLOWS	ตั้งเป็น 1 เพื่อปิดใช้งาน workflows
CLAUDE_CODE_DISABLE_THINKING	ตั้งเป็น 1 เพื่อปิดใช้งาน extended thinking
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS	ตั้งเป็น 1 เพื่อปิดใช้งาน background tasks
CLAUDE_CODE_DISABLE_FAST_MODE	ตั้งเป็น 1 เพื่อปิดใช้งาน fast mode
CLAUDE_CODE_DISABLE_1M_CONTEXT	ตั้งเป็น 1 เพื่อลบ 1M context variants จาก model picker
ENABLE_PROMPT_CACHING_1H	ตั้งเป็น 1 เพื่อขอ 1-hour cache TTL
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS	ตั้งเป็น 1 เพื่อเปิดใช้งาน agent teams

TLS และ security

ตัวแปร	คำอธิบาย
CLAUDE_CODE_CERT_STORE	Path ไปยัง custom CA certificate store
CLAUDE_CODE_CLIENT_CERT	Path ไปยัง client certificate file
CLAUDE_CODE_CLIENT_KEY	Path ไปยัง client private key file
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH	ตั้งเป็น 1 เพื่อส่ง requests โดยไม่ลงนาม

UI และ rendering

ตัวแปร	คำอธิบาย
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN	ปิดใช้งาน alternate screen mode
CLAUDE_CODE_DISABLE_MOUSE	ปิดใช้งาน mouse support
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL	ปิดใช้งาน virtual scroll

Debugging

ตัวแปร	คำอธิบาย
CLAUDE_CODE_DEBUG_LOGS_DIR	Directory สำหรับ debug log files
CLAUDE_CODE_DEBUG_LOG_LEVEL	Log level สำหรับ debug output

Miscellaneous

ตัวแปร	คำอธิบาย
CLAUDE_CODE_SKIP_PROMPT_HISTORY	ปิดใช้งาน session persistence ในทุก mode
CLAUDE_CODE_SIMPLE	ตั้งโดย --bare flag สำหรับ minimal mode
CLAUDE_CODE_SAFE_MODE	ตั้งโดย --safe-mode flag
CLAUDE_CODE_REMOTE	ตั้งเป็น true ใน cloud sessions
CLAUDE_CODE_REMOTE_SESSION_ID	Session ID ของ cloud session ปัจจุบัน
CLAUDE_PROJECT_DIR	Project directory สำหรับ cloud sessions
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX	Prefix สำหรับ Remote Control session names อัตโนมัติ
CLAUDE_ENV_FILE	File สำหรับ persist environment variables ใน hooks
ANTHROPIC_DEFAULT_FABLE_MODEL	Model ID สำหรับ Fable model
awsAuthRefresh	Command เพื่อ refresh AWS credentials