ใช้ Claude Code กับโมเดลอื่น: ตั้งค่า ANTHROPIC_BASE_URL

Claude Code ไม่ได้ผูกกับเซิร์ฟเวอร์ของ Anthropic ตายตัว มันมีตัวแปรให้ชี้ไปที่ API อื่นได้ องค์กรใช้วิธีนี้ต่อกับ gateway ของตัวเอง ส่วนนักพัฒนาใช้ลองโมเดลอื่น หรือแยกงานบางส่วนออกจากโควตาแพ็ก บทความนี้ไล่ตั้งค่าทีละขั้น พร้อมวิธีเช็กว่าใช้ได้จริงและวิธีสลับกลับ

ใช้ Claude Code กับโมเดลอื่นได้ไหม ต้องตั้งค่าอะไรบ้าง

ได้ในทางเทคนิค ถ้าปลายทางรับคำขอรูปแบบ Anthropic Messages ที่ Claude Code ใช้ คุณแค่ตั้ง ANTHROPIC_BASE_URL กับ credential และชื่อโมเดล แต่ Anthropic ระบุไว้ชัดว่าไม่ซัพพอร์ตการส่ง Claude Code ไปใช้โมเดลที่ไม่ใช่ Claude ถ้าเจอปัญหาต้องคุยกับผู้ให้บริการ API นั้นเป็นหลัก

ก่อนเริ่ม ขอข้อมูล 4 อย่างจากผู้ให้บริการ API ที่จะใช้

1. base URL ที่อยู่ของ API ส่วนใหญ่ไม่ต้องมี /v1 ต่อท้าย เพราะ Claude Code จะต่อ /v1/messages ให้เอง
2. API key หรือ token
3. วิธีส่ง key ว่าเป็น Bearer token หรือ x-api-key
4. ชื่อโมเดล ที่ต้องใส่ในคำขอ

จากนั้นคือตัวแปรเหล่านี้

ANTHROPIC_DEFAULT_HAIKU_MODEL มักถูกลืม Claude Code ใช้โมเดลรุ่นเล็กทำงานเบื้องหลังบางอย่าง ถ้าปลายทางไม่มีโมเดลชื่อนั้น งานเบื้องหลังอาจ error ได้ ตั้งให้ชี้ไปที่โมเดลของปลายทางไว้ด้วยจะปลอดภัยกว่า

ส่วน CLAUDE_CODE_MAX_CONTEXT_TOKENS ใช้เมื่อชื่อโมเดลปลายทางเป็นชื่อที่ Claude Code ไม่รู้จัก เพราะมันจะเดาขนาด context เอง ถ้าเดาไม่ตรง จะย่อบทสนทนาเร็วหรือช้าเกินไป ตั้งค่านี้ให้ตรงกับที่ปลายทางรับได้ เช่น 131072 สำหรับ 128K

ถ้าสงสัยว่า API ที่บอกว่า OpenAI-compatible ใช้กับ Claude Code ได้เลยไหม คำตอบคือต้องเช็กก่อน เพราะ Claude Code พูดรูปแบบ Anthropic Messages ไม่ใช่ Chat Completions ผู้ให้บริการหลายรายมีให้ทั้งสองแบบ อ่านความต่างได้ใน OpenAI-compatible API คืออะไร

ตั้งค่า ANTHROPIC_BASE_URL บน macOS, Linux และ Windows

เริ่มจาก export ใน terminal ก่อน ซึ่งมีผลแค่ใน terminal นั้น พอทดสอบผ่านแล้วค่อยย้ายไปไว้ใน env block ของ ~/.claude/settings.json เพื่อให้มีผลทุกครั้งที่เปิด Claude Code

macOS และ Linux (bash, zsh)

export ANTHROPIC_BASE_URL="https://api.example.com"
export ANTHROPIC_AUTH_TOKEN="sk-..."
export ANTHROPIC_MODEL="your-model"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="your-model"

claude

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL = "https://api.example.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-..."
$env:ANTHROPIC_MODEL = "your-model"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "your-model"

claude

ค่าที่ export ไว้หายไปเมื่อปิด terminal และโปรแกรมที่เปิดจาก Dock หรือ Start menu จะไม่เห็นค่าเหล่านี้

ตั้งให้มีผลถาวรด้วย settings.json

ใส่ไว้ใน env block ของ ~/.claude/settings.json (บน Windows คือ %USERPROFILE%\.claude\settings.json) เพื่อให้ทุกโปรเจกต์ใช้ หรือใน .claude/settings.local.json ถ้าอยากให้มีผลแค่โปรเจกต์เดียว

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "your-model",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "your-model"
  }
}

