Codex CLI คืออะไร ติดตั้งและตั้งค่า config.toml อย่างไร

คนที่มีแพ็ก ChatGPT อยู่แล้วมักเริ่มลอง coding agent จาก Codex CLI เพราะล็อกอินด้วยบัญชีเดิมได้เลย ส่วนที่คนติดกันบ่อยไม่ใช่การติดตั้ง แต่เป็นไฟล์ config.toml ที่คุมแทบทุกอย่าง ตั้งแต่ว่าจะให้ agent รันคำสั่งเองได้แค่ไหน ไปจนถึงการต่อกับ API อื่น บทความนี้พาไล่ทีละขั้น

Codex CLI คืออะไร

Codex CLI คือ coding agent ของ OpenAI ที่รันใน terminal และเปิดซอร์สอยู่บน GitHub คุณสั่งงานเป็นภาษาธรรมดา แล้วมันจะอ่านโค้ด แก้ไฟล์ และรันคำสั่งในโปรเจกต์ให้ ภายในขอบเขตที่คุณอนุญาต

หลักการทำงานเหมือน agent ตัวอื่น คือรับเป้าหมาย อ่านไฟล์ที่เกี่ยวข้อง ลองแก้ รันคำสั่งเพื่อดูผล แล้วแก้ต่อจนเสร็จ ถ้ายังไม่คุ้นกับคำนี้ อ่านพื้นฐานได้ที่ AI Agent คืออะไร จุดที่ Codex ต่างออกไปคือระบบ sandbox ที่จำกัดสิ่งที่คำสั่งของ agent แตะได้ ซึ่งเปิดไว้เป็นค่าเริ่มต้น

Codex ยังมีแบบส่วนเสริมใน IDE, desktop app และแบบ cloud ด้วย แต่ตัว CLI เป็นตัวที่ตั้งค่าได้ละเอียดที่สุด ถ้าคุณใช้ Claude Code อยู่ แนวคิดส่วนใหญ่ใช้ด้วยกันได้ เทียบวิธีติดตั้งและคำสั่งได้ที่ คู่มือ Claude Code

ติดตั้ง Codex CLI อย่างไร

ใช้สคริปต์ติดตั้งบรรทัดเดียวได้ทั้ง macOS, Linux และ Windows หรือจะติดตั้งผ่าน npm หรือ Homebrew ก็ได้ เสร็จแล้วพิมพ์ codex ในโฟลเดอร์โปรเจกต์เพื่อเริ่มใช้งาน

macOS และ Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

npm หรือ Homebrew

npm install -g @openai/codex
# หรือ
brew install --cask codex

บน Windows ถ้าโปรเจกต์ของคุณอยู่ใน WSL อยู่แล้ว จะติดตั้งด้วยคำสั่งแบบ Linux ข้างใน WSL ก็ได้

เริ่ม session แรกและคำสั่งที่ใช้บ่อย

cd ~/projects/my-app
codex

ครั้งแรกจะให้เลือกวิธีล็อกอิน (อธิบายในหัวข้อถัดไป) แล้วพิมพ์งานที่ต้องการได้เลย ก่อนสั่งงานใหญ่ให้ commit ไว้ก่อนทุกครั้ง จะได้ย้อนกลับได้ถ้าผลไม่ถูกใจ ระหว่างทำงานใช้คำสั่งเหล่านี้ได้

ถ้าจะใช้ในสคริปต์หรือ CI ให้ใช้ codex exec ซึ่งรันแบบไม่โต้ตอบ และ codex resume --last ใช้เปิดบทสนทนาล่าสุดต่อ

ล็อกอิน Codex ด้วย ChatGPT หรือ API key ต่างกันอย่างไร

Sign in with ChatGPT ใช้โควตาของแพ็ก ChatGPT ที่คุณจ่ายอยู่ ส่วน API key ใช้บัญชี OpenAI Platform และจ่ายตาม token ในราคามาตรฐานของ API ไม่หักจากโควตาของแพ็ก

ถ้ามีแพ็กอย่าง Plus, Pro หรือ Business อยู่แล้ว การล็อกอินด้วย ChatGPT สะดวกที่สุด เลือกตัวเลือกนี้ตอนเปิด codex ครั้งแรกแล้วยืนยันในเบราว์เซอร์ ข้อควรรู้คือโควตาของ Codex บนแพ็ก ChatGPT คิดเป็นรอบ 5 ชั่วโมงแบบเลื่อนไปเรื่อยๆ ควบคู่กับลิมิตรายสัปดาห์ และ OpenAI ปรับเงื่อนไขนี้หลายครั้งในปี 2569 จึงควรดูยอดของตัวเองด้วย /status และหน้าราคาของ OpenAI แทนการจำตัวเลขจากที่อื่น

ถ้าจะใช้ API key ให้เก็บ key ไว้ในตัวแปร OPENAI_API_KEY แล้วส่งเข้าคำสั่งล็อกอิน

printenv OPENAI_API_KEY | codex login --with-api-key

แบบนี้คิดเงินตาม token ที่ใช้จริง ถ้ายังนึกภาพไม่ออกว่า token คิดกันอย่างไร ดูที่ token คืออะไร ส่วนฟีเจอร์ที่ต้องพึ่ง cloud บางอย่างจะใช้กับ API key ได้จำกัด

บนเซิร์ฟเวอร์ที่ไม่มีเบราว์เซอร์ ใช้ codex login --device-auth แล้วกรอกรหัสครั้งเดียวจากเครื่องอื่น Codex เก็บข้อมูลล็อกอินไว้ที่ ~/.codex/auth.json หรือในที่เก็บรหัสของระบบ ให้ดูแลไฟล์นี้เหมือนรหัสผ่าน ห้าม commit หรือส่งต่อ

