ตัวแทนเขียนโค้ด
BasicRouter ทำงานร่วมกับตัวแทนเขียนโค้ดและเครื่องมือพัฒนา AI ที่รองรับ จุดเชื่อมต่อ API ที่เข้ากันได้กับ OpenAI หรือ Anthropic ใช้นามแฝงการกำหนดเส้นทางเช่น mwf/coding-auto เพื่อให้ BasicRouter สามารถกำหนดเส้นทางไปยังโมเดลเขียนโค้ดที่ดีที่สุดที่พร้อมใช้งาน โดยไม่ต้องให้นักพัฒนาเปลี่ยนการกำหนดค่าเครื่องมือ
การตั้งค่าที่เข้ากันได้กับ OpenAI แบบทั่วไป
ใช้การตั้งค่านี้สำหรับ Cursor, Codex, Hermes, OpenClaw, Continue, Aider, Cline, ตัวแทนที่ใช้ LangChain, ตัวแทนที่ใช้ LlamaIndex, และรันไทม์ตัวแทนที่เข้ากันได้กับ OpenAI แบบกำหนดเอง
export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"การตั้งค่าที่เข้ากันได้กับ Anthropic แบบทั่วไป
ใช้การตั้งค่านี้สำหรับไคลเอนต์ที่เข้ากันได้กับ Claude และเครื่องมือที่คาดหวังรูปแบบ Anthropic Messages
export ANTHROPIC_BASE_URL="https://api.basicrouter.ai/api/anthropic"
export ANTHROPIC_API_KEY="$BASICROUTER_API_KEY"
export ANTHROPIC_MODEL="mwf/coding-auto"โมเดลตัวแทนที่แนะนำ
| กรณีการใช้งาน | นามแฝงที่แนะนำ | ข้อกำหนด |
|---|---|---|
| การเขียนโค้ดทั่วไป | mwf/coding-auto | การเรียกเครื่องมือ, การสตรีม, ความสามารถเขียนโค้ดที่แข็งแกร่ง |
| แชทเขียนโค้ดรวดเร็ว | mwf/coding-fast | เวลาแฝงต่ำและการสตรีม |
| วิเคราะห์รีโพสิทอรีขนาดใหญ่ | mwf/coding-long | บริบทยาวและเอาต์พุตที่เสถียร |
| ผู้ช่วยเขียนโค้ดที่คำนึงถึงต้นทุน | mwf/low-cost | ราคาต่ำกว่าและคุณภาพการเขียนโค้ดที่ยอมรับได้ |
| ภาพหน้าจอ UI / เขียนโค้ดด้วยการมองเห็น | mwf/vision-chat | อินพุตภาพและเอาต์พุตข้อความ |
คู่มือฉับไว Cursor
ใช้จุดเชื่อมต่อที่เข้ากันได้กับ OpenAI
Base URL: https://api.basicrouter.ai/api/v1
API Key: BASICROUTER_API_KEY
Model: mwf/coding-autoขั้นตอนที่แนะนำ:
- เปิดการตั้งค่า Cursor
- เพิ่มหรือเปิดใช้งานการกำหนดค่าคีย์ API ที่เข้ากันได้กับ OpenAI
- ตั้งค่าการแทนที่ URL ฐาน OpenAI เป็น
https://api.basicrouter.ai/api/v1 - เพิ่มโมเดลแบบกำหนดเอง เช่น
mwf/coding-auto,mwf/coding-fastหรือmwf/coding-long - ใช้โมเดลที่รองรับการสตรีมและการเรียกเครื่องมือเพื่อพฤติกรรมตัวแทนที่ดีที่สุด
การแก้ไขปัญหา:
| ปัญหา | การแก้ไขที่แนะนำ |
|---|---|
| โมเดลไม่แสดง | เพิ่มชื่อโมเดลด้วยตนเองเป็นโมเดลกำหนดเอง |
| การเรียกเครื่องมือล้มเหลว | ใช้โมเดลที่มี tool_calling: true ในหน้าโมเดล |
| การสตรีมถูกขัดจังหวะ | ลองใหม่ด้วยการถดถอยหรือใช้นามแฝงการกำหนดเส้นทางพร้อมการสำรอง |
| ข้อผิดพลาด 401 | ตรวจสอบคีย์ API และ URL ฐาน |
| ข้อผิดพลาดโมเดล 404 | ยืนยันว่าโมเดลถูกเปิดใช้งานสำหรับบัญชี |
คู่มือฉับไว Claude Code
ใช้จุดเชื่อมต่อเกตเวย์ที่เข้ากันได้กับ Anthropic
export ANTHROPIC_BASE_URL="https://api.basicrouter.ai/api/anthropic"
export ANTHROPIC_API_KEY="$BASICROUTER_API_KEY"
export ANTHROPIC_MODEL="mwf/coding-auto"BasicRouter รองรับเส้นทางที่เข้ากันได้กับ Anthropic นี้สำหรับ Claude Code และความเข้ากันได้ของ Anthropic SDK:
POST /api/v1/messagesข้อกำหนดที่แนะนำ:
| ข้อกำหนด | เหตุผล |
|---|---|
| รูปแบบคำขอที่เข้ากันได้กับ Anthropic Messages | Claude Code คาดหวังข้อความสไตล์ Anthropic |
| การรองรับการสตรีม | Claude Code พึ่งพา UX การสตรีม |
| การรองรับการเรียกเครื่องมือ | จำเป็นสำหรับเวิร์กโฟลว์การเขียนโค้ดแบบตัวแทน |
| บริบทยาว | มีประโยชน์สำหรับงานระดับรีโพสิทอรี |
| การสำรองที่เสถียร | มีประโยชน์สำหรับเซสชันเขียนโค้ดที่ใช้เวลานาน |
คู่มือฉับไว Codex
ใช้ BasicRouter เป็นผู้ให้บริการโมเดลที่เข้ากันได้กับ OpenAI แบบกำหนดเอง
ตัวอย่างการกำหนดค่าผู้ให้บริการ:
[model_providers.basicrouter]
name = "BasicRouter"
base_url = "https://api.basicrouter.ai/api/v1"
env_key = "BASICROUTER_API_KEY"
wire_api = "responses"
model_provider = "basicrouter"
model = "mwf/coding-auto"ตัวแปรสภาพแวดล้อม:
export BASICROUTER_API_KEY="br_xxx"โมเดลที่แนะนำ:
| โมเดล | กรณีการใช้งาน |
|---|---|
mwf/coding-auto | โมเดลตัวแทนเขียนโค้ดเริ่มต้น |
mwf/coding-long | บริบทรีโพสิทอรีขนาดใหญ่ |
mwf/coding-fast | การวนซ้ำรวดเร็วและการเปลี่ยนแปลงเล็กน้อย |
การแก้ไขปัญหา:
| ปัญหา | การแก้ไขที่แนะนำ |
|---|---|
| ข้อผิดพลาดการรับรองความถูกต้อง | ยืนยันว่า env_key ชี้ไปที่ BASICROUTER_API_KEY |
| ไม่พบโมเดล | เพิ่มนามแฝงในคอนโซล BasicRouter หรือใช้รหัสโมเดลโดยตรง |
| ข้อผิดพลาด API Responses | ใช้ wire_api = "responses" เฉพาะกับโมเดลและจุดเชื่อมต่อที่รองรับ Responses เท่านั้น |
| โมเดลที่รองรับเฉพาะ Chat Completions | สลับไปยัง API wire ที่เข้ากันได้กับแชทหากไคลเอนต์รองรับ |
คู่มือฉับไว Hermes
ใช้จุดเชื่อมต่อที่เข้ากันได้กับ OpenAI เว้นแต่การปรับใช้ Hermes ของคุณกำหนดค่าไว้สำหรับ พิธีสารอื่น
export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"นโยบายโมเดลที่แนะนำ:
| งาน Hermes | โมเดล |
|---|---|
| การสร้างโค้ดทั่วไป | mwf/coding-auto |
| การดำเนินการงานเวลาแฝงต่ำ | mwf/coding-fast |
| สแกนรีโพสิทอรีบริบทยาว | mwf/coding-long |
| งานเบื้องหลังที่คำนึงถึงต้นทุน | mwf/low-cost |
คู่มือฉับไว OpenClaw
ใช้จุดเชื่อมต่อที่เข้ากันได้กับ OpenAI สำหรับการกำหนดค่ารันไทม์ตัวแทนสไตล์ OpenAI
export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"หาก OpenClaw รองรับผู้ให้บริการหลายราย ให้กำหนดค่า BasicRouter เป็นผู้ให้บริการที่เข้ากันได้กับ OpenAI และใช้นามแฝงการกำหนดเส้นทาง BasicRouter สำหรับการเลือกโมเดล
{
"provider": "openai-compatible",
"base_url": "https://api.basicrouter.ai/api/v1",
"api_key_env": "BASICROUTER_API_KEY",
"model": "mwf/coding-auto"
}รายการตรวจสอบความเข้ากันได้ของตัวแทน
| ความสามารถ | จำเป็นสำหรับ |
|---|---|
| การสตรีม | UX ของเทอร์มินัล/เอดิเตอร์ที่ดี |
| การเรียกเครื่องมือ | การเขียนโค้ดแบบตัวแทน, การแก้ไขไฟล์, การดำเนินการคำสั่ง |
| บริบทยาว | พื้นที่เก็บข้อมูลขนาดใหญ่และการเปลี่ยนแปลงหลายไฟล์ |
| เอาต์พุตแบบโครงสร้าง | การวางแผน การแบ่งงาน เวิร์กโฟลว์อัตโนมัติ |
| อินพุตภาพ | การวิเคราะห์ภาพหน้าจอ UI และเวิร์กโฟลว์ออกแบบสู่โค้ด |
| การสำรอง | ความเสถียรของการผลิตและงานที่ใช้เวลานาน |
