การกำหนดค่า OpenCode
OpenCode เป็นผู้ช่วยเขียนโค้ด AI บนเทอร์มินัลแบบโอเพนซอร์ส เหมาะสำหรับการถามตอบเกี่ยวกับโค้ด การแก้ไขไฟล์ และการสลับโมเดลภายในไดเรกทอรีโปรเจกต์ สำหรับผู้เริ่มต้นควรเริ่มใช้ตัวช่วยสร้างการเชื่อมต่อในตัวก่อน และหลีกเลี่ยงการเขียน JSON ทั้งหมดด้วยตนเองตั้งแต่เริ่มต้น
ข้อมูลอย่างเป็นทางการ การดาวน์โหลดและเอกสารประกอบให้อิงตามเว็บไซต์ทางการเป็นหลัก
เครื่องมือนี้คืออะไรและใช้ทำอะไร
ตำแหน่งไฟล์การกำหนดค่า
| ระบบ | ตำแหน่งไฟล์การกำหนดค่า | คำอธิบาย |
|---|---|---|
| Windows | C: \Users\YourUsername\. config\opencode\opencode.json | หากยังไม่มีไฟล์ ให้สร้างขึ้นใหม่ |
| macOS / Linux | ~/. config/opencode/opencode.json | หากยังไม่มีไฟล์ ให้สร้างขึ้นใหม่ |
เริ่มต้นด้วยตัวช่วยสร้างการเชื่อมต่อ
ตัวช่วยสร้างการเชื่อมต่อ OpenCode
cd YOUR_TEST_PROJECT opencode /connectตรวจสอบโมเดล OpenCode
cd YOUR_TEST_PROJECT opencode /modelsข้อควรระวังเมื่อกำหนดค่าด้วยตนเอง
แก้ไขไฟล์การกำหนดค่าต่อเมื่อเอกสารของผู้ให้บริการระบุฟิลด์ Provider ของ OpenCode, ตำแหน่งที่ต้องใส่ Base URL และ Key ไว้อย่างชัดเจนเท่านั้น ฟิลด์อาจแตกต่างกันไปในแต่ละเวอร์ชัน ห้ามคัดลอกตัวอย่าง JSON จากเครื่องมืออื่นมาใส่ใน OpenCode โดยตรง
| รายการที่ต้องตรวจสอบ | คำอธิบาย |
|---|---|
| ประเภท Provider | อย่าผสมผสานระหว่างโปรโตคอล OpenAI, Claude, Gemini หรือโปรโตคอลอื่นๆ |
| Base URL | ใช้ที่อยู่แบบเต็มที่ผู้ให้บริการระบุไว้สำหรับ OpenCode หรือโปรโตคอลที่เกี่ยวข้อง |
| Key | ใช้ Key ที่ตรงกับ Provider ปัจจุบัน |
| ชื่อโมเดล | คัดลอกรายชื่อโมเดลจากระบบหลังบ้านของผู้ให้บริการ |
วิธีทดสอบหลังจากบันทึก
- หลังจากเข้าไปยังไดเรกทอรีโปรเจกต์ทดสอบแล้ว ให้เรียกใช้
opencode - ใช้
/modelsก่อนเพื่อยืนยันว่ามองเห็นโมเดลที่คุณเพิ่งกำหนดค่าไว้ - หลังจากเลือกโมเดลแล้ว ให้ส่งข้อความว่า 'Please only reply: OpenCode configuration successful'
- ในการใช้งานครั้งแรก อย่าเพิ่งให้ระบบแก้ไขไฟล์ ให้เพียงแค่อธิบายไดเรกทอรีปัจจุบันหรือไฟล์ปัจจุบันก่อน
- หากล้มเหลว ให้กลับไปใช้
/connectก่อน หรือตรวจสอบ Provider, Base URL, Key และชื่อโมเดลเทียบกับเอกสารของผู้ให้บริการ
| ปัญหาที่พบ | สิ่งที่ควรตรวจสอบก่อน | วิธีแก้ไข |
|---|---|---|
ไม่มีโมเดลใน /models | บันทึก Provider สำเร็จหรือไม่ สามารถดึงรายชื่อโมเดลได้หรือไม่ | เพิ่ม Model ID / ชื่อโมเดลจากระบบหลังบ้านของผู้ให้บริการด้วยตนเอง |
| การเชื่อมต่อล้มเหลว | Base URL ตรงกับโปรโตคอลของ Provider ปัจจุบันหรือไม่ | อย่าผสมที่อยู่ของ Claude, Gemini และ OpenAI เข้าด้วยกัน |
| ไฟล์การกำหนดค่าใช้งานไม่ได้ | รูปแบบ JSON เครื่องหมายจุลภาค (,) เครื่องหมายอัญประกาศ (") | แนะนำให้สร้างการกำหนดค่าโดยใช้ตัวช่วยสร้างการเชื่อมต่อก่อน แล้วจึงปรับแต่งด้วยตนเองเล็กน้อย |
เว็บไซต์ทางการของ OpenCode ดูคำแนะนำเกี่ยวกับการติดตั้ง การยืนยันตัวตน และคำสั่งต่างๆ
เอกสารอ้างอิงการกำหนดค่า AI Provider สำหรับ OpenCode ดูแนวทางการกำหนดค่าของ opencode.json