Cấu hình model

Các model khả dụng

Với setting model trong Claude Code, bạn có thể cấu hình:

• Một model alias
• Một tên model: full model name (Anthropic API), inference profile ARN (Amazon Bedrock), deployment name (Microsoft Foundry), hoặc version name (Google Cloud’s Agent Platform)

Ghi chú

ANTHROPIC_BASE_URL chỉ đổi nơi request được gửi đến, không đổi model nào trả lời. Để route Claude qua LLM gateway, xem tài liệu LLM gateway.

Model alias

Model alias cho cách chọn nhanh mà không cần nhớ số phiên bản chính xác:

Alias	Hành vi
default	Giá trị đặc biệt xoá mọi override và quay về model được khuyến nghị cho loại tài khoản của bạn, hoặc organization default model nếu admin đã đặt.
best	Dùng Fable 5 nếu tổ chức bạn có quyền truy cập, nếu không dùng Opus mới nhất.
fable	Dùng Claude Fable 5 cho task khó và chạy dài nhất.
sonnet	Model Sonnet mới nhất cho công việc coding hằng ngày.
opus	Model Opus mới nhất cho reasoning phức tạp.
haiku	Model Haiku nhanh, nhẹ cho task đơn giản.
sonnet[1m]	Sonnet với context window 1 triệu token cho session dài.
opus[1m]	Opus với context window 1 triệu token.
opusplan	Mode hybrid: dùng opus khi plan mode, chuyển sang sonnet khi thực thi.

Phiên bản mà opus và sonnet trỏ tới phụ thuộc provider:

Provider	opus	sonnet
Anthropic API	Opus 5	Sonnet 5
Claude Platform on AWS	Opus 5	Sonnet 4.6
Amazon Bedrock, Google Cloud’s Agent Platform	Opus 5	Sonnet 4.5
Microsoft Foundry	Opus 4.6	Sonnet 4.5

Để pin một phiên bản cụ thể, dùng full model name (ví dụ claude-opus-5) hoặc đặt biến môi trường ANTHROPIC_DEFAULT_OPUS_MODEL/ANTHROPIC_DEFAULT_SONNET_MODEL.

Chú ý

Các con số phiên bản model, giá cả, và bảng resolve alias thay đổi thường xuyên theo release Claude Code - kiểm tra tài liệu gốc để có thông tin mới nhất.

Dùng Fable 5

Claude Fable 5 là model mạnh nhất trong Claude Code, phù hợp cho task lớn hơn một buổi làm việc thông thường. Nó duy trì session tự động dài, điều tra trước khi hành động, và xác minh công việc thường xuyên hơn các model nhỏ.

Fable 5 không phải model mặc định. Chọn bằng /model fable. Request bị safety classifier gắn cờ (thường ở lĩnh vực an ninh mạng và sinh học) sẽ kích hoạt automatic model fallback.

Để tận dụng tốt nhất Fable 5:

• Mô tả kết quả, không phải các bước: đưa nó kết quả bạn muốn và để nó tự lên kế hoạch.
• Giao task mơ hồ: điều tra root-cause, debug outage, quyết định kiến trúc là nơi nó phát huy nhất.
• Bỏ qua nhắc nhở xác minh: nó tự xác minh công việc mà ít cần nhắc.
• Giao task lớn hơn: nó giữ mạch làm việc tốt trong session dài.

Chú ý

Fable 5 yêu cầu Claude Code v2.1.170 trở lên và không khả dụng dưới zero data retention.

Đặt model

Bạn có thể cấu hình model theo nhiều cách, xếp theo thứ tự ưu tiên:

1. Trong session: /model <alias|name> để chuyển ngay, hoặc /model không tham số để mở picker.
2. Lúc khởi động: claude --model <alias|name>
3. Biến môi trường: ANTHROPIC_MODEL=<alias|name>
4. Settings: đặt vĩnh viễn qua field model trong settings file

Trong picker: Enter chuyển model và lưu làm mặc định; s chuyển chỉ cho session này.

Session resume (claude --resume, --continue, /resume) giữ nguyên model đã dùng khi lưu transcript, bất kể setting model hiện tại.

Ví dụ khởi động session trên Opus:

claude --model opus

Rồi chuyển model trong session:

/model sonnet

Ví dụ settings file:

{
    "permissions": {
        "allow": ["Bash(npm run lint)"]
    },
    "model": "opus"
}