ตั้งค่า config.toml ของ Codex

Codex อ่านการตั้งค่าจาก ~/.codex/config.toml ใส่ค่าเริ่มต้นที่ใช้ทุกโปรเจกต์ไว้ที่นี่ เช่น ระดับการคิดและโหมดอนุญาต แล้วค่อยปรับเป็นรายโปรเจกต์หรือรายครั้งตอนรันคำสั่ง

# ~/.codex/config.toml
model_reasoning_effort = "medium"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = false

ค่าจากหลายที่ซ้อนกันได้ ลำดับจากชนะมากไปน้อยคือ

1. flag ตอนรันคำสั่ง เช่น -m หรือ -c key=value
2. .codex/config.toml ในโฟลเดอร์โปรเจกต์ (เฉพาะโปรเจกต์ที่คุณเชื่อถือแล้ว)
3. ไฟล์ profile ที่เลือกด้วย --profile ชื่อ ซึ่งอยู่ที่ ~/.codex/ชื่อ.config.toml
4. ~/.codex/config.toml ของคุณ
5. ค่าที่องค์กรหรือระบบกำหนด แล้วจึงเป็นค่าเริ่มต้นของโปรแกรม

ข้อนี้ช่วยตอนงงว่าทำไมตั้งค่าแล้วไม่ติด ส่วนใหญ่เพราะมีค่าในชั้นที่สูงกว่าทับอยู่

โหมดอนุญาต: sandbox กับ approval

Codex แยกเรื่องนี้เป็นสองค่า คือ sandbox_mode บอกว่าคำสั่งที่ agent รันแตะอะไรได้บ้าง และ approval_policy บอกว่าเมื่อไรต้องหยุดถามคุณ

ในโฟลเดอร์ที่ใช้ git ค่าเริ่มต้นคือ workspace-write คู่กับ on-request ซึ่งเป็นจุดสมดุลที่ดีสำหรับงานส่วนใหญ่ เปลี่ยนระหว่างใช้งานได้ด้วย /permissions ส่วน --yolo ที่เห็นคนแชร์กันคือการปิดทั้ง sandbox และการถาม เอกสารของ OpenAI ไม่แนะนำ ถ้าต้องใช้จริง ให้ใช้ในเครื่องหรือ container ที่แยกไว้

ใช้ Codex กับ API อื่นผ่าน model_providers ทำอย่างไร

เพิ่มตาราง [model_providers.<ชื่อ>] ใน config.toml บอก base_url ของ API ชื่อตัวแปรที่เก็บ API key และ wire_api แล้วตั้ง model_provider กับ model ให้ชี้ไปที่ผู้ให้บริการนั้น Codex จะส่งงานไปที่ API นั้นแทน

# ~/.codex/config.toml
model = "ชื่อโมเดลของผู้ให้บริการ"
model_provider = "myapi"

[model_providers.myapi]
name = "My API"
base_url = "https://api.example.com/v1"
env_key = "MYAPI_API_KEY"
wire_api = "responses"

• base_url คือที่อยู่ของ API มักลงท้ายด้วย /v1
• env_key คือ ชื่อ ตัวแปรที่เก็บ key ไม่ใช่ตัว key ใส่ key จริงไว้ใน environment เท่านั้น ไฟล์ config จะได้แชร์หรือสำรองได้โดยไม่หลุด
• wire_api = "responses" คือส่งงานแบบ Responses API ผู้ให้บริการต้องรองรับรูปแบบนี้ ถ้าอยากเข้าใจว่าทำไมเครื่องมือหนึ่งต่อได้หลายเจ้า อ่านต่อที่ OpenAI-compatible API คืออะไร
• ชื่อ openai, ollama และ lmstudio สงวนไว้ ตั้งเป็นชื่อผู้ให้บริการเองไม่ได้ ถ้าแค่อยากเปลี่ยนที่อยู่ของผู้ให้บริการ OpenAI ตัวเดิม ใช้ค่า openai_base_url แทน

ตั้งเสร็จแล้วเปิด codex ใหม่ แล้วพิมพ์ /status เพื่อดูว่าใช้ผู้ให้บริการและโมเดลที่ตั้งไว้จริง ถ้าขึ้น error เรื่องสิทธิ์ ให้เช็กก่อนว่า export ตัวแปร key ไว้ใน shell เดียวกับที่เปิด Codex

ใช้ Codex กับ buzzAI แบบไม่คิดค่า token

buzzAI กำลังทำ API สำหรับ coding agent ที่คิดเป็นแพ็กเหมาจ่ายแบบไม่คิดค่า token ใช้กับ Codex CLI ได้ผ่าน model_providers ตามด้านล่าง และใช้กับ Claude Code หรือเครื่องมือแบบ OpenAI-compatible ได้ด้วย ใช้โมเดล open-weight Qwen3.8-27B ขนาด context 64K, 128K หรือ 256K ตามแพ็ก

# ~/.codex/config.toml
model = "Qwen3.8-27B"
model_provider = "buzzai"

[model_providers.buzzai]
name = "buzzAI"
base_url = "https://api.heybuzzai.com/v1"
env_key = "BUZZAI_API_KEY"
wire_api = "responses"

สิ่งที่มีขอบเขตคือจำนวน agent ที่รันพร้อมกัน (แพ็ก Personal ได้ 1 agent แพ็กบริษัทได้ 1–8 ตัว) ขนาด context และคิวในช่วงที่คนใช้เยอะ ตอนนี้ API ยังไม่เปิดให้ใช้ทั่วไป ถ้าขอร่วมทดสอบไว้ API key จะส่งไปทางอีเมลเมื่อมีผู้สมัครครบโควต้าที่กำหนด ดูแพ็กทั้งหมดได้ที่หน้าราคา