ถ้าตั้งค่าเดียวกันไว้ทั้งใน shell และใน settings file ค่าใน settings file จะชนะ

เก็บ API key ให้ปลอดภัย

• อย่าใส่ key ใน .claude/settings.json ของโปรเจกต์ เพราะไฟล์นี้ถูก commit และแชร์ให้ทุกคนที่ clone repo
• ถ้าใช้ .claude/settings.local.json ให้เพิ่มลงใน .gitignore ก่อนเสมอ ถ้าสร้างไฟล์เองหรือให้ agent เขียนให้ มันจะยังไม่ถูกกันไว้
• ถ้าเผลอ commit key ไปแล้ว ให้ขอ key ใหม่จากผู้ให้บริการทันที การลบออกจากไฟล์อย่างเดียวไม่พอ เพราะ key ยังอยู่ในประวัติ git

ใช้ใน VS Code

ส่วนขยาย Claude Code ใน VS Code อ่านค่าจาก claudeCode.environmentVariables ใน user settings ของ VS Code (เปิดด้วยคำสั่ง Preferences: Open User Settings (JSON))

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.example.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-..." }
  ]
}

ส่วนแอป Claude Desktop ไม่อ่าน ANTHROPIC_BASE_URL หรือ settings.json และมีหน้าตั้งค่าของตัวเองแยกต่างหาก

เช็กยังไงว่า Claude Code ใช้ API ใหม่จริง

ยิงคำขอทดสอบด้วย curl ก่อน แล้วเปิด claude จาก terminal เดียวกัน พิมพ์ /status ถ้าเห็นบรรทัด Anthropic base URL เป็นที่อยู่ใหม่ และบรรทัด Auth token เป็นชื่อตัวแปรที่ตั้งไว้ แปลว่าใช้ได้แล้ว

คำสั่งทดสอบนี้ใช้ตัวแปรที่ export ไว้ จึงต้องรันใน terminal ที่ตั้งค่าแล้ว

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "{\"model\": \"$ANTHROPIC_MODEL\", \"max_tokens\": 1, \"messages\": [{\"role\": \"user\", \"content\": \".\"}]}"

อ่านผลแบบนี้

