วิธีใช้งาน CC-Switch-CLI
CC-Switch-CLI เป็นเครื่องมือสลับ Provider สำหรับ Command Line เหมาะสำหรับเซิร์ฟเวอร์ที่ไม่มีหน้าต่างกราฟิก (GUI), สภาพแวดล้อม SSH หรือผู้ที่ต้องการสลับ Provider ไปมาระหว่าง Claude Code, Codex, Gemini CLI, OpenCode และ OpenClaw อย่างรวดเร็ว
เหมาะสำหรับใคร
หากคุณเป็นผู้ใช้เดสก์ท็อปทั่วไป แนะนำให้ใช้ CC Switch เวอร์ชัน GUI เป็นหลักก่อน แต่หากคุณคุ้นเคยกับการใช้ Terminal อยู่แล้ว หรือจำเป็นต้องจัดการการตั้งค่าแบบกลุ่ม (Batch) หน้านี้จะตอบโจทย์คุณ กล่องโค้ดด้านล่างจะมีเฉพาะคำสั่งเท่านั้น โดยคำอธิบายจะอยู่นอกกล่องโค้ด เพื่อป้องกันการคัดลอกคำอธิบายติดไปด้วย
การติดตั้งและการเริ่มใช้งาน
ผู้ใช้ macOS / Linux สามารถทำตามเอกสารทางการเพื่อใช้สคริปต์ติดตั้งหรือแพ็กเกจจาก Releases ได้ ส่วนผู้ใช้ Windows แนะนำให้ดาวน์โหลดไฟล์บีบอัดที่ตรงกับระบบจาก Releases แล้วแตกไฟล์เพื่อรันโปรแกรมในโฟลเดอร์ดังกล่าว
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash cc-switch.\cc-switch.exeพิมพ์ cc-switch โดยตรงเพื่อเข้าสู่อินเทอร์เฟซแบบโต้ตอบ (TUI) ซึ่งเหมาะสำหรับผู้เริ่มต้นในการดูเมนูต่างๆ ส่วนคำสั่งด้านล่างนี้เหมาะสำหรับกรณีที่คุณทราบอยู่แล้วว่าต้องการทำอะไรและต้องการสั่งรันคำสั่งโดยตรง
การตรวจสอบสภาพแวดล้อมระบบ
| สิ่งที่ต้องตรวจสอบ | วิธีตรวจสอบ | เหตุผล |
|---|---|---|
| ติดตั้ง CC Switch หรือเวอร์ชัน CLI แล้ว | Terminal นี้รู้จักคำสั่งดังกล่าว | หากยังไม่ได้ติดตั้ง คำสั่งการตั้งค่าทั้งหมดจะล้มเหลว |
| ติดตั้ง CLI ปลายทางแล้ว | Claude Code, Codex และ Gemini CLI อย่างน้อยต้องสามารถเปิดใช้งานแยกกันได้ | CC-Switch-CLI ไม่ได้ติดตั้งเครื่องมือปลายทางให้คุณ |
| ข้อมูล Provider ครบถ้วน | เตรียม Base URL, API Key และชื่อโมเดลให้พร้อม | การตั้งค่าผ่าน Command Line ไม่มีหน้าต่างแจ้งเตือน หากขาดสิ่งใดสิ่งหนึ่งอาจทำให้ทำงานไม่สำเร็จได้ง่าย |
| ทดสอบในไดเรกทอรีทดสอบก่อน | อย่าสลับการตั้งค่าแบบกลุ่มในโปรเจกต์จริงทันที | ย้อนกลับได้ง่ายกว่าหากการตั้งค่าไม่ถูกต้อง |
cc-switch env tools cc-switch env check cc-switch provider current cc-switch --app codex provider currentคำสั่งจัดการ Provider
Provider คือการตั้งค่าของผู้ให้บริการ ก่อนเพิ่ม Provider ให้เตรียม Base URL, API Key และชื่อโมเดลจากระบบหลังบ้านของผู้ให้บริการให้พร้อม เมื่อต้องการแก้ไขหรือสลับ Provider ให้ตรวจสอบหมายเลข ID ด้วยคำสั่ง list ก่อนเสมอ
cc-switch provider list cc-switch provider add cc-switch provider edit <id> cc-switch provider fetch-models <id>cc-switch provider switch <id> cc-switch provider stream-check <id> cc-switch provider fetch-models <id>< id> ต้องแทนที่ด้วยหมายเลขที่เห็นใน cc-switch provider list อย่าคัดลอก < id> ไปรันคำสั่งตรงๆการจัดการแยกตามแอปพลิเคชัน
หากคุณต้องการดูการตั้งค่าของเครื่องมือปลายทางใดเครื่องมือหนึ่งโดยเฉพาะ คุณสามารถใส่ --app เพิ่มเข้าไปได้ ซึ่งมีประโยชน์มากสำหรับการตรวจสอบข้อผิดพลาดของ Claude Code, Codex และ Gemini CLI แยกต่างหาก
cc-switch --app claude provider list cc-switch --app codex provider list cc-switch --app gemini provider list cc-switch --app opencode provider list cc-switch --app openclaw provider listcc-switch --app claude provider current cc-switch --app codex provider current cc-switch --app gemini provider currentหลังจากยืนยันว่าแอปพลิเคชันปลายทางและ Provider ปัจจุบันถูกต้องแล้ว จึงทำการสลับ เมื่อสลับเรียบร้อย ให้รีสตาร์ท Terminal แล้วใช้เครื่องมือปลายทางส่งคำถามสั้นๆ เพื่อทดสอบ
claude "Please reply only: Claude Code is active" codex "Please reply only: Codex is active" gemini "Please reply only: Gemini is active"การซิงค์ MCP
ผู้เริ่มต้นทุกคนไม่จำเป็นต้องตั้งค่า MCP ให้จัดการก็ต่อเมื่อคุณได้ใช้งาน MCP ใน Claude Code, Codex, Gemini CLI อยู่แล้วและต้องการซิงค์ข้ามเครื่องมือ สำหรับการใช้งานครั้งแรก แนะนำให้เข้าไปที่เมนู TUI เพื่อดูส่วนของ MCP ก่อน และอย่าคัดลอกคำสั่งขั้นสูงจากบทช่วยสอนเก่าๆ มาใช้โดยตรง
cc-switch cc-switch --app codexแนวทางการตั้งค่า
- ยืนยันเครื่องมือปลายทางที่ต้องการสลับก่อน: Claude Code, Codex, Gemini CLI หรือ CLI อื่นๆ
- เตรียม Base URL, API Key และชื่อโมเดลจากระบบหลังบ้านของผู้ให้บริการ
- เพิ่มหรือเลือก Provider ใน CC-Switch-CLI
- นำ Provider ไปใช้กับเครื่องมือปลายทาง
- หลังจากเปิด Terminal ใหม่อีกครั้ง ให้ทดสอบด้วยคำถามสั้นๆ บน CLI ปลายทาง
- เมื่อยืนยันว่าสำเร็จแล้ว จึงนำ Provider เดียวกันนี้ไปใช้กับเครื่องมือปลายทางอื่นๆ
| สถานการณ์ | คำแนะนำ |
|---|---|
| ใช้งานบนเดสก์ท็อปภายในเครื่อง | แนะนำให้ใช้ CC Switch เวอร์ชัน GUI เป็นหลัก เพราะฟิลด์และสถานะต่างๆ ดูเข้าใจง่ายกว่า |
| เซิร์ฟเวอร์ระยะไกล / SSH | เลือกใช้ CC-Switch-CLI และตรวจสอบคำสั่งของเวอร์ชันปัจจุบันก่อนเริ่มดำเนินการ |
| สลับการตั้งค่าแบบกลุ่ม | ตรวจสอบความถูกต้องในโปรเจกต์ทดสอบให้เรียบร้อยก่อนนำไปใช้กับโปรเจกต์จริง |
| ใช้งานเครื่องร่วมกันหลายคน | อย่าใส่ Key ของคุณลงในการตั้งค่าสาธารณะ และตรวจสอบขอบเขต (Scope) ของไฟล์การตั้งค่าก่อนเสมอ |
การแก้ปัญหาเบื้องต้นสำหรับผู้เริ่มต้น
| อาการที่พบ | สิ่งที่ควรตรวจสอบก่อน | แนวทางแก้ไข |
|---|---|---|
| ไม่พบคำสั่ง (Command not found) | ตรวจสอบว่าได้ติดตั้งแล้วหรือไม่ และเพิ่มลงใน PATH แล้วหรือยัง | เปิด Terminal ใหม่อีกครั้ง หรือกลับไปดูคู่มือการติดตั้งทางการเพื่อตรวจสอบตำแหน่งที่ติดตั้ง |
| เครื่องมือปลายทางไม่มีการเปลี่ยนแปลงหลังสลับ | ได้เปิด Terminal ใหม่แล้วหรือไม่ และเลือกเครื่องมือปลายทางถูกต้องหรือไม่ | ปิดหน้าต่าง Terminal ปัจจุบันแล้วเปิดใหม่ จากนั้นทดสอบอีกครั้ง |
| 401 / Unauthorized | Key ถูกต้องครบถ้วนหรือไม่ และหมดอายุแล้วหรือไม่ | คัดลอก Key ใหม่อีกครั้ง และตรวจสอบให้แน่ใจว่าไม่มีการเว้นวรรคส่วนเกิน |
| ไม่พบโมเดล (model not found) | ชื่อโมเดลคัดลอกมาจากระบบหลังบ้านอย่างถูกต้องตรงกันหรือไม่ | กรอกข้อมูลใหม่ตามรายชื่อโมเดลที่ผู้ให้บริการระบุไว้ |