ภาพรวมของเครื่องมือ CLI
CLI คือเครื่องมือแบบคอมมานด์ไลน์ (Command-line) ไม่ใช่ซอฟต์แวร์ตัวใดตัวหนึ่งโดยเฉพาะ โดย Claude Code, Codex CLI, Gemini CLI, OpenClaw และ OpenCode ล้วนจัดอยู่ในหมวดหมู่นี้ คุณเพียงป้อนภาษาธรรมชาติลงในเทอร์มินัล เครื่องมือเหล่านี้ก็จะสามารถอ่านโปรเจกต์ ตีความโค้ด สร้างไฟล์ รันคำสั่ง หรือช่วยคุณทำงานพัฒนาต่างๆ ให้สำเร็จได้
CLI คืออะไรและใช้ทำอะไรได้บ้าง
เครื่องมือ CLI นั้นทรงพลังกว่าซอฟต์แวร์แช็ตทั่วไป และก็เสี่ยงต่อการใช้งานผิดพลาดได้ง่ายกว่าเช่นกัน เมื่อผู้เริ่มต้นตั้งค่าใช้งานเป็นครั้งแรก แนะนำให้รันในโปรเจกต์สำหรับทดสอบเท่านั้น และสั่งให้เครื่องมือ "ทำความเข้าใจเท่านั้น ห้ามแก้ไข และห้ามรันคำสั่งใดๆ"
สิ่งที่ต้องเตรียมล่วงหน้า
| สิ่งที่ต้องเตรียม | คำอธิบาย | เหตุผลที่สำคัญ |
|---|---|---|
| เทอร์มินัล (Terminal) | Windows ใช้ PowerShell, macOS / Linux ใช้ Terminal | CLI ทำงานบนเทอร์มินัลทั้งหมด |
| ตัวเครื่องมือเอง | ติดตั้ง Claude Code, Codex CLI, Gemini CLI, OpenClaw หรือ OpenCode ให้เรียบร้อยก่อน | ไฟล์การตั้งค่าจะมีผลกับเครื่องมือที่ติดตั้งแล้วเท่านั้น |
| คีย์ / วิธีการเข้าสู่ระบบ | อาจเป็นการเข้าสู่ระบบแบบทางการ, API Key, OAuth หรือ Key ของผู้ให้บริการ (Provider Key) | วิธีการยืนยันตัวตนของแต่ละ CLI นั้นแตกต่างกัน |
| Base URL | จำเป็นต้องใช้เมื่อเชื่อมต่อผ่านผู้ให้บริการ (Provider) หรือพร็อกซีเท่านั้น | ส่วนต่อท้ายของที่อยู่ (Suffix) อาจแตกต่างกันไปตามโปรโตคอล จึงไม่สามารถเปลี่ยนแค่ชื่อโดเมนได้ |
| โปรเจกต์ทดสอบ | สร้างโฟลเดอร์เปล่าขึ้นมาใหม่ หรือคัดลอกโปรเจกต์เดิมมาทดสอบ | หลีกเลี่ยงไม่ให้กระทบหรือสร้างความเสียหายแก่โปรเจกต์จริงระหว่างตั้งค่าครั้งแรก |
ทางเข้าหน้าการตั้งค่าเฉพาะแต่ละเครื่องมือ
วิธีเลือกหน้าที่ต้องการดู
| สิ่งที่คุณต้องการทำตอนนี้ | หน้าที่แนะนำให้เปิดดู | เหตุผล |
|---|---|---|
| ต้องการสลับผู้ให้บริการ (Provider) สำหรับหลาย CLI อย่างเป็นระบบในที่เดียว | ขั้นตอนทั่วไปของ CC-Switch | CC-Switch เหมาะสำหรับการจัดการ Provider จากศูนย์กลาง แล้วจึงกระจายการตั้งค่าไปยังเครื่องมืออย่าง Claude, Codex, Gemini เป็นต้น |
| ตั้งค่าเฉพาะ Claude Code | การตั้งค่า Claude Code | สำหรับ Claude Code ให้เน้นที่ Key, Base URL, ชื่อโมเดลที่เกี่ยวข้องกับ Anthropic / Claude และ settings.json |
| ตั้งค่าเฉพาะ Codex CLI | การตั้งค่า Codex | สำหรับ Codex ให้เน้นที่ config.toml, Provider ที่รองรับ OpenAI, ชื่อโมเดล และตัวแปรสภาพแวดล้อม (Environment Variables) |
| ตั้งค่าเฉพาะ Gemini CLI | การตั้งค่า Gemini | วิธีการเข้าสู่ระบบ, Key ตลอดจนอินเทอร์เฟซของ Vertex / Gemini นั้นแตกต่างจากอินเทอร์เฟซที่เข้ากันได้กับ OpenAI |
| ใช้งาน OpenClaw / OpenCode | OpenClaw / OpenCode | ฟิลด์ Provider ของเครื่องมือทั้งสองนี้อาจเปลี่ยนแปลงตามเวอร์ชัน ควรดูหน้าเอกสารที่เกี่ยวข้องและเอกสารทางการประกอบกัน |
ความเสี่ยงที่ควรระวังก่อนเริ่มตั้งค่า
| ความเสี่ยง | จุดที่มักจะเกิดขึ้น | คำแนะนำ |
|---|---|---|
| เครื่องมือสามารถอ่านไฟล์ในโปรเจกต์ได้ | Claude Code, Codex, Gemini, OpenClaw, OpenCode | ในการรันครั้งแรกให้ทำในไดเรกทอรีทดสอบ อย่าเปิดโปรเจกต์งานจริงโดยตรง |
| โมเดลสามารถรันหรือแนะนำคำสั่งได้ | CLI เขียนโค้ดทุกตัว | เปิดโหมดถามเพื่อยืนยันก่อนเสมอ และตรวจสอบการดำเนินการอย่างละเอียดเมื่อมีคำสั่งลบ ย้าย ติดตั้ง อัปโหลด ฯลฯ |
| รายการตั้งค่าเขียนทับซ้อนกัน | ตัวแปรสภาพแวดล้อมระบบ, การตั้งค่าระดับโปรเจกต์, การตั้งค่าระดับผู้ใช้, CC-Switch | เมื่อการตั้งค่าไม่มีผล ให้ตรวจสอบลำดับความสำคัญ (Priority) ก่อน อย่าแก้ไขหลายจุดพร้อมกัน |
| การใช้โปรโตคอลปะปนกัน | OpenAI, Claude, Gemini, Vertex, อินเทอร์เฟซที่เข้ากันได้ของผู้ให้บริการ | ระบบหลังบ้านของผู้ให้บริการส่งมอบอินเทอร์เฟซแบบใด ให้กรอกลงในหน้าเครื่องมือตามแบบนั้น |
| คัดลอกตัวอย่างของผู้อื่นมาใช้โดยตรง | บทช่วยสอนภายนอก, ภาพหน้าจอ, เอกสารเก่า | URL, Key และชื่อโมเดลในตัวอย่างต้องแทนที่ด้วยข้อมูลจากระบบหลังบ้านของผู้ให้บริการของคุณเอง |
วิธีทดสอบความปลอดภัยในครั้งแรก
หลังจากการตั้งค่าเสร็จสมบูรณ์ อย่าเพิ่งให้ CLI แก้ไขโปรเจกต์จริงทันที ให้สร้างไดเรกทอรีเปล่าขึ้นมาก่อน แล้วใส่ไฟล์ทดสอบแบบง่ายๆ ลงไป จากนั้นสั่งให้เครื่องมือเพียงแค่อ่านและทำความเข้าใจ โดยไม่ต้องแก้ไขไฟล์ใดๆ
Read only the current directory first. Tell me which files are here. Do not modify any files, run any commands, or install any dependencies.หากขั้นตอนนี้ไม่สามารถส่งผลลัพธ์กลับมาได้ตามปกติ ให้ไปที่หน้าแก้ไขปัญหาที่เกี่ยวข้อง อย่าปล่อยให้ CLI ประมวลผลโปรเจกต์จริงโดยอัตโนมัติก่อนที่จะได้รับการยืนยันว่าการตั้งค่าสำเร็จ