• ได้ JSON ที่ขึ้นต้นด้วย {"id":"msg_ แปลว่าใช้ได้
• ได้ error ว่าไม่รู้จักชื่อโมเดล แปลว่า URL กับ key ถูกแล้ว เหลือแค่แก้ชื่อโมเดล
• ได้ 401 แปลว่า key ไม่ผ่าน หรืออยู่ผิด header ลองสลับไปใช้ ANTHROPIC_API_KEY

จากนั้นเปิด claude ส่งข้อความสักข้อความ แล้วพิมพ์ /status ดูสองบรรทัด

• Anthropic base URL ต้องเป็นที่อยู่ใหม่ ถ้าไม่มีบรรทัดนี้ แปลว่าตัวแปรไม่ถึง session
• Auth token หรือ API key ต้องเป็นชื่อตัวแปรที่ตั้งไว้ ถ้าเห็นบรรทัด Login method เป็นบัญชี claude.ai แทน แปลว่ายังใช้ล็อกอินเดิมอยู่

Error ที่เจอบ่อยตอนใช้ Claude Code กับ API อื่น

ส่วนใหญ่มาจาก key อยู่ผิดตัวแปร (401) หรือปลายทางไม่รู้จักฟิลด์ใหม่ๆ ที่ Claude Code ส่งไป (400) เกือบทั้งหมดแก้ได้ด้วยการเปลี่ยนหรือเพิ่มตัวแปรตัวเดียว

สำหรับขนาด context ถ้ายังไม่แน่ใจว่าตัวเลข 128K หรือ 256K หมายถึงอะไรในการใช้งานจริง อ่าน context window คืออะไร ประกอบได้

จะสลับกลับไปใช้บัญชี Claude เดิมทำอย่างไร

ลบตัวแปร credential กับ ANTHROPIC_BASE_URL ออก แล้วเปิด Claude Code ใหม่ ล็อกอิน claude.ai ที่บันทึกไว้จะกลับมาทำงานเอง เพราะระหว่างที่ตั้งตัวแปรไว้ ล็อกอินเดิมแค่ถูกพักไว้ ไม่ได้หายไป

unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL CLAUDE_CODE_MAX_CONTEXT_TOKENS

Remove-Item Env:ANTHROPIC_BASE_URL, Env:ANTHROPIC_AUTH_TOKEN, Env:ANTHROPIC_MODEL, Env:ANTHROPIC_DEFAULT_HAIKU_MODEL, Env:CLAUDE_CODE_MAX_CONTEXT_TOKENS

ถ้าตั้งไว้ใน settings.json ให้ลบออกจาก env block ด้วย แล้วเช็ก /status อีกครั้งว่ากลับมาเป็น Login method ของบัญชีคุณ ใช้ /logout เฉพาะตอนที่อยากล้างล็อกอินที่บันทึกไว้จริงๆ

ระหว่างที่ใช้ credential ของปลายทาง Remote Control และ voice dictation จะใช้ไม่ได้ ถ้าต้องใช้ Remote Control ต้องลบทั้ง credential และ ANTHROPIC_BASE_URL

วิธีที่สะดวกกว่าการตั้งแล้วลบไปมา คือทำคำสั่งแยกไว้ใน ~/.zshrc หรือ ~/.bashrc ค่าจะมีผลเฉพาะ Claude Code ที่เปิดด้วยคำสั่งนี้ ส่วนคำสั่ง claude ปกติยังใช้บัญชีเดิม

claude-alt() {
  ANTHROPIC_BASE_URL="https://api.example.com" \
  ANTHROPIC_AUTH_TOKEN="$ALT_API_KEY" \
  ANTHROPIC_MODEL="your-model" \
  ANTHROPIC_DEFAULT_HAIKU_MODEL="your-model" \
  claude "$@"
}

แบบนี้เปิด terminal หนึ่งใช้แพ็ก Claude อีก terminal หนึ่งใช้ API อื่นได้พร้อมกัน ซึ่งช่วยเรื่องโควตาได้มาก อ่านเรื่องโควตาต่อได้ที่ Claude Code ติด limit

ตัวอย่าง: ตั้ง Claude Code ให้ใช้ buzzAI

buzzAI เป็น API สำหรับ coding agent แบบเหมาจ่ายที่ไม่คิดค่า token รับคำขอรูปแบบ Anthropic Messages จึงใช้กับ Claude Code ได้ด้วยตัวแปรชุดเดียวกับด้านบน ชื่อโมเดลคือ Qwen3.8-27B (โมเดล open-weight) ใช้กับ Codex CLI และเครื่องมือแบบ OpenAI-compatible ได้ด้วย

# เปิด shell ใหม่ ค่าเหล่านี้ใช้แทนบัญชี Anthropic เฉพาะใน shell นี้
export ANTHROPIC_BASE_URL="https://api.heybuzzai.com"
export ANTHROPIC_AUTH_TOKEN="$BUZZAI_API_KEY"
export ANTHROPIC_MODEL="Qwen3.8-27B"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="Qwen3.8-27B"
# ขนาด context ของแพ็ก: 128K = 131072 · 256K = 262144
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=131072

# แล้วเปิดใช้งานตามปกติ
claude

# เปิด PowerShell ใหม่ ค่าเหล่านี้ใช้แทนบัญชี Anthropic เฉพาะในหน้าต่างนี้
$env:ANTHROPIC_BASE_URL = "https://api.heybuzzai.com"
$env:ANTHROPIC_AUTH_TOKEN = $env:BUZZAI_API_KEY
$env:ANTHROPIC_MODEL = "Qwen3.8-27B"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "Qwen3.8-27B"
# ขนาด context ของแพ็ก: 128K = 131072 · 256K = 262144
$env:CLAUDE_CODE_MAX_CONTEXT_TOKENS = "131072"

# แล้วเปิดใช้งานตามปกติ
claude

เราแนะนำให้ใช้คู่กับแพ็ก Claude ที่มีอยู่ เปิด terminal หนึ่งไว้คุยงานกับบัญชีเดิม แล้วให้อีก terminal หนึ่งที่ต่อกับ buzzAI ทำงานยาวหรืองานเบื้องหลัง สิ่งที่มีขอบเขตคือจำนวน agent ที่รันพร้อมกัน (แพ็ก Personal ของ buzzAI ได้ 1 agent แพ็กบริษัทได้ 1–8 ตัว) ขนาด context ตามแพ็ก (64K, 128K หรือ 256K) และคิวในช่วงที่คนใช้เยอะ

ตอนนี้ API ยังไม่เปิดใช้ทั่วไป เรากำลังเปิดรับรอบที่ 1 และจะส่ง API key ให้ทางอีเมลเมื่อมีผู้สมัครครบโควต้าที่กำหนด ดูวิธีตั้งค่าครบทุกเครื่องมือได้ที่ คู่มือ API และดูแพ็กได้ที่ หน้าราคา