Codex CLI Command Reference

เอกสารนี้ครอบคลุม commands และ flags ทั้งหมดของ Codex CLI ประกอบด้วย global options, รายละเอียดคำสั่งแต่ละตัว และคำแนะนำด้านความปลอดภัย

Global Flags

CLI รับค่าเริ่มต้นจาก ~/.codex/config.toml โดย command-line override มีความสำคัญสูงกว่า:

Flag	คำอธิบาย
--add-dir PATH	เพิ่มสิทธิ์เขียนไดเรกทอรีเพิ่มเติมนอกเหนือจาก workspace
--ask-for-approval	ควบคุมจังหวะการขออนุมัติ (untrusted | on-request | never)
--cd PATH	กำหนดไดเรกทอรีทำงานก่อนประมวลผล request
--config KEY=VALUE	Override ค่า configuration
--dangerously-bypass-approvals-and-sandbox	รันโดยไม่มีการอนุมัติ (ใช้เฉพาะใน hardened environment เท่านั้น)
--image PATH	แนบไฟล์ภาพกับ initial prompt
--model STRING	Override model ที่ตั้งค่าไว้
--sandbox	เลือก sandbox policy (read-only | workspace-write | danger-full-access)
--search	เปิดใช้ live web search แทน cached results

Primary Commands

คำสั่ง	สถานะ	จุดประสงค์
codex	Stable	เปิด interactive terminal UI
codex exec	Stable	รันแบบ non-interactive; alias คือ codex e
codex resume	Stable	ต่อ interactive session ก่อนหน้า
codex fork	Stable	แตก session เป็น thread ใหม่
codex apply	Stable	Apply diff จาก Codex Cloud task ในเครื่อง
codex login	Stable	Authenticate ผ่าน OAuth, API key, หรือ token
codex doctor	Stable	สร้างรายงาน diagnostics

คำสั่งพิเศษ

codex app-server (Experimental)

เปิด local app server พร้อม options สำหรับ stdio, WebSocket หรือ Unix socket transport รองรับ authentication modes เช่น capability tokens และ signed bearer tokens

codex exec

Non-interactive execution พร้อม options ที่สำคัญ:

• --output-last-message PATH: เขียน response สุดท้ายลงไฟล์
• --json: Output แบบ newline-delimited JSON events
• --ephemeral: ไม่บันทึก session files
• resume subcommand: ต่อ task ก่อนหน้า

codex cloud (Experimental)

โต้ตอบกับ Codex Cloud tasks มี subcommands คือ exec และ list

codex sandbox

รันคำสั่งภายใต้ internal sandbox policy ของ Codex (macOS Seatbelt, Linux Landlock หรือ Windows native)

codex plugin (Experimental)

จัดการ plugins พร้อม marketplace support มี subcommands คือ add, list และ remove

codex mcp (Experimental)

จัดการ Model Context Protocol servers รองรับ stdio และ streamable HTTP transport

คำแนะนำด้านความปลอดภัย

• ใช้ --sandbox workspace-write สำหรับงาน local แบบ unattended
• หลีกเลี่ยง --dangerously-bypass-approvals-and-sandbox ยกเว้นใน sandbox VM ที่แยกออกมาโดยเฉพาะ
• ใช้ --add-dir แทนการบังคับ full access เมื่อต้องการให้สิทธิ์ไดเรกทอรี
• รวม --json กับ --output-last-message ใน CI pipeline เพื่อ output ที่มีโครงสร้าง

ลำดับความสำคัญของ Configuration

Command-line overrides มีความสำคัญสูงสุด ตามด้วย profile-specific config แล้วจึงเป็น base user configuration

Flag --strict-config จะ error เมื่อพบ configuration fields ที่ไม่รู้จัก