Giới hạn lựa chọn model

Admin doanh nghiệp có thể dùng availableModels trong managed/policy settings để giới hạn model user chọn được. Entry có thể khớp một family (sonnet), một prefix phiên bản (claude-sonnet-4-5), hoặc full model ID.

{
  "availableModels": ["sonnet", "haiku"]
}

Allowlist này áp dụng ở mọi nơi user chỉ định model: main session model, alias resolution, fast mode, subagent model, skill/command model, advisor model, và background agent model.

Enforce allowlist cho Default model

Đặt enforceAvailableModels: true cùng availableModels không rỗng trong managed settings để mở rộng allowlist tới option Default:

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

Organization default model

Admin doanh nghiệp có thể đặt model mặc định cho thành viên Claude Code từ admin console, cho cả tổ chức hoặc theo role. Khi đã đặt, option Default resolve về model đó thay vì account-type default.

Hành vi model đặc biệt

Setting default

Hành vi của default phụ thuộc loại tài khoản:

• Max, Team Premium, Enterprise pay-as-you-go, Anthropic API: mặc định Opus 5
• Claude Platform on AWS, Amazon Bedrock, Google Cloud’s Agent Platform: mặc định Opus 5
• Pro, Team Standard, Enterprise subscription seat: mặc định Sonnet 5
• Microsoft Foundry: mặc định Sonnet 4.5

Fable 5 không phải model mặc định trên bất kỳ loại tài khoản nào - session chỉ dùng Fable 5 sau khi bạn chọn nó.

Setting opusplan

Alias opusplan cung cấp cách hybrid tự động:

• Trong plan mode: dùng opus cho reasoning phức tạp và quyết định kiến trúc
• Khi thực thi: tự động chuyển sang sonnet cho việc sinh code và triển khai

Cho một hướng hybrid khác, nơi Claude tự quyết khi nào cần tham vấn model thứ hai giữa task thay vì chuyển ở ranh giới plan, xem advisor tool.

Fallback model chains

Khi model chính bị quá tải, không khả dụng, hoặc trả lỗi server không thể retry khác, Claude Code có thể chuyển sang fallback model thay vì fail request. Lỗi auth, billing, rate-limit, request-size, và transport không bao giờ kích hoạt chuyển đổi.

claude --fallback-model sonnet,haiku

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

Chain giới hạn tối đa 3 model sau khi loại trùng.

Automatic model fallback

Fable 5 và Opus 5 chạy với safety classifier cho nội dung an ninh mạng và sinh học. Khi classifier gắn cờ một request và category bị gắn cờ có fallback model, Claude Code chạy lại request trên model đó và hiện thông báo trong transcript.

Để quyết định thủ công mỗi lần thay vì tự động chuyển, tắt Switch models when a message is flagged trong /config, hoặc đặt switchModelsOnFlag thành false.

Điều chỉnh effort level

Effort level kiểm soát adaptive reasoning - model tự quyết định có nên “nghĩ” và nghĩ bao nhiêu ở mỗi bước dựa trên độ phức tạp task. Effort thấp nhanh và rẻ hơn cho task đơn giản; effort cao cho reasoning sâu hơn với task phức tạp.

Model	Level khả dụng
Fable 5	low, medium, high, xhigh, max
Opus 5, Sonnet 5, Opus 4.8, Opus 4.7	low, medium, high, xhigh, max
Opus 4.6, Sonnet 4.6	low, medium, high, max

Effort mặc định là high trên mọi model hỗ trợ effort, trừ Opus 4.7 mặc định xhigh.

Menu /effort còn có ultracode - đây là setting của Claude Code chứ không phải effort level của model: nó gửi xhigh đến model và thêm việc Claude tự điều phối dynamic workflow cho các task đáng kể. Chỉ áp dụng cho session hiện tại.

Chọn effort level

Level	Khi nào dùng
low	Dành cho task ngắn, phạm vi rõ, nhạy cảm về độ trễ, không nhạy cảm về trí tuệ
medium	Giảm token usage cho công việc nhạy cảm về chi phí, chấp nhận đánh đổi ít trí tuệ hơn
high	Cân bằng token usage và trí tuệ. Mặc định trên mọi model trừ Opus 4.7
xhigh	Reasoning sâu hơn, tốn token hơn. Mặc định trên Opus 4.7
max	Có thể cải thiện hiệu năng với task khó nhưng dễ lợi ích giảm dần và “overthinking”
ultracode	Setting của Claude Code, lên kế hoạch dynamic workflow cho mỗi task đáng kể, xhigh reasoning mỗi tin nhắn. Chỉ session hiện tại

