Biến môi trường điều khiển hành vi của Claude Code: chọn model, xác thực, định tuyến request, bật/tắt tính năng… Phần lớn các hành vi này cũng có thể cấu hình qua field trong settings file, CLI flag, hoặc lệnh trong phiên như /model.
Cách đặt biến môi trường
Phần tiêu đề “Cách đặt biến môi trường”Biến đặt trong shell chỉ có hiệu lực cho phiên terminal đó; biến đặt trong settings file có hiệu lực mỗi lần claude chạy.
Trong shell
Phần tiêu đề “Trong shell”Đặt biến trước khi khởi động claude:
macOS, Linux, WSL
export API_TIMEOUT_MS="1200000"claudeĐể áp dụng cho mọi phiên, thêm dòng export vào ~/.bashrc, ~/.zshrc, hoặc file profile của shell bạn.
Windows PowerShell
$env:API_TIMEOUT_MS = "1200000"claudeĐể áp dụng cho mọi phiên: chạy [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User") rồi mở terminal mới.
Windows CMD
set API_TIMEOUT_MS=1200000claudeĐể áp dụng cho mọi phiên: chạy setx API_TIMEOUT_MS "1200000" rồi mở terminal mới.
Lệnh gán không in gì ra khi thành công, nên kiểm tra lại bằng cách in giá trị ra trong cùng shell trước khi chạy claude (echo $API_TIMEOUT_MS trên macOS/Linux/WSL, echo $env:API_TIMEOUT_MS trên PowerShell, echo %API_TIMEOUT_MS% trên CMD).
Trong settings file
Phần tiêu đề “Trong settings file”Thêm biến vào key env trong file settings.json (tạo file nếu chưa có). Claude Code đọc trực tiếp từ file này nên chúng có hiệu lực bất kể claude được khởi động thế nào. Một phiên đang chạy sẽ áp dụng giá trị mới/thay đổi vào environment ngay khi bạn lưu file, nhưng một tính năng chỉ đọc biến của nó một lần lúc khởi động (ví dụ OpenTelemetry monitoring) vẫn giữ giá trị lúc khởi động cho tới khi bạn khởi động lại claude. Xoá một biến khỏi file không unset nó trong phiên đang chạy - việc xoá chỉ có hiệu lực ở lần chạy claude tiếp theo.
{ "env": { "API_TIMEOUT_MS": "1200000", "BASH_DEFAULT_TIMEOUT_MS": "300000" }}File bạn chọn quyết định biến áp dụng cho ai:
| File | Áp dụng cho |
|---|---|
~/.claude/settings.json | Bạn, ở mọi project |
.claude/settings.json | Mọi người làm việc trong project, được checked vào source control |
.claude/settings.local.json | Chỉ bạn, chỉ trong project này, gitignore khi Claude Code tự lưu setting vào đây; tự thêm vào gitignore nếu bạn tạo file này thủ công |
| Managed settings | Mọi người trong tổ chức, do admin triển khai |
Xem Settings files để biết mỗi file nằm ở đâu, và Settings precedence để biết cách chúng kết hợp khi nhiều file cùng đặt một biến.
Thứ tự ưu tiên (Precedence)
Phần tiêu đề “Thứ tự ưu tiên (Precedence)”Một số hành vi có cả biến môi trường lẫn settings key riêng. Nếu đặt cả hai, biến môi trường thắng. Ví dụ ANTHROPIC_MODEL ghi đè setting model, và CLAUDE_CODE_AUTO_CONNECT_IDE ghi đè autoConnectIde. Claude Code chỉ dùng settings key khi biến môi trường chưa được đặt.
Khi cùng một biến được đặt cả trong shell lẫn trong khối env của settings file, giá trị trong settings file thắng. Claude Code ghi từng entry env vào process environment lúc khởi động và mỗi khi file thay đổi, ghi đè giá trị kế thừa từ shell. Một vài biến là ngoại lệ đặc biệt - xem env setting.
Trong settings file bạn có thể đặt một biến nhưng không thể xoá nó. Để ghi đè một biến bạn không xoá được (ví dụ CLAUDE_CODE_USE_VERTEX cũ do shell profile không kiểm soát export ra), đặt nó thành chuỗi rỗng trong khối env: "CLAUDE_CODE_USE_VERTEX": "". Claude Code coi giá trị rỗng là chưa đặt khi chọn provider. Subprocess vẫn kế thừa giá trị rỗng đó.
Giữa các settings file, giá trị env theo thứ tự ưu tiên settings, nên một entry trong managed settings ghi đè cùng biến ở user hoặc project settings.
Cách một biến môi trường tương tác với CLI flag và lệnh trong phiên tuỳ từng tính năng: --model và /model ghi đè ANTHROPIC_MODEL, còn CLAUDE_CODE_EFFORT_LEVEL ghi đè /effort. Khi một biến tương tác với nguồn cấu hình khác, dòng của nó trong bảng Variables bên dưới sẽ nêu rõ thứ tự ưu tiên hoặc link tới trang mô tả.
Claude Code đọc biến môi trường shell lúc khởi động, nên thay đổi chỉ có hiệu lực ở lần chạy claude tiếp theo. Biến đặt dưới key env trong settings file được áp dụng lại cho phiên đang chạy khi file thay đổi, trừ ngoại lệ chỉ-đọc-lúc-khởi-động đã nêu ở trên.
Danh sách biến (Variables)
Phần tiêu đề “Danh sách biến (Variables)”Các biến số (timeout, token budget, số lần retry…) chấp nhận ký hiệu khoa học và cách viết có dấu phân cách chữ số ngoài chữ số thường, trừ khi dòng của biến ghi rõ chỉ nhận chữ số thường. Ví dụ, Claude Code đọc 2e3 là 2000 và 64_000 là 64000. Trước v2.1.211, các cách viết này có thể âm thầm đặt giá trị nhỏ hơn nhiều - ví dụ 1e6 đặt timeout thành 1.
| Biến | Công dụng |
|---|---|
ANTHROPIC_API_KEY | API key gửi qua header X-Api-Key. Khi đặt, key này được dùng thay cho subscription Pro/Max/Team/Enterprise dù bạn đã đăng nhập. Ở chế độ non-interactive (-p) key luôn được dùng nếu có mặt; ở chế độ interactive bạn được hỏi xác nhận một lần trước khi nó ghi đè subscription. Chạy unset ANTHROPIC_API_KEY để quay lại dùng subscription |
ANTHROPIC_AUTH_TOKEN | Giá trị tuỳ chỉnh cho header Authorization (tự động có tiền tố Bearer ) |
ANTHROPIC_AWS_API_KEY | Workspace API key cho Claude Platform on AWS, tạo trong AWS Console. Gửi qua header x-api-key, ưu tiên hơn AWS SigV4 |
ANTHROPIC_AWS_BASE_URL | Ghi đè endpoint URL của Claude Platform on AWS. Dùng cho region tuỳ chỉnh hoặc khi định tuyến qua LLM gateway. Mặc định https://aws-external-anthropic.{AWS_REGION}.api.aws |
ANTHROPIC_AWS_WORKSPACE_ID | Bắt buộc cho Claude Platform on AWS. Gửi trên mọi request qua header anthropic-workspace-id |
ANTHROPIC_BASE_URL | Ghi đè API endpoint để định tuyến request qua proxy/gateway. Khi trỏ tới host không phải first-party, MCP tool search mặc định bị tắt - đặt ENABLE_TOOL_SEARCH=true nếu proxy của bạn forward block tool_reference |
ANTHROPIC_BEDROCK_BASE_URL | Ghi đè endpoint URL của Amazon Bedrock. Xem Amazon Bedrock |
ANTHROPIC_BEDROCK_MANTLE_BASE_URL | Ghi đè endpoint URL của Amazon Bedrock Mantle. Xem Mantle endpoint |
ANTHROPIC_BEDROCK_SERVICE_TIER | Service tier của Amazon Bedrock (default, flex, hoặc priority). Gửi qua header X-Amzn-Bedrock-Service-Tier |
ANTHROPIC_BETAS | Danh sách giá trị anthropic-beta bổ sung, cách nhau bằng dấu phẩy, để dùng thử một beta API trước khi Claude Code hỗ trợ chính thức. Khác với flag --betas (yêu cầu xác thực bằng API key), biến này hoạt động với mọi phương thức xác thực kể cả subscription Claude.ai |
ANTHROPIC_CUSTOM_HEADERS | Header tuỳ chỉnh thêm vào request (định dạng Name: Value, nhiều header cách nhau bằng dòng mới) |
ANTHROPIC_CUSTOM_MODEL_OPTION | Model ID thêm làm một entry tuỳ chỉnh trong bộ chọn /model, để chọn được model không chuẩn hoặc riêng của gateway mà không thay thế alias có sẵn |
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION | Mô tả hiển thị cho entry model tuỳ chỉnh trong /model. Mặc định Custom model (<model-id>) |
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME | Tên hiển thị cho entry model tuỳ chỉnh trong /model. Mặc định là model ID |
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES | Danh sách capability (ví dụ effort,thinking) mà model tuỳ chỉnh hỗ trợ, cách nhau bằng dấu phẩy |
ANTHROPIC_DEFAULT_FABLE_MODEL | Model ID mà alias fable trỏ tới, và ID Claude Code nhận diện là Fable 5 cho automatic model fallback trên provider bên thứ ba |
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION | Mô tả hiển thị cho model Fable đã pin trong /model. Mặc định Custom Fable model |
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME | Tên hiển thị cho model Fable đã pin. Mặc định là model ID |
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES | Danh sách capability model Fable đã pin hỗ trợ, ví dụ effort,thinking |
ANTHROPIC_DEFAULT_HAIKU_MODEL | Model ID mà alias haiku trỏ tới, cũng dùng cho tác vụ nền |
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION | Mô tả hiển thị cho model Haiku đã pin. Mặc định Custom Haiku model |
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME | Tên hiển thị cho model Haiku đã pin. Mặc định là model ID |
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES | Danh sách capability model Haiku đã pin hỗ trợ |
ANTHROPIC_DEFAULT_OPUS_MODEL | Model ID mà alias opus trỏ tới, và opusplan dùng khi Plan Mode đang bật |
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION | Mô tả hiển thị cho model Opus đã pin. Mặc định Custom Opus model (hoặc có hậu tố (1M context) nếu model ID có [1m] và CLAUDE_CODE_DISABLE_1M_CONTEXT chưa bật) |
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME | Tên hiển thị cho model Opus đã pin. Mặc định là model ID |
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES | Danh sách capability model Opus đã pin hỗ trợ |
ANTHROPIC_DEFAULT_SONNET_MODEL | Model ID mà alias sonnet trỏ tới, và opusplan dùng khi Plan Mode không bật |
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION | Mô tả hiển thị cho model Sonnet đã pin. Mặc định Custom Sonnet model (tương tự quy tắc (1M context) như Opus ở trên) |
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME | Tên hiển thị cho model Sonnet đã pin. Mặc định là model ID |
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES | Danh sách capability model Sonnet đã pin hỗ trợ |
ANTHROPIC_FOUNDRY_API_KEY | API key xác thực Microsoft Foundry |
ANTHROPIC_FOUNDRY_AUTH_TOKEN | Bearer token xác thực Microsoft Foundry (ví dụ Microsoft Entra access token), gửi qua header Authorization: Bearer. Ưu tiên hơn ANTHROPIC_FOUNDRY_API_KEY và Azure default credential chain |
ANTHROPIC_FOUNDRY_BASE_URL | Base URL đầy đủ cho Microsoft Foundry resource, thay thế cho ANTHROPIC_FOUNDRY_RESOURCE |
ANTHROPIC_FOUNDRY_RESOURCE | Tên resource Microsoft Foundry. Bắt buộc nếu ANTHROPIC_FOUNDRY_BASE_URL chưa đặt |
ANTHROPIC_MODEL | Tên model setting để dùng - xem Model Configuration |
ANTHROPIC_SMALL_FAST_MODEL | (deprecated) Tên model dòng Haiku dùng cho tác vụ nền |
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION | Ghi đè AWS region cho model dòng Haiku khi dùng Amazon Bedrock hoặc Mantle |
ANTHROPIC_VERTEX_BASE_URL | Ghi đè endpoint URL của Google Cloud’s Agent Platform |
ANTHROPIC_VERTEX_PROJECT_ID | GCP project ID cho request Google Cloud’s Agent Platform. Bị ghi đè bởi GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT, hoặc project trong file credential GOOGLE_APPLICATION_CREDENTIALS |
ANTHROPIC_WORKSPACE_ID | Workspace ID cho workload identity federation. Đặt khi federation rule của bạn phạm vi nhiều hơn một workspace |
API_FORCE_IDLE_TIMEOUT | Ghi đè idle timeout 5 phút làm huỷ streaming response khi không có byte nào tới. Đặt 0 để tắt, 1 để luôn bật trên mọi provider. Mặc định (chưa đặt): tắt trên Anthropic API trực tiếp và Claude Platform on AWS, bật trên các provider khác |
API_TIMEOUT_MS | Timeout cho API request tính bằng mili giây (mặc định 600000, tức 10 phút; tối đa 2147483647). Tăng khi request timeout trên mạng chậm hoặc qua proxy |
AWS_BEARER_TOKEN_BEDROCK | Amazon Bedrock API key để xác thực |
BASH_DEFAULT_TIMEOUT_MS | Timeout mặc định cho lệnh bash chạy lâu (mặc định 120000, tức 2 phút) |
BASH_MAX_OUTPUT_LENGTH | Số ký tự tối đa trong output bash trước khi output đầy đủ được lưu vào file và Claude nhận đường dẫn kèm preview ngắn. Xem Bash tool behavior |
BASH_MAX_TIMEOUT_MS | Timeout tối đa model có thể đặt cho lệnh bash chạy lâu (mặc định 600000, tức 10 phút) |
CCR_FORCE_BUNDLE | Đặt 1 để buộc claude --cloud bundle và upload repo local ngay cả khi có quyền truy cập GitHub |
CLAUDECODE | Đặt 1 trong mọi subprocess Claude Code sinh ra (Bash, PowerShell, tmux, hook, status line, stdio MCP server). IDE extension cũng đặt biến này trong terminal tích hợp của chúng. Dùng để phát hiện script đang chạy trong subprocess do Claude Code sinh ra. Để phân biệt process do tool call/hook sinh trực tiếp với process bên trong stdio MCP server, dùng CLAUDE_CODE_CHILD_SESSION thay thế |
CLAUDE_AFK_COUNTDOWN_MS | Số mili giây trước khi auto-continue mà đếm ngược hiện trên dialog AskUserQuestion chưa trả lời. Mặc định 20000 (20 giây), chỉ có tác dụng khi auto-continue đang bật |
CLAUDE_AFK_TIMEOUT_MS | Số mili giây idle trước khi một dialog AskUserQuestion chưa trả lời tự động tiếp tục mà không cần bạn. Auto-continue mặc định tắt, bật qua setting askUserQuestionTimeout; biến này ghi đè và bật cưỡng bức auto-continue. Đặt 0 không tắt timeout mà đóng dialog ngay lập tức |
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS | Đặt 1 để tắt mọi loại subagent built-in (Explore, Plan…). Chỉ áp dụng ở chế độ non-interactive (-p) |
CLAUDE_AGENT_SDK_MCP_NO_PREFIX | Đặt 1 để bỏ tiền tố mcp__<server>__ trên tên tool từ MCP server do SDK tạo. Chỉ dùng cho SDK |
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS | Stall timeout (mili giây) cho subagent chạy nền. Mặc định 600000 (10 phút); bộ đếm reset mỗi khi có sự kiện tiến trình streaming |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE | Đặt phần trăm (1-100) của cửa sổ auto-compaction mà tại đó auto-compaction kích hoạt. Chỉ có thể hạ ngưỡng, không thể nâng lên trên mặc định |
CLAUDE_AUTO_BACKGROUND_TASKS | Đặt 1 để cưỡng bức bật tự động đưa tác vụ agent chạy lâu vào background (khoảng 2 phút chạy sẽ tự chuyển). Cũng bật auto-backgrounding cho MCP tool call chạy lâu ở chế độ non-interactive |
CLAUDE_AX_SCREEN_READER | Đặt 1 để render output thân thiện screen reader: text phẳng, không viền/hoạt ảnh trang trí. Đặt 0 để cưỡng bức tắt kể cả khi setting axScreenReader là true. Flag --ax-screen-reader ưu tiên hơn |
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR | Quay lại thư mục làm việc gốc sau mỗi lệnh Bash/PowerShell trong phiên chính |
CLAUDE_CLIENT_PRESENCE_FILE | Đường dẫn file mà một tool bên ngoài (ví dụ screen-lock listener) tạo khi bạn mở khoá màn hình và xoá khi khoá lại. Trong lúc file tồn tại, Claude Code bỏ qua push notification mobile của Remote Control |
CLAUDE_CODE_ACCESSIBILITY | Đặt 1 để giữ con trỏ terminal gốc hiển thị và tắt chỉ báo con trỏ dạng đảo màu text, giúp screen magnifier theo dõi vị trí con trỏ |
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD | Đặt 1 để nạp memory file (CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md, CLAUDE.local.md) từ các thư mục chỉ định bằng --add-dir. Mặc định các thư mục bổ sung không nạp memory file |
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT | Đặt 1 để vẽ lại toàn bộ màn hình mỗi frame trong fullscreen rendering thay vì cập nhật gia tăng. Dùng khi fullscreen mode hiện text cũ/lệch vị trí |
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT | Đặt 1 để luôn gửi tham số effort với mọi request, kể cả khi Claude Code không nhận diện model ID là hỗ trợ effort. Dùng khi định tuyến qua gateway/provider bên thứ ba dùng ID tuỳ chỉnh |
CLAUDE_CODE_API_KEY_HELPER_TTL_MS | Khoảng thời gian (mili giây) làm mới credential khi dùng apiKeyHelper |
CLAUDE_CODE_ARTIFACT_AUTO_OPEN | Đặt 0 để Claude Code không tự mở trình duyệt khi một artifact mới được publish |
CLAUDE_CODE_ATTRIBUTION_HEADER | Đặt 0 để bỏ attribution block (mang version client và fingerprint prompt) ở đầu system prompt. Không ảnh hưởng caching trên kết nối trực tiếp Anthropic API |
CLAUDE_CODE_AUTO_COMPACT_WINDOW | Đặt dung lượng context (token) dùng để tính auto-compaction. Mặc định bằng context window của model (200K hoặc 1M cho model extended context). Giá trị bị giới hạn ở context window thực của model |
CLAUDE_CODE_AUTO_CONNECT_IDE | Ghi đè kết nối IDE tự động. Đặt false để ngăn tự kết nối, true để cưỡng bức thử kết nối khi auto-detect thất bại (ví dụ tmux che khuất terminal cha). Ưu tiên hơn setting autoConnectIde |
CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS | Thời gian (mili giây) Claude Code chờ AWS default credential provider chain trả credential trước khi request lỗi (mặc định 60000) |
CLAUDE_CODE_BRIDGE_SESSION_ID | Tự động đặt trong subprocess Bash tool và hook command khi phiên có kết nối Remote Control đang hoạt động; giá trị là session ID dạng session_ |
CLAUDE_CODE_CERT_STORE | Danh sách nguồn CA certificate cho kết nối TLS, cách nhau bằng dấu phẩy. bundled là bộ CA Mozilla đi kèm Claude Code; system là trust store hệ điều hành. Mặc định bundled,system |
CLAUDE_CODE_CHILD_SESSION | Đặt 1 trong subprocess do Bash, PowerShell, Monitor tool, hook command, status line command sinh ra. Không đặt cho stdio MCP server subprocess. Khác CLAUDECODE vì chỉ Claude Code tự đặt, không phải IDE extension, nên phân biệt đáng tin cậy phiên lồng nhau |
CLAUDE_CODE_CLIENT_CERT | Đường dẫn file client certificate cho xác thực mTLS |
CLAUDE_CODE_CLIENT_KEY | Đường dẫn file client private key cho xác thực mTLS |
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE | Passphrase cho CLAUDE_CODE_CLIENT_KEY đã mã hoá (tuỳ chọn) |
CLAUDE_CODE_CONNECT_TIMEOUT_MS | (đã gỡ bỏ ở v2.1.186, giờ không có tác dụng) Trước đây đặt timeout riêng cho giai đoạn connect/TLS/response-header. Dùng API_TIMEOUT_MS thay thế |
CLAUDE_CODE_DEBUG_LOGS_DIR | Ghi đè đường dẫn file debug log (đây là đường dẫn file, không phải thư mục). Cần bật debug mode riêng qua --debug, /debug, hoặc biến DEBUG. Mặc định ~/.claude/debug/<session-id>.txt |
CLAUDE_CODE_DEBUG_LOG_LEVEL | Mức log tối thiểu ghi vào debug log file. Giá trị: verbose, debug (mặc định), info, warn, error |
CLAUDE_CODE_DISABLE_1M_CONTEXT | Đặt 1 để tắt hỗ trợ 1M context window. Model variant 1M sẽ không xuất hiện trong bộ chọn model |
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING | Đặt 1 để tắt adaptive reasoning trên Opus 4.6 và Sonnet 4.6, quay về thinking budget cố định theo MAX_THINKING_TOKENS. Không có tác dụng trên Fable 5, Sonnet 5, Opus 4.7 trở lên |
CLAUDE_CODE_DISABLE_ADVISOR_TOOL | Đặt 1 để tắt advisor tool. Lệnh /advisor không còn khả dụng, advisorModel bị bỏ qua |
CLAUDE_CODE_DISABLE_AGENT_VIEW | Đặt 1 để tắt background agent và agent view (claude agents, --bg, /background). Tương đương setting disableAgentView |
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN | Đặt 1 để tắt fullscreen rendering, dùng renderer main-screen cổ điển. Ưu tiên hơn CLAUDE_CODE_NO_FLICKER và setting tui |
CLAUDE_CODE_DISABLE_ARTIFACT | Đặt 1 để tắt tool Artifact. Tương đương setting disableArtifact |
CLAUDE_CODE_DISABLE_ATTACHMENTS | Đặt 1 để tắt xử lý attachment - file mention bằng @ gửi dưới dạng text thường thay vì mở rộng thành nội dung file |
CLAUDE_CODE_DISABLE_AUTO_MEMORY | Đặt 1 để tắt auto memory. Đặt 0 để cưỡng bức bật kể cả khi --bare hoặc autoMemoryEnabled: false |
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS | Đặt 1 để tắt toàn bộ chức năng tác vụ nền: run_in_background trên Bash/subagent, auto-backgrounding, phím tắt Ctrl+B |
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD | Đặt 1 để bỏ qua kiểm tra content-type application/vnd.amazon.eventstream của streaming response Amazon Bedrock - dùng khi gateway rewrite header Content-Type nhưng giữ nguyên body |
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF | Đặt 1 để dừng shell command chạy nền, dynamic workflow, và subagent nền của phiên background khi process của phiên đó dừng/khởi động lại/cập nhật, thay vì chuyển giao chúng cho process tiếp theo |
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP | Đặt 1 để Claude Code không tự huỷ lệnh chạy nền khi hệ điều hành báo memory pressure (mặc định huỷ trên macOS/Linux sau 30 phút idle) |
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS | Đặt 1 để tắt các skill/workflow đi kèm Claude Code. Skill từ plugin, .claude/skills/, .claude/commands/ không bị ảnh hưởng. Tương đương setting disableBundledSkills |
CLAUDE_CODE_DISABLE_CLAUDE_MDS | Đặt 1 để ngăn nạp mọi memory file CLAUDE.md (user, project, auto-memory) vào context |
CLAUDE_CODE_DISABLE_CRON | Đặt 1 để tắt scheduled tasks. Skill /loop và cron tool không còn khả dụng, tác vụ đã lên lịch ngừng chạy |
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS | Đặt 1 để loại bỏ header anthropic-beta và field beta khỏi tool schema trong request - dùng khi proxy gateway từ chối các field này. MCP tool search bị tắt, mọi MCP tool load trước |
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS | Đặt 1 để tắt subagent built-in Explore và Plan; Claude dùng search tool trực tiếp hoặc subagent general-purpose thay thế |
CLAUDE_CODE_DISABLE_FAST_MODE | Đặt 1 để tắt fast mode |
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY | Đặt 1 để tắt khảo sát “How is Claude doing?”. Cũng tự tắt khi DISABLE_TELEMETRY, DO_NOT_TRACK, hoặc CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC được đặt |
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING | Đặt 1 để tắt file checkpointing - lệnh /rewind sẽ không khôi phục được thay đổi code. Ghi đè setting fileCheckpointingEnabled |
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS | Đặt 1 để bỏ hướng dẫn commit/PR built-in và snapshot git status khỏi system prompt. Ưu tiên hơn setting includeGitInstructions |
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP | Đặt 1 để ngăn tự động remap Opus 4.0/4.1 sang bản Opus hiện tại trên Anthropic API |
CLAUDE_CODE_DISABLE_MOUSE | Đặt 1 để tắt mouse tracking trong fullscreen rendering, giữ hành vi copy-on-select gốc của terminal |
CLAUDE_CODE_DISABLE_MOUSE_CLICKS | Đặt 1 để tắt click/drag/hover trong fullscreen rendering nhưng vẫn giữ cuộn chuột. CLAUDE_CODE_DISABLE_MOUSE ưu tiên hơn nếu cả hai được đặt |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | Đặt bất kỳ giá trị không rỗng nào để tắt network traffic không thiết yếu: auto-update, telemetry, error reporting, /feedback, release notes, gateway model discovery, kiểm tra fast mode. Đặt 0/false vẫn tắt - unset biến để bật lại. Cũng tắt feature-flag fetching, khiến Remote Control không khả dụng |
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK | Đặt 1 để tắt fallback non-streaming khi request streaming lỗi giữa chừng - lỗi streaming sẽ đẩy thẳng lên tầng retry |
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK | Đặt 1 để tool PushNotification vẫn gửi notification desktop kể cả khi bạn đang gõ/focus terminal |
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL | Đặt 1 để bỏ qua tự động thêm official plugin marketplace ở lần chạy đầu |
CLAUDE_CODE_DISABLE_POLICY_SKILLS | Đặt 1 để bỏ qua nạp skill từ thư mục managed skills toàn hệ thống. Hữu ích cho container/CI session |
CLAUDE_CODE_DISABLE_TERMINAL_TITLE | Đặt 1 để tắt tự động cập nhật tiêu đề terminal theo ngữ cảnh hội thoại. Trong Agent SDK và claude -p, cũng bỏ qua request nền tạo session title |
CLAUDE_CODE_DISABLE_THINKING | Đặt 1 để bỏ tham số thinking khỏi request hoàn toàn - dùng cho proxy/gateway từ chối tham số này. Để tắt hẳn extended thinking trên Anthropic API, dùng MAX_THINKING_TOKENS=0 thay thế |
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL | Đặt 1 để tắt virtual scrolling trong fullscreen rendering, render mọi message trong transcript |
CLAUDE_CODE_DISABLE_WORKFLOWS | Đặt 1 để tắt workflows. Tương đương setting disableWorkflows |
CLAUDE_CODE_EFFORT_LEVEL | Đặt effort level cho model hỗ trợ: low, medium, high, xhigh, max, hoặc auto. Ưu tiên hơn /effort và setting effortLevel. Xem Adjust effort level |
CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT | Đặt 1 để bật thêm text vào cuối system prompt của mọi subagent. Flag --append-subagent-system-prompt tự động đặt biến này |
CLAUDE_CODE_ENABLE_AUTO_MODE | (chỉ giữ để tương thích ngược, không còn tác dụng) Auto mode nay mặc định khả dụng trên mọi provider |
CLAUDE_CODE_ENABLE_AWAY_SUMMARY | Ghi đè session recap. Đặt 0 để tắt cưỡng bức, 1 để bật cưỡng bức khi setting awaySummaryEnabled là false |
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH | Đặt 1 để làm mới trạng thái plugin ở ranh giới lượt trong non-interactive mode sau khi cài nền xong. Mặc định tắt vì việc này làm mất hiệu lực prompt caching của lượt đó |
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL | Đặt 1 để định tuyến khảo sát chất lượng phiên tới OpenTelemetry collector riêng của bạn khi traffic không thiết yếu tới Anthropic bị chặn |
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING | Kiểm soát việc tool call input có stream dần khi Claude sinh ra hay không. Mặc định bật trên Anthropic API. Đặt 0 để tắt, 1 để cưỡng bức bật khi qua proxy |
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY | Đặt 1 để nạp bộ chọn /model từ endpoint /v1/models của gateway khi ANTHROPIC_BASE_URL trỏ tới gateway tương thích Anthropic (LiteLLM, Kong…). Model phát hiện được vẫn lọc theo allowlist availableModels |
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE | (đã gỡ bỏ ở v2.1.142) Trước đây dùng khi fast mode mặc định chuyển từ Opus 4.6 sang 4.7 |
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION | Đặt false để tắt prompt suggestions - gợi ý xám mờ hiện trong ô nhập sau khi Claude trả lời |
CLAUDE_CODE_ENABLE_TASKS | Kiểm soát dùng Task tools (TaskCreate, TaskUpdate, TaskGet, TaskList) hay tool TodoWrite cũ. Task tools là mặc định từ v2.1.142; đặt 0 để quay lại TodoWrite |
CLAUDE_CODE_ENABLE_TELEMETRY | Đặt 1 để bật thu thập dữ liệu OpenTelemetry (metric, log). Cần bật trước khi cấu hình OTel exporter |
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY | Thời gian (mili giây) chờ sau khi query loop rảnh trước khi tự thoát. Hữu ích cho workflow tự động dùng SDK mode |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS | Đặt 1 để bật agent teams - tính năng thử nghiệm, mặc định tắt |
CLAUDE_CODE_EXTRA_BODY | JSON object hợp nhất vào top level của mọi request body - dùng để truyền tham số riêng của provider mà Claude Code chưa hỗ trợ trực tiếp |
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS | Ghi đè giới hạn token mặc định khi đọc file - hữu ích khi cần đọc trọn file lớn |
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE | Đặt 1 để cưỡng bức lưu transcript, prompt history, đăng ký claude agents kể cả khi claude này được khởi động từ bên trong một phiên Claude Code khác |
CLAUDE_CODE_FORCE_STRIKETHROUGH | Đặt 1 để cưỡng bức render gạch ngang cho ~~text~~ khi terminal hỗ trợ nhưng không được auto-detect (ví dụ SSH không forward TERM_PROGRAM) |
CLAUDE_CODE_FORCE_SYNC_OUTPUT | Đặt 1 để cưỡng bức bật DEC private mode 2026 (synchronized output) khi terminal hỗ trợ nhưng không auto-detect được. Không có tác dụng dưới tmux |
CLAUDE_CODE_FORK_SUBAGENT | Đặt 1 để cho phép Claude sinh forked subagent (kế thừa toàn bộ context hội thoại cha), 0 để tắt |
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT | Đặt 1 để phát text/thinking block của subagent trong output claude -p --output-format stream-json, giống flag --forward-subagent-text |
CLAUDE_CODE_GIT_BASH_PATH | Chỉ Windows: đường dẫn tới bash.exe của Git Bash. Dùng khi Git Bash đã cài nhưng không nằm trong PATH |
CLAUDE_CODE_GLOB_HIDDEN | Đặt false để loại dotfile khỏi kết quả tool Glob (mặc định gồm cả dotfile) |
CLAUDE_CODE_GLOB_NO_IGNORE | Đặt false để tool Glob tuân theo .gitignore. Mặc định Glob trả về cả file bị gitignore |
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS | Timeout (giây) cho việc tìm file của Glob. Mặc định 20 giây, 60 giây trên WSL |
CLAUDE_CODE_HIDE_CWD | Đặt 1 để ẩn thư mục làm việc trong logo khởi động - hữu ích khi ghi màn hình/chia sẻ |
CLAUDE_CODE_IDE_HOST_OVERRIDE | Ghi đè địa chỉ host dùng để kết nối IDE extension |
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL | Đặt 1 để bỏ qua tự động cài IDE extension. Tương đương setting autoInstallIdeExtension: false |
CLAUDE_CODE_IDE_SKIP_VALID_CHECK | Đặt 1 để bỏ qua kiểm tra hợp lệ entry IDE lockfile lúc kết nối |
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS | Số subagent tối đa chạy đồng thời trong một phiên trước khi Agent tool từ chối sinh thêm (mặc định 20) |
CLAUDE_CODE_MAX_CONTEXT_TOKENS | Ghi đè context window Claude Code giả định cho model đang dùng - dùng khi định tuyến tới model qua ANTHROPIC_BASE_URL có context window không khớp kích thước built-in |
CLAUDE_CODE_MAX_OUTPUT_TOKENS | Đặt số output token tối đa cho hầu hết request. Mặc định 32000 với model ID không nhận diện được |
CLAUDE_CODE_MAX_RETRIES | Ghi đè số lần retry request lỗi (mặc định 10, giới hạn 15 kể từ v2.1.186; CLAUDE_CODE_RETRY_WATCHDOG nâng mặc định và bỏ giới hạn) |
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION | Giới hạn tổng số subagent một phiên có thể sinh qua Agent tool (mặc định 200) |
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH | Số tầng subagent cho phép bên dưới hội thoại chính (mặc định 3). Đặt 1 để tắt việc subagent sinh subagent con |
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY | Số tool chỉ-đọc và subagent tối đa chạy song song (mặc định 10) |
CLAUDE_CODE_MAX_TURNS | Giới hạn số lượt agentic khi không có giới hạn tường minh nào được truyền. Tương đương flag --max-turns (flag ưu tiên hơn nếu cả hai được đặt) |
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION | Giới hạn tổng số lệnh gọi WebSearch một phiên có thể thực hiện (mặc định 200) |
CLAUDE_CODE_MCP_ALLOWLIST_ENV | Đặt 1 để spawn stdio MCP server chỉ với environment baseline an toàn cộng env cấu hình của server, thay vì kế thừa toàn bộ shell environment |
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS | Thời gian (mili giây) trước khi một MCP tool call còn đang chạy chuyển thành tác vụ nền (mặc định 120000, tức 2 phút). Đặt 0 để tắt |
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT | Idle timeout (mili giây) cho MCP tool call - khi server không phản hồi/không có progress trong khoảng này, tool call bị huỷ thay vì chờ MCP_TOOL_TIMEOUT. Mặc định 300000 (network server) / 1800000 (stdio server) |
CLAUDE_CODE_NATIVE_CURSOR | Đặt 1 để hiện con trỏ gốc của terminal tại vị trí nhập thay vì khối vẽ riêng |
CLAUDE_CODE_NEW_INIT | Đặt 1 để /init chạy luồng thiết lập tương tác (hỏi file nào cần sinh) thay vì tự sinh CLAUDE.md không hỏi |
CLAUDE_CODE_NO_FLICKER | Đặt 1 để bật fullscreen rendering (bản preview thử nghiệm, giảm flicker, giữ bộ nhớ ổn định ở hội thoại dài). Tương đương setting tui; cũng đổi bằng /tui fullscreen |
CLAUDE_CODE_OAUTH_REFRESH_TOKEN | OAuth refresh token xác thực Claude.ai. Khi đặt, claude auth login đổi token này trực tiếp thay vì mở trình duyệt. Cần kèm CLAUDE_CODE_OAUTH_SCOPES |
CLAUDE_CODE_OAUTH_SCOPES | Danh sách OAuth scope (cách nhau bằng dấu cách) mà refresh token được cấp, bắt buộc khi đặt CLAUDE_CODE_OAUTH_REFRESH_TOKEN |
CLAUDE_CODE_OAUTH_TOKEN | OAuth access token xác thực Claude.ai - thay thế cho /login trong SDK và môi trường tự động. Ưu tiên hơn credential lưu trong keychain. Tạo bằng claude setup-token |
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE | (đã gỡ bỏ ở v2.1.160) Trước đây pin fast mode vào Opus 4.6 |
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH | Độ dài tối đa của attribute OpenTelemetry mang nội dung (response, tool content, system prompt, raw API body), tính bằng UTF-16 code unit (mặc định 61440, tức 60 KB) |
CLAUDE_CODE_OTEL_DIAG_STDERR | Đặt 1 để ghi lỗi chẩn đoán OpenTelemetry exporter ra stderr. Mặc định các lỗi này chỉ hiện khi dùng --debug |
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS | Timeout (mili giây) để flush OpenTelemetry span đang chờ (mặc định 5000) |
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS | Khoảng thời gian làm mới OpenTelemetry header động (mili giây, mặc định 1740000 tức 29 phút) |
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS | Timeout (mili giây) để OpenTelemetry exporter hoàn tất khi shutdown (mặc định 2000) |
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE | Đặt 1 để Claude Code tự chạy lệnh upgrade của package manager (Homebrew, WinGet) ở nền khi có bản mới |
CLAUDE_CODE_PERFORCE_MODE | Đặt 1 để bật bảo vệ ghi nhận biết Perforce - Edit/Write/NotebookEdit sẽ lỗi kèm gợi ý p4 edit <file> nếu file thiếu quyền ghi của owner |
CLAUDE_CODE_PLUGIN_CACHE_DIR | Ghi đè thư mục gốc chứa plugin (thực chất là thư mục cha, không phải cache). Mặc định ~/.claude/plugins |
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS | Timeout (mili giây) cho thao tác git khi cài/cập nhật plugin (mặc định 120000) |
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE | Đặt 1 để bỏ qua việc re-clone và giữ marketplace cache hiện có khi git pull lỗi - hữu ích cho môi trường offline/airgapped |
CLAUDE_CODE_PLUGIN_PREFER_HTTPS | Đặt 1 để clone GitHub owner/repo qua HTTPS thay vì SSH khi cài/cập nhật plugin |
CLAUDE_CODE_PLUGIN_SEED_DIR | Đường dẫn tới một hoặc nhiều thư mục seed plugin chỉ-đọc (phân cách bằng : trên Unix, ; trên Windows) - dùng để đóng gói sẵn plugin vào container image |
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY | Đặt 1 để Claude Code không truyền -ExecutionPolicy Bypass khi spawn PowerShell, tuân theo execution policy hiệu lực của máy |
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS | Thời gian tối đa (mili giây) mà non-interactive mode (-p) chờ subagent/workflow nền sau lượt cuối trước khi kết thúc process (mặc định 600000, tức 10 phút). Đặt 0 để chờ vô hạn |
CLAUDE_CODE_PROCESS_WRAPPER | Khởi chạy các process Claude Code sinh ra qua một launcher doanh nghiệp, cho bằng argv prefix. Đặt trong khối env của user/managed settings, không phải shell export |
CLAUDE_CODE_PROPAGATE_TRACEPARENT | Đặt 1 để lan truyền W3C trace context khi ANTHROPIC_BASE_URL trỏ tới proxy tuỳ chỉnh |
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST | Đặt bởi host platform nhúng Claude Code và tự quản lý routing provider - khi đó các biến chọn provider trong settings file bị bỏ qua |
CLAUDE_CODE_PROXY_RESOLVES_HOSTS | Đặt 1 để cho phép proxy tự phân giải DNS thay vì client |
CLAUDE_CODE_REMOTE | Tự động đặt true khi Claude Code chạy như cloud session |
CLAUDE_CODE_REMOTE_SESSION_ID | Tự động đặt trong cloud session thành ID phiên hiện tại |
CLAUDE_CODE_RESUME_INTERRUPTED_TURN | Đặt 1 để tự resume nếu phiên trước kết thúc giữa lượt. Dùng trong SDK mode. Unset biến để tắt (đặt 0 vẫn kích hoạt resume ở non-interactive mode) |
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS | Tuổi tối đa (mili giây) của message cuối cùng để phiên kết thúc giữa lượt tự resume. Unset hoặc 0 nghĩa là không giới hạn |
CLAUDE_CODE_RESUME_PROMPT | Ghi đè message tiếp tục khi resume phiên kết thúc giữa lượt. Mặc định Continue from where you left off. |
CLAUDE_CODE_RETRY_WATCHDOG | Đặt 1 cho phiên không có người theo dõi (eval harness, CI, remote worker) - retry lỗi 429/529 vô hạn thay vì dừng sau CLAUDE_CODE_MAX_RETRIES lần |
CLAUDE_CODE_SAFE_MODE | Đặt 1 để khởi động ở safe mode: CLAUDE.md, skill, plugin, hook, MCP server, custom command/agent, output style, workflow, theme/keybinding tuỳ chỉnh, status line, LSP server, auto-memory đều không nạp - dùng để gỡ lỗi cấu hình hỏng |
CLAUDE_CODE_SCRIPT_CAPS | JSON object giới hạn số lần một script cụ thể được gọi trong phiên khi CLAUDE_CODE_SUBPROCESS_ENV_SCRUB được đặt. Ví dụ {"deploy.sh": 2} |
CLAUDE_CODE_SCROLL_SPEED | Đặt hệ số nhân tốc độ cuộn chuột trong fullscreen rendering. Nhận giá trị dương tới 20, kể cả giá trị thập phân dưới 1 |
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS | Ghi đè ngân sách thời gian (mili giây) cho hook SessionEnd. Mặc định 1.5 giây, tự nâng theo timeout cấu hình cao nhất, tối đa 60 giây |
CLAUDE_CODE_SESSION_ID | Tự động đặt thành session ID hiện tại trong subprocess Bash/PowerShell, hook command, stdio MCP server - dùng để liên kết script/tool ngoài với phiên đã khởi động chúng |
CLAUDE_CODE_SHELL | Đặt shell Claude Code dùng để chạy lệnh Bash tool - nhận đường dẫn tới binary bash hoặc zsh. Nếu giá trị không hợp lệ, Claude Code bỏ qua và tự động dò |
CLAUDE_CODE_SHELL_PREFIX | Prefix lệnh bọc quanh shell command Claude Code spawn (Bash tool, hook, status line, khởi động stdio MCP server) - hữu ích cho logging/audit |
CLAUDE_CODE_SIMPLE | Đặt 1 để chạy với system prompt tối giản, chỉ có Bash, đọc file, sửa file. Tương đương flag --bare |
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT | Đặt 1 để dùng system prompt ngắn hơn và mô tả tool rút gọn trên mọi model. Đặt 0/false/no/off để tắt cưỡng bức kể cả khi experiment/server bật sẵn |
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH | Bỏ qua xác thực client-side cho Claude Platform on AWS, dành cho gateway tự ký request |
CLAUDE_CODE_SKIP_AWS_CRED_CACHE | Đặt 1 để tắt cache credential AWS default chain trong process - resolve chain lại ở mỗi request |
CLAUDE_CODE_SKIP_BEDROCK_AUTH | Bỏ qua xác thực AWS cho Amazon Bedrock (ví dụ khi dùng LLM gateway) |
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS | Đặt 1 để coi kiểm tra khả dụng fast mode lỗi mạng là “khả dụng” - dùng cho mạng chặn request trực tiếp tới api.anthropic.com |
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK | Đặt 1 để bỏ qua kiểm tra khả dụng fast mode phía client, dành cho proxy chặn request kiểm tra thay vì từ chối |
CLAUDE_CODE_SKIP_FOUNDRY_AUTH | Bỏ qua xác thực Azure cho Microsoft Foundry, dành cho proxy/gateway tự chèn header Authorization |
CLAUDE_CODE_SKIP_MANTLE_AUTH | Bỏ qua xác thực AWS cho Amazon Bedrock Mantle |
CLAUDE_CODE_SKIP_PROMPT_HISTORY | Đặt 1 để không ghi prompt history và session transcript ra đĩa. Phiên bật biến này không xuất hiện trong --resume/--continue/lịch sử phím Up |
CLAUDE_CODE_SKIP_VERTEX_AUTH | Bỏ qua xác thực Google cho Google Cloud’s Agent Platform |
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP | Số lần liên tiếp tối đa hook Stop/SubagentStop được phép chặn kết thúc lượt trước khi Claude Code cưỡng bức kết thúc (mặc định 8). Đặt 0 để tắt giới hạn |
CLAUDE_CODE_SUBAGENT_MODEL | Model Claude Code dùng cho mọi subagent, agent team, và agent trong workflow. Ưu tiên hơn tham số model và frontmatter model của subagent |
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB | Đặt 1 để loại bỏ credential Anthropic/cloud provider khỏi environment của subprocess (Bash, hook, MCP stdio) - giảm rủi ro exfiltrate secret qua prompt injection |
CLAUDE_CODE_SYNC_PLUGIN_INSTALL | Đặt 1 ở non-interactive mode để chờ cài plugin xong trước query đầu tiên |
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS | Timeout (mili giây) cho việc cài plugin đồng bộ. Không có mặc định - nếu không đặt biến này, việc cài sẽ chờ tới khi xong |
CLAUDE_CODE_SYNC_SKILLS | Đặt 1 để tải skill claude.ai đã bật của bạn vào ~/.claude/skills/ trước query đầu tiên và đồng bộ lại mỗi 10 phút. Chỉ áp dụng non-interactive mode (-p) |
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS | Timeout (mili giây) cho lần đồng bộ skill giữa phiên khi CLAUDE_CODE_SYNC_SKILLS được đặt (mặc định 30000) |
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS | Timeout (mili giây) mà query đầu tiên chờ lần đồng bộ skill ban đầu (mặc định 5000) |
CLAUDE_CODE_SYNTAX_HIGHLIGHT | Đặt false để tắt syntax highlighting trong output diff. Dùng setting syntaxHighlightingDisabled để tắt cả trong code block/preview file |
CLAUDE_CODE_TASK_LIST_ID | Chia sẻ task list giữa các phiên - đặt cùng ID ở nhiều instance Claude Code để phối hợp trên một task list chung |
CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS | Ghi đè thời gian (mili giây) một phiên non-interactive chờ agent team teardown xong khi thoát. Nhận 1000-60000, mặc định 10000 |
CLAUDE_CODE_TMPDIR | Ghi đè thư mục temp nội bộ. Claude Code thêm /claude-{uid}/ (Unix) hoặc /claude/ (Windows) vào sau đường dẫn này |
CLAUDE_CODE_TMUX_TRUECOLOR | Đặt bất kỳ giá trị không rỗng nào để cho phép truecolor 24-bit trong tmux. Đặt 0/false vẫn cho phép - unset để khôi phục giới hạn 256 màu |
CLAUDE_CODE_USE_ANTHROPIC_AWS | Dùng Claude Platform on AWS |
CLAUDE_CODE_USE_BEDROCK | Dùng Amazon Bedrock |
CLAUDE_CODE_USE_FOUNDRY | Dùng Microsoft Foundry |
CLAUDE_CODE_USE_MANTLE | Dùng Mantle endpoint của Amazon Bedrock |
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH | Đặt 1 để tìm custom command/subagent/output style bằng Node.js file API thay vì ripgrep - dùng khi ripgrep bundled không khả dụng |
CLAUDE_CODE_USE_POWERSHELL_TOOL | Kiểm soát tool PowerShell. Trên Windows không có Git Bash: tự bật, đặt 0 để tắt. Trên Windows có Git Bash: rollout dần, đặt 1/0 để opt-in/out. Trên Linux/macOS/WSL: đặt 1 để bật (cần pwsh trong PATH) |
CLAUDE_CODE_USE_VERTEX | Dùng Google Cloud’s Agent Platform |
CLAUDE_CONFIG_DIR | Ghi đè thư mục cấu hình (mặc định ~/.claude). Toàn bộ settings, session history, plugin lưu dưới đường dẫn này (credential trên macOS nằm trong Keychain hệ thống). Hữu ích để chạy nhiều tài khoản song song |
CLAUDE_DISABLE_ADOPT | Đặt 1 để dừng công việc nền dở dang thay vì chuyển giao khi bạn background một phiên bằng ← hoặc /background |
CLAUDE_EFFORT | Tự động đặt trong subprocess Bash tool/hook thành effort level hiện tại của lượt: low, medium, high, xhigh, max |
CLAUDE_ENABLE_BYTE_WATCHDOG | Đặt 1 để cưỡng bức bật byte-level streaming idle watchdog, 0 để tắt. Mặc định bật cho kết nối Anthropic API trực tiếp và Claude Platform on AWS |
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK | Đặt 1 để bật byte-level watchdog cho response vnd.amazon.eventstream của Amazon Bedrock. Mặc định tắt |
CLAUDE_ENABLE_STREAM_WATCHDOG | Đặt 0 để cưỡng bức tắt event-level streaming idle watchdog, 1 để bật. Mặc định bật cho mọi provider (từ v2.1.196) |
CLAUDE_ENV_FILE | Đường dẫn shell script mà Claude Code chạy trước mỗi lệnh Bash trong cùng shell process, để export trong file đó khả dụng cho lệnh sau - dùng giữ virtualenv/conda activation |
CLAUDE_PID | Claude Code đặt thành PID của chính nó trong subprocess nó spawn (Bash, PowerShell, hook) |
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX | Prefix cho tên phiên Remote Control tự sinh khi không có tên tường minh. Mặc định là hostname máy bạn |
CLAUDE_STREAM_IDLE_TIMEOUT_MS | Timeout (mili giây) trước khi streaming idle watchdog đóng kết nối bị treo. Khi đặt tường minh, tối thiểu 300000 (5 phút) - giá trị thấp hơn bị kẹp lên |
DEBUG | Đặt 1 để bật debug mode, tương đương --debug. Log ghi vào ~/.claude/debug/<session-id>.txt hoặc đường dẫn từ CLAUDE_CODE_DEBUG_LOGS_DIR. Chỉ 1, true, yes, on mới bật |
DISABLE_AUTOUPDATER | Đặt 1 để tắt tự động cập nhật nền. claude update thủ công vẫn hoạt động. Dùng DISABLE_UPDATES để chặn cả hai |
DISABLE_AUTO_COMPACT | Đặt 1 để tắt auto-compaction khi gần chạm giới hạn context. Lệnh /compact thủ công vẫn dùng được. Ghi đè setting autoCompactEnabled |
DISABLE_COMPACT | Đặt 1 để tắt hoàn toàn compaction: cả tự động lẫn lệnh /compact thủ công |
DISABLE_COST_WARNINGS | Đặt 1 để tắt cảnh báo chi phí |
DISABLE_DOCTOR_COMMAND | Đặt 1 để ẩn skill /doctor (và alias /checkup). Không ảnh hưởng lệnh terminal claude doctor |
DISABLE_ERROR_REPORTING | Đặt bất kỳ giá trị không rỗng nào để tắt error reporting. Đặt 0/false vẫn tắt - unset để bật lại |
DISABLE_EXTRA_USAGE_COMMAND | Đặt 1 để ẩn lệnh /usage-credits (mua thêm usage vượt rate limit) |
DISABLE_FEEDBACK_COMMAND | Đặt 1 để tắt lệnh /feedback (và /bug, /share vì cùng đường báo cáo). Tên cũ DISABLE_BUG_COMMAND cũng được chấp nhận |
DISABLE_GROWTHBOOK | Đặt 1 để tắt fetch feature-flag GrowthBook, dùng mặc định code cho mọi flag - khiến Remote Control không khả dụng |
DISABLE_INSTALLATION_CHECKS | Đặt 1 để tắt cảnh báo cài đặt. Chỉ dùng khi tự quản lý vị trí cài thủ công |
DISABLE_INSTALL_GITHUB_APP_COMMAND | Đặt 1 để ẩn lệnh /install-github-app (đã tự ẩn sẵn khi dùng provider bên thứ ba) |
DISABLE_INTERLEAVED_THINKING | Đặt 1 để không gửi beta header interleaved-thinking - dùng khi gateway/provider không hỗ trợ |
DISABLE_LOGIN_COMMAND | Đặt 1 để ẩn lệnh /login - dùng khi xác thực được xử lý bên ngoài (API key, apiKeyHelper) |
DISABLE_LOGOUT_COMMAND | Đặt 1 để ẩn lệnh /logout |
DISABLE_PROMPT_CACHING | Đặt 1 để tắt prompt caching cho mọi model, ưu tiên hơn setting theo từng model |
DISABLE_PROMPT_CACHING_FABLE | Đặt 1 để tắt prompt caching cho model Fable |
DISABLE_PROMPT_CACHING_HAIKU | Đặt 1 để tắt prompt caching cho model Haiku |
DISABLE_PROMPT_CACHING_OPUS | Đặt 1 để tắt prompt caching cho model Opus |
DISABLE_PROMPT_CACHING_SONNET | Đặt 1 để tắt prompt caching cho model Sonnet |
DISABLE_TELEMETRY | Đặt bất kỳ giá trị không rỗng nào để tắt telemetry. Đặt 0/false vẫn tắt - unset để bật lại. Telemetry không gồm dữ liệu người dùng như code, đường dẫn file, lệnh bash. Cũng tắt feature-flag fetching như DISABLE_GROWTHBOOK |
DISABLE_UPDATES | Đặt 1 để chặn mọi cập nhật, kể cả claude update/claude install thủ công. Nghiêm ngặt hơn DISABLE_AUTOUPDATER |
DISABLE_UPGRADE_COMMAND | Đặt 1 để ẩn lệnh /upgrade |
DO_NOT_TRACK | Đặt 1 để tắt telemetry, cùng hiệu ứng với DISABLE_TELEMETRY. Đọc như boolean chuẩn nên 0 giữ telemetry bật - theo quy ước chung của nhiều CLI |
ENABLE_CLAUDEAI_MCP_SERVERS | Đặt false để tắt claude.ai MCP servers trong Claude Code. Mặc định bật cho user đã đăng nhập |
ENABLE_PROMPT_CACHING_1H | Đặt 1 để yêu cầu TTL cache prompt 1 giờ thay vì mặc định 5 phút. Ghi cache 1 giờ tính phí cao hơn |
ENABLE_PROMPT_CACHING_1H_BEDROCK | (deprecated) Dùng ENABLE_PROMPT_CACHING_1H thay thế |
ENABLE_TOOL_SEARCH | Kiểm soát MCP tool search. Giá trị: true (luôn hoãn tải), auto (ngưỡng: tải trước nếu tool vừa trong 10% context), auto:N (ngưỡng tuỳ chỉnh), false (tải hết trước). Bị bỏ qua khi CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS được đặt |
FALLBACK_FOR_ALL_PRIMARY_MODELS | Đặt bất kỳ giá trị không rỗng nào để mọi model ngừng retry khi lỗi overload lặp lại nếu không có fallback model cấu hình. Đặt 0/false vẫn bật - unset để khôi phục hành vi retry mặc định |
FORCE_AUTOUPDATE_PLUGINS | Đặt 1 để cưỡng bức plugin tự cập nhật kể cả khi auto-updater chính bị tắt qua DISABLE_AUTOUPDATER |
FORCE_HYPERLINK | Đặt 1 để bật hyperlink OSC 8 có thể click khi terminal hỗ trợ nhưng không auto-detect, 0 để tắt. Biến này đọc như một con số chứ không phải boolean - các cách viết chữ như false/no/off sẽ bật hyperlink chứ không tắt |
FORCE_PROMPT_CACHING_5M | Đặt 1 để cưỡng bức TTL cache 5 phút kể cả khi TTL 1 giờ đáng lẽ được áp dụng. Ghi đè ENABLE_PROMPT_CACHING_1H |
HTTP_PROXY | Chỉ định HTTP proxy server cho kết nối mạng |
HTTPS_PROXY | Chỉ định HTTPS proxy server cho kết nối mạng |
IS_DEMO | Đặt bất kỳ giá trị không rỗng nào để bật demo mode: ẩn email/tên tổ chức khỏi header và /status, bỏ qua onboarding. Đặt 0/false vẫn bật - unset để tắt |
MAX_MCP_OUTPUT_TOKENS | Số token tối đa trong response MCP tool. Claude Code cảnh báo khi vượt 10.000 token (mặc định giới hạn 25000) |
MAX_STRUCTURED_OUTPUT_RETRIES | Số lần retry khi response model không qua validate theo --json-schema ở non-interactive mode. Mặc định 5 |
MAX_THINKING_TOKENS | Ngân sách token cố định cho extended thinking. Đặt 0 để tắt thinking trên Anthropic API (trừ Fable 5, không thể tắt). Trên provider bên thứ ba, 0 bỏ tham số thinking thay vì tắt hẳn |
MCP_CLIENT_SECRET | OAuth client secret cho MCP server yêu cầu credential cấu hình sẵn - tránh prompt tương tác khi thêm server bằng --client-secret |
MCP_CONNECTION_NONBLOCKING | Kiểm soát việc khởi động có chờ MCP server kết nối trước query đầu hay không. Mặc định non-blocking từ v2.1.142; đặt 0 để quay lại chờ blocking 5 giây |
MCP_CONNECT_TIMEOUT_MS | Thời gian (mili giây) blocking MCP startup chờ trước khi chốt danh sách tool (mặc định 5000) |
MCP_OAUTH_CALLBACK_PORT | Port cố định cho OAuth redirect callback, thay thế cho --callback-port khi thêm MCP server có credential cấu hình sẵn |
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE | Số MCP server từ xa (HTTP/SSE) tối đa kết nối song song lúc khởi động (mặc định 20) |
MCP_SERVER_CONNECTION_BATCH_SIZE | Số MCP server cục bộ (stdio) tối đa kết nối song song lúc khởi động (mặc định 3) |
MCP_TIMEOUT | Timeout (mili giây) cho việc khởi động MCP server (mặc định 30000, tức 30 giây) |
MCP_TOOL_TIMEOUT | Timeout (mili giây) cho việc thực thi MCP tool (mặc định 100000000, khoảng 28 giờ). Server HTTP/SSE/connector còn có timeout riêng 60 giây mỗi request |
NO_PROXY | Danh sách domain/IP request sẽ gửi trực tiếp, bỏ qua proxy |
OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT | Giới hạn chuẩn của OpenTelemetry SDK về độ dài giá trị attribute. Claude Code lấy giá trị nhỏ hơn giữa biến này và CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH |
OTEL_LOG_ASSISTANT_RESPONSES | Đặt 1 để đưa text response của model vào event log assistant_response. Khi chưa đặt, dùng giá trị của OTEL_LOG_USER_PROMPTS |
OTEL_LOG_RAW_API_BODIES | Phát JSON request/response Messages API dưới dạng event log api_request_body/api_response_body. Đặt 1 để nhúng trực tiếp (cắt theo giới hạn nội dung), hoặc file:<dir> để ghi file không cắt |
OTEL_LOG_TOOL_CONTENT | Đặt 1 để đưa input/output content của tool vào span event OpenTelemetry. Mặc định tắt để bảo vệ dữ liệu nhạy cảm |
OTEL_LOG_TOOL_DETAILS | Đặt 1 để đưa tool input argument, tên MCP server, tên workflow, lỗi thô khi tool fail… vào trace/log OpenTelemetry. Mặc định tắt để bảo vệ PII |
OTEL_LOG_USER_PROMPTS | Đặt 1 để đưa text prompt người dùng vào trace/log OpenTelemetry. Mặc định tắt (prompt bị redact) |
OTEL_METRICS_INCLUDE_ACCOUNT_UUID | Đặt false để loại account UUID khỏi attribute metric (mặc định gồm) |
OTEL_METRICS_INCLUDE_ENTRYPOINT | Đặt true để đưa session entrypoint vào attribute metric (mặc định không gồm) |
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES | Claude Code gắn key OTEL_RESOURCE_ATTRIBUTES vào label metric datapoint từ v2.1.161. Đặt false để loại (mặc định gồm) |
OTEL_METRICS_INCLUDE_SESSION_ID | Đặt false để loại session ID khỏi attribute metric (mặc định gồm) |
OTEL_METRICS_INCLUDE_VERSION | Đặt true để đưa version Claude Code vào attribute metric (mặc định không gồm) |
SLASH_COMMAND_TOOL_CHAR_BUDGET | Ghi đè ngân sách ký tự cho metadata skill hiển thị cho Skill tool. Mặc định co giãn 1% context window, tối thiểu 8.000 ký tự |
TASK_MAX_OUTPUT_LENGTH | Số ký tự tối đa trong output subagent trước khi bị cắt (mặc định 32000, tối đa 160000). Output đầy đủ được lưu ra đĩa kèm đường dẫn |
USE_BUILTIN_RIPGREP | Đặt 0 để dùng rg cài trên hệ thống thay vì rg đi kèm Claude Code |
VERTEX_REGION_CLAUDE_3_5_HAIKU | Ghi đè region cho Claude 3.5 Haiku khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_3_5_SONNET | Ghi đè region cho Claude 3.5 Sonnet khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_3_7_SONNET | Ghi đè region cho Claude 3.7 Sonnet khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_4_0_OPUS | Ghi đè region cho Claude 4.0 Opus khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_4_0_SONNET | Ghi đè region cho Claude 4.0 Sonnet khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_4_1_OPUS | Ghi đè region cho Claude 4.1 Opus khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_4_5_OPUS | Ghi đè region cho Claude Opus 4.5 khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_4_5_SONNET | Ghi đè region cho Claude Sonnet 4.5 khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_4_6_OPUS | Ghi đè region cho Claude Opus 4.6 khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_4_6_SONNET | Ghi đè region cho Claude Sonnet 4.6 khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_4_7_OPUS | Ghi đè region cho Claude Opus 4.7 khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_4_8_OPUS | Ghi đè region cho Claude Opus 4.8 khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_5_OPUS | Ghi đè region cho Claude Opus 5 khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_5_SONNET | Ghi đè region cho Claude Sonnet 5 khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_FABLE_5 | Ghi đè region cho Claude Fable 5 khi dùng Google Cloud’s Agent Platform |
VERTEX_REGION_CLAUDE_HAIKU_4_5 | Ghi đè region cho Claude Haiku 4.5 khi dùng Google Cloud’s Agent Platform |
Ngoài bảng trên, các biến OpenTelemetry exporter chuẩn (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, và các biến theo từng loại tín hiệu) cũng được hỗ trợ. Xem Monitoring để biết chi tiết cấu hình.
Xem thêm
Phần tiêu đề “Xem thêm”- Settings - toàn bộ cấu hình
settings.json, gồm cả keyenv - CLI reference - flag lúc khởi động
- Network configuration - cấu hình proxy và TLS
lượt xem
