API Hop

เอกสาร

เอกสาร API Hop

การเชื่อมต่อ Claude Code

ใช้เอนด์พอยต์ที่เข้ากันได้กับ Claude Messages ของ API Hop ใน Claude Code

Claude Code เรียกโมเดลผ่านโปรโตคอล Anthropic Messages ตั้ง ANTHROPIC_BASE_URL เป็น Base URL ที่เข้ากันได้กับ Anthropic ตามหน้านี้

ผู้ให้บริการต้นทางรองรับ Claude Sonnet 4.6 (claude-sonnet-4-6) แต่ปัจจุบันยังไม่เผยแพร่บน API Hop และไม่ใช่ค่าเริ่มต้นการเชื่อมต่อที่ใช้งาน ก่อนเรียกโมเดลใด ให้ยืนยันสิทธิ์ด้วยการตอบกลับ GET https://api.apihop.ai/v1/models ของคุณเอง

text
ANTHROPIC_BASE_URL=https://api.apihop.ai/anthropic

สิ่งที่ต้องเตรียม

เตรียมคีย์ API ของ API Hop ที่ถูกต้องก่อน คีย์จะถูกเขียนในสภาพแวดล้อมเชลล์ในเครื่อง อย่านำคีย์เข้ารีโพซิทอรี บันทึก หรือภาพหน้าจอ

ติดตั้ง Claude Code

บน macOS / Linux ใช้ตัวติดตั้งดั้งเดิมของ Claude Code:

bash
curl -fsSL https://claude.ai/install.sh | bash

หากตัวติดตั้งรายงาน ~/.local/bin/claude แต่ไม่พบ claude ให้เปิดเทอร์มินัลใหม่หรือเพิ่ม ~/.local/bin ใน PATH

สำหรับขั้นตอนทำงานเก่า ยังใช้แพ็กเกจ npm ได้:

bash
npm install -g @anthropic-ai/claude-code

อย่าใช้ sudo npm install -g @anthropic-ai/claude-code เพราะอาจสร้างปัญหาสิทธิ์ในการอัปเกรดภายหลัง

ตรวจ CLI หลังติดตั้ง:

bash
claude --version
claude doctor

บน Windows แนะนำ Git Bash หรือ WSL สำหรับ Claude Code โดย PowerShell ตั้งตัวแปรสภาพแวดล้อมได้ด้วย แต่การคงค่าต่างตามเทอร์มินัล

ตั้งตัวแปรสภาพแวดล้อม

การตั้งค่าชั่วคราวมีผลเฉพาะเซสชันเทอร์มินัลปัจจุบัน:

bash
export ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"
export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
export ANTHROPIC_MODEL="claude-sonnet-5-5"

macOS ใช้ zsh เป็นค่าเริ่มต้น หากต้องการคงค่า เขียนตัวแปรใน ~/.zshrc แล้วเรียก source ~/.zshrc เพื่อให้เทอร์มินัลปัจจุบันอ่านทันที:

bash
printf '%s\n' \
  'export ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"' \
  'export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"' \
  'export ANTHROPIC_MODEL="claude-sonnet-5-5"' \
  >> ~/.zshrc

source ~/.zshrc

บน Linux ที่ใช้ bash เขียนตัวแปรเดียวกันใน ~/.bashrc แล้วเรียก source ~/.bashrc

การตั้งค่าชั่วคราว Windows PowerShell:

powershell
$env:ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
$env:ANTHROPIC_MODEL="claude-sonnet-5-5"

คงค่าระดับผู้ใช้ PowerShell:

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_APIHOP_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.apihop.ai/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5-5", "User")

เปิดเซสชัน PowerShell ใหม่ก่อนเรียก claude

ไฟล์ตั้งค่า

แทนการตั้งค่าเชลล์ คุณสร้างหรือแก้ ~/.claude/settings.json ได้ หากมีไฟล์แล้ว ให้รวม env และ model ใน JSON เดิมแทนการแทนที่การตั้งค่าอื่น:

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_APIHOP_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.apihop.ai/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  },
  "model": "claude-sonnet-5-5"
}

โมเดลที่พร้อมใช้:

  • claude-fable-5
  • claude-fable-5-1
  • claude-opus-4-6
  • claude-opus-4-7
  • claude-opus-4-8
  • claude-opus-5
  • claude-opus-5-5
  • claude-sonnet-5
  • claude-sonnet-5-5

ใช้ GET https://api.apihop.ai/v1/models ดูโมเดลที่คีย์ API ของคุณใช้ได้ปัจจุบัน

เริ่มและทดสอบ

เริ่ม Claude Code ใหม่หลังตั้งตัวแปรสภาพแวดล้อม แล้วส่งพรอมต์ปกติ:

bash
claude "Reply exactly OK."

เริ่มโหมดโต้ตอบได้ด้วย:

bash
claude

เมื่อเปิดครั้งแรก Claude Code อาจถามธีม การยืนยันความปลอดภัย การตั้งค่าเทอร์มินัล หรือว่าจะเชื่อถือไดเรกทอรีปัจจุบันหรือไม่ ทำตามคำถามในเทอร์มินัล

เลือกโมเดล

ตั้งโมเดลเริ่มต้นด้วยตัวแปรสภาพแวดล้อม หรือเลือกสำหรับคำสั่งเดียวด้วย --model:

bash
claude --model claude-sonnet-5-5 "Review this PR"

พฤติกรรมเอนด์พอยต์

Claude Code ยืนยันตัวตนด้วยคีย์ API ของ API Hop ที่ตั้งไว้ บริการรับการยืนยันตัวตนทั้งสองรูปแบบ:

http
x-api-key: YOUR_APIHOP_API_KEY
anthropic-version: 2023-06-01
http
Authorization: Bearer YOUR_APIHOP_API_KEY
anthropic-version: 2023-06-01

การตอบกลับคงรูปแบบ JSON หรือเหตุการณ์ SSE ดั้งเดิมของ Anthropic Messages ไม่แปลงเป็นรูปแบบ OpenAI

การแก้ปัญหา

  • ANTHROPIC_BASE_URL ต้องเป็น API Base URL สาธารณะในหน้านี้ต่อด้วย /anthropic
  • อย่ารวมเส้นทางเอนด์พอยต์ใน ANTHROPIC_BASE_URL ต้องการเฉพาะ Base URL ที่เข้ากันได้กับ Anthropic
  • หลังแก้ ~/.zshrc บน macOS ให้เรียก source ~/.zshrc หรือเปิดเทอร์มินัลใหม่ก่อนเริ่ม Claude Code
  • หาก claude แจ้งไม่พบคำสั่ง ตรวจว่าตำแหน่งติดตั้งอยู่ใน PATH ตำแหน่งที่พบบ่อยคือ ~/.local/bin/claude
  • หาก claude doctor รายงานตัวแปรสภาพแวดล้อมขาด เรียก echo $ANTHROPIC_BASE_URL และ echo $ANTHROPIC_MODEL ในเทอร์มินัลเดียวกันเพื่อยืนยันว่าโหลดแล้ว
  • หากได้รับ 401 ตรวจว่าคีย์ API ถูกต้อง
  • หากโมเดลไม่พร้อม ตรวจว่าชื่อโมเดลมาจากรายการโมเดลพร้อมใช้ข้างต้น
  • เริ่มกระบวนการ Claude Code ใหม่หลังเปลี่ยนตัวแปรสภาพแวดล้อม
  • POST https://api.apihop.ai/anthropic/v1/messages: เอนด์พอยต์ที่เข้ากันได้กับ Anthropic Messages