การเข้าควบคุมเครื่องมือเขียนโค้ด AI ด้วยคลิกเดียว
การเข้าควบคุมด้วยคลิกเดียว (Takeover) ช่วยให้คุณชี้เครื่องมือ AI coding CLI ที่ใช้งานบ่อยไปยัง AI Gateway ภายในเครื่องได้ โดยไม่ต้องแก้ไขไฟล์ตั้งค่าใดๆ ด้วยตนเอง หลังการเข้าควบคุม คำขอจากเครื่องมือเหล่านี้จะถูกส่งผ่าน http://127.0.0.1:11580 ไปยังช่องทางผู้ให้บริการที่คุณตั้งค่าไว้ใน Gateway อย่างเป็นระบบ และถูกนำไปรวมไว้ในสถิติการใช้งานและค่าใช้จ่ายแบบรวมศูนย์
หลักการทำงาน
เมื่อเข้าควบคุมเครื่องมือแต่ละตัวด้วยคลิกเดียว Gateway จะดำเนินการตามลำดับดังนี้:
- ตรวจสอบสถานะสุขภาพของ Gateway เพื่อยืนยันว่า endpoint ของ proxy ใช้งานได้
- สร้างคีย์เสมือน เฉพาะขึ้นมาอัตโนมัติ (Gateway จะเขียนลงในการตั้งค่าเครื่องมือ; สามารถดูข้อความแบบเปิดเผยได้จากหน้า Key ได้ทุกเมื่อ)
- สำรองไฟล์ตั้งค่าเดิมเป็นนามสกุล
.bak(เช่น~/.claude/settings.json.bak) - เขียน / รวมแบบเจาะลึก (deep merge) การตั้งค่าที่ชี้ไปยัง Gateway อย่างแม่นยำ โดยคงการตั้งค่าอื่นๆ ของคุณไว้ไม่เปลี่ยนแปลง
- รีเฟรชสถานะบนหน้าจอ เพื่อแสดงสถานะการเข้าควบคุมปัจจุบัน
เมื่อหยุดการเข้าควบคุมก็จะเป็นการ "ลบออกอย่างแม่นยำ" เช่นเดียวกัน: จะลบคีย์ที่เกี่ยวข้องออกก็ต่อเมื่อการตั้งค่าชี้ไปยัง Gateway นี้จริงเท่านั้น เพื่อหลีกเลี่ยงการลบการตั้งค่าอื่นๆ ที่คุณตั้งค่าไว้ด้วยตนเองโดยไม่ตั้งใจ พร้อมทั้งเพิกถอนคีย์เสมือนที่สร้างขึ้นอัตโนมัติระหว่างการเข้าควบคุม
สถานะการเข้าควบคุม
เครื่องมือแต่ละตัวจะแสดงสถานะใดสถานะหนึ่งจากสี่สถานะในหน้า AI Gateway → การจัดการการเชื่อมต่อ → ไคลเอนต์:
| สถานะ | ความหมาย |
|---|---|
| เข้าควบคุมแล้ว (Gateway นี้) | เครื่องมือชี้ไปยัง AI Gateway ภายในเครื่องแล้ว |
| เชื่อมต่อแล้ว (ที่อยู่อื่น) | เครื่องมือถูกตั้งค่าให้ชี้ไปยังที่อยู่อื่นแล้ว (คุณตั้งค่าเองหรือชี้ไปยัง Gateway อื่น) Gateway จะไม่เขียนทับเองโดยพลการ |
| ยังไม่เข้าควบคุม | ตรวจพบเครื่องมือ แต่ยังไม่ได้ชี้ไปยัง Gateway |
| ไม่พบเครื่องมือ | ไม่พบไดเรกทอรีการตั้งค่าของเครื่องมือนี้ในเครื่อง |
ข้อกำหนดเบื้องต้น
- ลงชื่อเข้าใช้บัญชี ServBay แล้ว และได้ตั้งค่าช่องทางที่ใช้งานได้อย่างน้อยหนึ่งช่องทางในหน้า ช่องทางผู้ให้บริการ
- เครื่องมือ AI เป้าหมายได้รับการติดตั้งในเครื่องแล้ว (Gateway จะตัดสินว่ามีอยู่หรือไม่จากไดเรกทอรีการตั้งค่าของเครื่องมือนั้น)
การดำเนินการเข้าควบคุมด้วยคลิกเดียว
เข้าไปที่หน้า AI Gateway → การจัดการการเชื่อมต่อ → ไคลเอนต์ ค้นหาเครื่องมือเป้าหมายในรายการเครื่องมือ แล้วคลิก เข้าควบคุมด้วยคลิกเดียว เมื่อเข้าควบคุมสำเร็จ สถานะจะเปลี่ยนเป็น "เข้าควบคุมแล้ว (Gateway นี้)" หากต้องการยกเลิก เพียงคลิก หยุดเข้าควบคุม
รายละเอียดการเข้าควบคุมของแต่ละเครื่องมือ
ตารางด้านล่างแสดงรายการไฟล์ตั้งค่าและเนื้อหาที่ถูกแก้ไขจริงเมื่อเครื่องมือแต่ละตัวถูกเข้าควบคุม เพื่อให้คุณเข้าใจและตรวจสอบได้ง่าย
| เครื่องมือ | ไฟล์ตั้งค่า | เนื้อหาที่เขียน | ที่อยู่ Gateway |
|---|---|---|---|
| Claude Code | ~/.claude/settings.json | env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN | http://127.0.0.1:11580 (ไม่มี /v1) |
| Codex | ~/.codex/config.toml | ส่วน [model_providers.servbay] + model_provider = "servbay" ระดับบนสุด | http://127.0.0.1:11580/v1 |
| Qwen Code | ~/.qwen/.env | OPENAI_BASE_URL + OPENAI_API_KEY (รองรับ OpenAI) | http://127.0.0.1:11580/v1 |
| Kimi CLI | ~/.kimi/config.toml | ส่วน [model_providers.servbay] + คำจำกัดความโมเดล | http://127.0.0.1:11580/v1 |
| CodeBuddy | ~/.codebuddy/models.json | deep merge โหนดโมเดล servbay | http://127.0.0.1:11580/v1 |
| opencode | ~/.config/opencode/opencode.json | deep merge โหนด provider.servbay (รวบรวมโมเดลจากแต่ละช่องทาง) | http://127.0.0.1:11580/v1 |
| Crush | ~/.config/crush/crush.json | deep merge โหนด providers.servbay | http://127.0.0.1:11580/v1 |
ทำไมที่อยู่ของ Claude Code จึงไม่มี /v1
Claude Code ใช้โปรโตคอล Anthropic โดย Gateway จะประกอบ path อย่าง /v1/messages เอง ดังนั้น ANTHROPIC_BASE_URL จึงต้องเป็นที่อยู่รากของ Gateway (ไม่มี /v1) ส่วนเครื่องมืออื่นๆ ส่วนใหญ่ใช้โปรโตคอลที่รองรับ OpenAI จึงต้องมี suffix /v1 การเข้าควบคุมด้วยคลิกเดียวจะกรอกให้อัตโนมัติตามข้อกำหนดของแต่ละเครื่องมือ คุณจึงไม่ต้องแยกเองด้วยตนเอง
การคืนค่าและการแก้ไขปัญหา
- คืนค่าการตั้งค่าเดิม — คลิก ลบออก Gateway จะถอนการตั้งค่าที่ชี้ไปยัง Gateway นี้อย่างแม่นยำ คุณยังสามารถใช้ไฟล์สำรอง
.bakในไดเรกทอรีเดียวกันเพื่อคืนค่าได้ด้วยตนเอง - สถานะแสดง "เชื่อมต่อแล้ว (ที่อยู่อื่น)" — หมายความว่าเครื่องมือนี้ชี้ไปยังที่อยู่อื่นอยู่ในปัจจุบัน (คุณตั้งค่าเองหรือชี้ไปยัง Gateway อื่น) เพื่อหลีกเลี่ยงการเขียนทับการตั้งค่าของคุณ Gateway จะไม่เข้าควบคุมโดยอัตโนมัติ คุณสามารถล้างการตั้งค่านั้นด้วยตนเองก่อนแล้วจึงเข้าควบคุม
- หลังเข้าควบคุมแล้วเครื่องมือยังแจ้งข้อผิดพลาด — โปรดตรวจสอบว่าบริการ proxy ของ Gateway กำลังทำงานอยู่ ช่องทางที่เกี่ยวข้องมีสุขภาพดี และคีย์เสมือนไม่ถูกเพิกถอน และสามารถดูได้ในหน้า สถิติและการตรวจสอบ ว่าคำขอมาถึง Gateway หรือไม่
คำถามที่พบบ่อย (FAQ)
- ถาม: การเข้าควบคุมด้วยคลิกเดียวจะทำลายการตั้งค่าเครื่องมือเดิมของฉันหรือไม่?
- ตอบ: ไม่ Gateway จะเขียน / รวมเฉพาะคีย์ที่เกี่ยวข้องกับ Gateway เท่านั้น และจะสำรองไฟล์เดิมเป็น
.bakก่อนเขียน การตั้งค่าอื่นๆ จะคงไว้ไม่เปลี่ยนแปลง
- ตอบ: ไม่ Gateway จะเขียน / รวมเฉพาะคีย์ที่เกี่ยวข้องกับ Gateway เท่านั้น และจะสำรองไฟล์เดิมเป็น
- ถาม: หลังเข้าควบคุมแล้วฉันยังสามารถแก้ไขกลับด้วยตนเองได้หรือไม่?
- ตอบ: ได้ คลิก "ลบออก" ให้ Gateway ถอนออก หรือใช้ไฟล์สำรอง
.bakคืนค่าด้วยตนเอง
- ตอบ: ได้ คลิก "ลบออก" ให้ Gateway ถอนออก หรือใช้ไฟล์สำรอง
- ถาม: คีย์เสมือนที่ใช้สำหรับการเข้าควบคุมอยู่ที่ไหน?
- ตอบ: Gateway จะสร้างคีย์เสมือนเฉพาะให้กับเครื่องมือแต่ละตัวที่ถูกเข้าควบคุมโดยอัตโนมัติ สามารถดูและจัดการได้ในหน้า คีย์
- ถาม: เครื่องมือในรายการแสดง "ไม่พบเครื่องมือ"?
- ตอบ: หมายความว่าไม่พบไดเรกทอรีการตั้งค่าของเครื่องมือนี้ในเครื่อง โปรดติดตั้งและรันเครื่องมือนั้นหนึ่งครั้งเพื่อให้สร้างไดเรกทอรีการตั้งค่าก่อน แล้วจึงเข้าควบคุม
สรุป
การเข้าควบคุมด้วยคลิกเดียวเปลี่ยนเรื่องยุ่งยากและเสี่ยงต่อข้อผิดพลาดอย่าง "การแก้ไขไฟล์ตั้งค่าของแต่ละเครื่องมือด้วยตนเอง" ให้กลายเป็นเพียงการคลิกครั้งเดียว: สร้างคีย์อัตโนมัติ สำรองอัตโนมัติ เขียนอย่างแม่นยำ และคืนค่าได้ทุกเมื่อ เมื่อทำงานร่วมกับการตั้งค่าช่องทางและสถิติการใช้งานแบบรวมศูนย์ คุณสามารถให้เครื่องมือเขียนโค้ด AI ทั้งหมดในมือของคุณใช้การตั้งค่าผู้ให้บริการและมุมมองค่าใช้จ่ายชุดเดียวกันร่วมกันได้ หากคุณต้องการเรียกใช้ Gateway จากโค้ดของคุณเอง โปรดดูที่ Endpoint และตัวแปรสภาพแวดล้อม
