การกำหนดค่า Model

เรียนรู้เกี่ยวกับการกำหนดค่า model ของ Claude Code รวมถึง model aliases เช่น opusplan

Models ที่ใช้ได้

สำหรับการตั้งค่า model ใน Claude Code คุณสามารถกำหนดค่า:

• Model alias
• Model name
  • Anthropic API: model name เต็ม
  • Bedrock: inference profile ARN
  • Foundry: deployment name
  • Vertex: version name

Model Aliases

Model alias	พฤติกรรม
default	ล้าง model override และกลับสู่ model ที่แนะนำสำหรับประเภทบัญชีของคุณ
best	ใช้ Fable 5 ที่องค์กรของคุณเข้าถึงได้ หรือ Opus model ล่าสุด
fable	ใช้ Claude Fable 5 สำหรับงานที่ยากที่สุดและยาวนานที่สุด
sonnet	ใช้ Sonnet model ล่าสุดสำหรับงานโค้ดประจำวัน
opus	ใช้ Opus model ล่าสุดสำหรับงานที่ต้องการการคิดซับซ้อน
haiku	ใช้ Haiku model ที่รวดเร็วและมีประสิทธิภาพสำหรับงานง่าย
sonnet[1m]	ใช้ Sonnet พร้อม context window 1 ล้าน token
opus[1m]	ใช้ Opus พร้อม context window 1 ล้าน token
opusplan	โหมดพิเศษที่ใช้ opus ในระหว่าง plan mode แล้วสลับเป็น sonnet สำหรับการ execute

การตั้งค่า Model ของคุณ

คุณสามารถกำหนดค่า model ได้หลายวิธี:

1. ระหว่าง session - ใช้ /model <alias|name>
2. เมื่อเริ่มต้น - เปิดด้วย claude --model <alias|name>
3. Environment variable - ตั้งค่า ANTHROPIC_MODEL=<alias|name>
4. Settings - กำหนดค่าถาวรใน settings file

# เริ่มต้นด้วย Opus
claude --model opus

# สลับเป็น Sonnet ระหว่าง session
/model sonnet

ตัวอย่างไฟล์ settings:

{
    "model": "opus"
}

จำกัดการเลือก Model

ผู้ดูแลระบบองค์กรสามารถใช้ availableModels ใน managed หรือ policy settings เพื่อจำกัด models ที่ผู้ใช้เลือกได้:

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

พฤติกรรม Model พิเศษ

opusplan Model Setting

Alias opusplan ให้แนวทาง hybrid อัตโนมัติ:

• ในโหมด plan - ใช้ opus สำหรับการคิดซับซ้อนและการตัดสินใจสถาปัตยกรรม
• ในโหมด execution - สลับเป็น sonnet สำหรับการสร้างโค้ดและการ implement

Fallback Model Chains

เมื่อ primary model โอเวอร์โหลด, ไม่พร้อมใช้งาน หรือส่งคืน error ที่ไม่ retry ได้ Claude Code สามารถสลับไป fallback model:

claude --fallback-model sonnet,haiku

หรือใน settings:

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

ปรับ Effort Level

Effort levels ควบคุม adaptive reasoning:

Level	เมื่อใช้
low	สำหรับงานสั้น, กำหนดขอบเขต, sensitive ต่อ latency
medium	ลด token usage สำหรับงานที่ sensitive ต่อต้นทุน
high	สมดุลระหว่าง token usage และ intelligence (ค่าเริ่มต้น)
xhigh	การคิดที่ลึกขึ้นด้วย token ที่สูงขึ้น
max	สามารถปรับปรุงประสิทธิภาพสำหรับงานที่ต้องการ

/effort high
claude --effort medium

Environment Variables

Environment variable	คำอธิบาย
ANTHROPIC_DEFAULT_FABLE_MODEL	Model ที่ใช้สำหรับ fable
ANTHROPIC_DEFAULT_OPUS_MODEL	Model ที่ใช้สำหรับ opus หรือ opusplan ในโหมด plan
ANTHROPIC_DEFAULT_SONNET_MODEL	Model ที่ใช้สำหรับ sonnet หรือ opusplan ในโหมดอื่น
ANTHROPIC_DEFAULT_HAIKU_MODEL	Model ที่ใช้สำหรับ haiku หรือ background functionality
CLAUDE_CODE_SUBAGENT_MODEL	Model ที่ใช้สำหรับ subagents และ agent teams ทั้งหมด

Pin Models สำหรับ Third-party Deployments

เมื่อ deploy Claude Code ผ่าน Bedrock, Vertex AI, Foundry หรือ Claude Platform on AWS ให้ pin model versions ก่อน rollout:

Provider	ตัวอย่าง
Bedrock	export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'
Vertex AI	export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
Foundry	export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'