Dùng ultrathink cho reasoning sâu một lần

Thêm ultrathink ở bất kỳ đâu trong prompt để yêu cầu reasoning sâu hơn cho lượt đó mà không đổi effort setting của session. Các cụm khác như “think”, “think hard” chỉ được coi là prompt text thông thường, không phải keyword được nhận diện.

Đặt effort level

• /effort: chạy không tham số để mở slider, hoặc theo sau tên level, hoặc /effort auto để reset về mặc định model
• Trong /model: dùng phím mũi tên trái/phải để chỉnh slider effort
• Cờ --effort: đặt cho một session khi khởi động
• Biến môi trường: CLAUDE_CODE_EFFORT_LEVEL
• Settings: effortLevel trong settings file (không nhận max/ultracode)
• Frontmatter skill/subagent: effort trong file markdown skill/subagent

Extended thinking

Extended thinking là phần reasoning Claude phát ra trước khi trả lời. Trên model hỗ trợ adaptive reasoning, effort level là điều khiển chính cho lượng suy nghĩ; các setting dưới đây chỉ bật/tắt và điều khiển cách hiển thị.

Điều khiển	Cách đặt
Bật/tắt cho session hiện tại	Option+T (macOS) hoặc Alt+T (Windows/Linux)
Đặt mặc định toàn cục	/config, lưu vào alwaysThinkingEnabled trong ~/.claude/settings.json
Tắt hẳn bất kể effort	MAX_THINKING_TOKENS=0

Thinking không tắt được trên Fable 5.

Extended context

Fable 5, Sonnet 5, Opus 4.6+, và Sonnet 4.6 hỗ trợ context window 1 triệu token cho session dài với codebase lớn.

Trên Max, Team, và Enterprise, Opus tự động nâng cấp lên 1M context không cần cấu hình thêm. Sonnet 4.6 với 1M context không nằm trong nâng cấp tự động và cần usage credits.

Để tắt hẳn 1M context, đặt CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

Biến môi trường

Biến	Mô tả
ANTHROPIC_DEFAULT_FABLE_MODEL	Model dùng cho fable, và ID model Claude Code nhận diện là Fable 5 cho automatic fallback trên provider bên thứ ba
ANTHROPIC_DEFAULT_OPUS_MODEL	Model dùng cho opus, hoặc opusplan khi Plan Mode đang bật
ANTHROPIC_DEFAULT_SONNET_MODEL	Model dùng cho sonnet, hoặc opusplan khi Plan Mode không bật
ANTHROPIC_DEFAULT_HAIKU_MODEL	Model dùng cho haiku, hoặc chức năng nền
CLAUDE_CODE_SUBAGENT_MODEL	Model Claude Code dùng cho mọi subagent, agent team, và agent trong workflow

Ghi chú

ANTHROPIC_SMALL_FAST_MODEL đã deprecated, dùng ANTHROPIC_DEFAULT_HAIKU_MODEL thay thế.

Pin model cho triển khai bên thứ ba

Khi triển khai Claude Code qua Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry, hoặc Claude Platform on AWS, hãy pin phiên bản model trước khi rollout cho user, vì alias mặc định có thể lag sau release mới nhất của Anthropic.

# Amazon Bedrock
export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'
# Google Cloud's Agent Platform / Microsoft Foundry
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'

modelOverrides - map từng phiên bản

Nếu bạn cần map nhiều phiên bản trong cùng family tới các provider ID khác nhau, dùng setting modelOverrides:

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod"
  }
}

Cấu hình prompt caching

Claude Code tự dùng prompt caching để tối ưu hiệu năng và giảm chi phí. Bạn có thể tắt toàn cục hoặc theo từng tier model bằng DISABLE_PROMPT_CACHING, DISABLE_PROMPT_CACHING_HAIKU, DISABLE_PROMPT_CACHING_SONNET, DISABLE_PROMPT_CACHING_OPUS, DISABLE_PROMPT_CACHING_FABLE.

Kiểm tra model hiện tại

Xem model đang dùng ở hai nơi: status line nếu bạn cấu hình, hoặc /status.

Nguồn

Dịch và biên soạn từ Model configuration.