Codex CLI Cheat Sheet: Toàn Bộ Lệnh & Config (2026)
codex mở phiên tương tác, codex exec chạy headless cho CI, gõ / trong phiên để xem toàn bộ slash command, và codex --help hoặc ? hiện đủ lệnh cho đúng bản bạn đang cài. Đây là trang tra cứu dạng bảng: lệnh cấp cao nhất, flag toàn cục, slash command theo nhóm, các khóa config.toml quan trọng nhất, cách nối MCP, chế độ sandbox/phê duyệt, và danh sách phím tắt thật (ngắn) chứ không thổi phồng.
- Codex CLI ra bản mới gần như hàng tháng nên danh sách lệnh có thể đổi; mọi thứ dưới đây đã đối chiếu tài liệu chính thức tại thời điểm viết - hãy chạy codex --help, / hoặc ? trên bản cài của bạn trước khi phụ thuộc vào một tên flag cụ thể.
Bài này gồm những gì?
Bài chỉ nói về Codex CLI - công cụ terminal chạy bằng lệnh codex. Không bao gồm ứng dụng desktop ChatGPT hay extension IDE (VS Code/JetBrains) - hai thứ này có bộ phím tắt khác, và một số bài trên mạng gộp cả ba lại khiến phần "phím tắt" của họ dễ gây hiểu lầm. Nếu bạn mới bắt đầu với Codex, đọc OpenAI Codex là gì trước.
Một điểm cần nói rõ vì tên gọi rất dễ trùng: OpenAI Codex (chính là CLI này) không phải AgentKit (agentkit.best, bộ kit trả phí của bên thứ ba chạy bên trong Codex), và cũng không phải AgentKit của chính OpenAI (sản phẩm Agent Builder riêng biệt). Bài này nói về CLI miễn phí; AgentKit chỉ được nhắc một lần trung thực ở gần cuối.
Cài đặt & đăng nhập - lệnh nhanh
Codex CLI mã nguồn mở (Rust), cài bằng một script duy nhất trên macOS, Linux hoặc Windows.
| Lệnh | Tác dụng |
|---|---|
curl -fsSL https://chatgpt.com/codex/install.sh | sh | Cài CLI (mac/Linux; trên Windows chạy được qua WSL/Git Bash). |
codex login | Đăng nhập tài khoản ChatGPT qua trình duyệt. |
codex login --device-auth | Đăng nhập bằng mã thiết bị, dùng cho máy không có trình duyệt (SSH, container). Chưa đối chiếu độc lập với trang tài liệu gốc trong phiên nghiên cứu này - kiểm tra lại codex login --help trước khi dùng đúng cú pháp flag. |
codex logout | Đăng xuất, xóa token đăng nhập cục bộ. |
Muốn xem hướng dẫn cài đặt đầy đủ mọi hệ điều hành, đọc cách cài Codex CLI.
Lệnh cấp cao nhất (top-level)
Đây là các lệnh gõ trực tiếp ngay sau codex.
| Lệnh | Tác dụng | Ví dụ |
|---|---|---|
codex | Mở phiên tương tác trong thư mục dự án hiện tại. | codex |
codex exec | Chạy một prompt headless, không TUI - dùng cho script và CI. | codex exec "thêm route health-check" |
codex resume | Mở lại một phiên trước đó. | codex resume |
codex login | Đăng nhập tài khoản ChatGPT. | codex login |
codex mcp | Quản lý kết nối MCP server. | codex mcp add docs -- npx -y mcp-server-docs |
codex cloud | Mở/quản lý các tác vụ chạy trên Codex Cloud. | codex cloud |
codex apply | Áp diff từ một task Codex Cloud vào checkout cục bộ. | codex apply <task-id> |
codex doctor | Kiểm tra sức khỏe cài đặt/config. Theo một nguồn bên thứ ba, thêm khoảng v0.131.0 - không phải tài liệu chính, hãy xác nhận lệnh có tồn tại bằng codex --help. | codex doctor |
codex features enable <flag> | Bật một tính năng đang ở dạng feature-flag (ví dụ goal mode). | codex features enable goals |
Flag toàn cục (dùng được với hầu hết lệnh)
| Flag | Tác dụng |
|---|---|
-m, --model | Ghi đè model cho lần chạy này. |
-s, --sandbox | Đặt chế độ sandbox (xem bảng ma trận bên dưới). |
-a, --ask-for-approval | Đặt chính sách phê duyệt cho lần chạy này. |
-p, --profile | Nạp một profile được đặt tên trong config.toml. |
-c, --config key=value | Ghi đè một khóa config ngay trên dòng lệnh, không cần sửa file. |
-i, --image | Đính kèm ảnh vào prompt. |
--search | Bật công cụ tìm kiếm web trực tiếp cho lần chạy này. |
-C, --cd | Chạy trên một thư mục làm việc khác. |
--add-dir | Cấp quyền đọc/ghi thêm một thư mục ngoài project root. |
--oss | Chạy trên model open-weight cục bộ thay vì model hosted. |
--local-provider | Trỏ Codex tới một model provider tự host/local. |
codex exec cho CI/CD
codex exec là cửa vào headless cho pipeline. Ví dụ gọi trong CI:
codex exec --json --sandbox workspace-write --ephemeral \
--skip-git-repo-check \
"Sửa test đang fail trong tests/auth.spec.ts và tóm tắt thay đổi"| Flag | Tác dụng |
|---|---|
--json | Xuất sự kiện dạng JSON có cấu trúc thay vì output TUI. |
-o, --output-last-message | Chỉ ghi tin nhắn cuối cùng ra file - dễ lấy trong một bước pipeline. |
--output-schema | Buộc tin nhắn cuối phải khớp một JSON schema bạn cung cấp. |
--ephemeral | Không lưu lại session/history sau khi chạy xong. |
--skip-git-repo-check | Vẫn chạy được dù thư mục làm việc không nằm trong git repo. |
--ignore-rules | Bỏ qua các rule/lint check thường lệ của dự án cho lần chạy này. |
Flag nguy hiểm - chỉ dùng trên CI runner cô lập:
--dangerously-bypass-approvals-and-sandbox(bí danh--yolo) và--dangerously-bypass-hook-trustgỡ bỏ hoàn toàn sandbox và bước phê duyệt. Đừng bao giờ chạy hai flag này trên máy có credential thật hoặc quyền vào production - chỉ dùng trong container CI dùng-một-lần, cô lập.
Slash command (theo nhóm)
Gõ / trong phiên để xem danh sách trực tiếp theo đúng bản bạn đang dùng - bảng dưới gom nhóm những lệnh phổ biến. Năm lệnh dùng nhiều nhất hàng ngày: /review, /goal, /permissions, /compact và /mcp.
| Lệnh | Nhóm | Tác dụng |
|---|---|---|
/clear | Session & context | Bắt đầu context mới, giữ nguyên session. |
/compact | Session & context | Nén context thủ công để giải phóng chỗ trống. |
/new | Session & context | Mở một session hoàn toàn mới. |
/resume | Session & context | Mở lại một session trước đó ngay trong TUI. |
/rename | Session & context | Đổi tên session hiện tại. |
/archive | Session & context | Lưu trữ session hiện tại. |
/delete | Session & context | Xóa một session. |
/diff | Session & context | Hiện diff đang thay đổi. |
/copy | Session & context | Copy phản hồi gần nhất vào clipboard. |
/status | Session & context | Hiện trạng thái session và usage. |
/model | Model, quyền & personality | Đổi model đang dùng. |
/permissions | Model, quyền & personality | Xem/sửa chính sách sandbox & phê duyệt ngay trong lúc chạy. |
/personality | Model, quyền & personality | Đổi giọng điệu/phong cách phản hồi. |
/sandbox-add-read-dir | Model, quyền & personality | Cấp quyền đọc thêm một thư mục cho session này. |
/review | Review & goals | Chạy một preset code review (diff, uncommitted, một commit, hoặc tùy chỉnh). |
/goal | Review & goals | Bật goal mode - vòng lặp thực thi kéo dài, kiên trì. |
/plan | Review & goals | Soạn một plan trước khi Codex bắt đầu thực thi. |
/mcp | Extend | Quản lý kết nối MCP server ngay trong session. |
/skills | Extend | Xem/quản lý skill đã cài. |
/hooks | Extend | Xem các hook đã cấu hình. |
/apps | Extend | Quản lý app/tích hợp đã kết nối. |
/plugins | Extend | Quản lý cài đặt từ plugin marketplace. Cú pháp mới, nguồn từ bên thứ ba - coi là chưa ổn định, kiểm tra live. |
/agent | Extend | Điều phối một subagent cho một tác vụ con trong phạm vi hẹp. |
/import | Extend | Nhập context từ một file hoặc URL. |
/keymap | Giao diện & tiện ích | Đổi lại phím tắt. |
/vim | Giao diện & tiện ích | Bật/tắt keybinding kiểu vim khi gõ. |
/theme | Giao diện & tiện ích | Đổi theme màu. |
/ide | Giao diện & tiện ích | Các lệnh tích hợp IDE. |
/raw | Giao diện & tiện ích | Gửi input thô, bỏ qua parsing thông thường. |
/experimental | Giao diện & tiện ích | Bật/tắt hành vi thử nghiệm/feature-flag (gồm cả goal mode). |
/debug-config | Giao diện & tiện ích | In ra config đã gộp đầy đủ (effective config). |
/feedback | Giao diện & tiện ích | Gửi phản hồi cho OpenAI. |
/exit | Giao diện & tiện ích | Thoát Codex. |
Các khóa config.toml quan trọng
Codex đọc config từ ~/.codex/config.toml theo mặc định. Bốn khóa quan trọng nhất hàng ngày:
| Khóa | Giá trị | Tác dụng |
|---|---|---|
model | ví dụ gpt-5.6-terra | Model mặc định cho session mới. |
sandbox_mode | read-only / workspace-write (mặc định) / danger-full-access | Mức truy cập filesystem/network mặc định. |
approval_policy | untrusted / on-request / never | Khi nào Codex phải dừng lại hỏi trước khi hành động. |
project_doc_max_bytes | số nguyên, mặc định 32768 (32 KiB) | Giới hạn tổng dung lượng AGENTS.md - vượt ngưỡng bị cắt âm thầm. |
project_doc_fallback_filenames | danh sách tên file | File thay thế Codex đọc nếu không thấy AGENTS.md. |
web_search | true/false | Cho phép công cụ tìm kiếm web trực tiếp. |
model_reasoning_effort | low/medium/high | Mức độ đầu tư suy luận cho mỗi request. |
[features] | bảng các flag | Khối feature-flag, ví dụ goals = true để bật goal mode. |
Thứ tự ưu tiên: flag dòng lệnh > config của project > profile > config người dùng. Một flag -c key=value luôn thắng; config.toml ở cấp project thắng bản cá nhân của bạn. Muốn xem đầy đủ quy tắc gộp AGENTS.md (và giới hạn 32 KiB chi tiết hơn), đọc AGENTS.md cho Codex.
MCP - nối một server bằng một lệnh
Thêm server từ CLI:
codex mcp add docs --env API_KEY=$DOCS_KEY -- npx -y mcp-server-docsLệnh trên ghi đúng khối cấu hình sau vào ~/.codex/config.toml:
[mcp_servers.docs]
command = "npx"
args = ["-y", "mcp-server-docs"]
env = { API_KEY = "..." }Codex chỉ đóng vai trò MCP client - nó kết nối tới server, không tự expose một server nào. Xem hướng dẫn đầy đủ tại kết nối MCP server đầu tiên cho Codex.
Sandbox & phê duyệt - ma trận nhanh
| sandbox_mode ↓ / approval_policy → | untrusted | on-request | never |
|---|---|---|---|
| read-only | Hỏi trước gần như mọi thao tác. | Chỉ hỏi với đọc rủi ro. | Không hỏi; chỉ đọc được. |
| workspace-write (mặc định) | Hỏi trước khi ghi ra ngoài sandbox. | Chỉ hỏi khi cần vượt ra ngoài workspace. | Ghi tự do trong workspace, không hỏi. |
| danger-full-access | Hỏi trước hành động phá hủy/cấp hệ thống. | Hiếm khi hỏi, chủ yếu hành động không thể hoàn tác. | Toàn quyền, không hỏi gì cả - cẩn trọng thật sự khi dùng. |
Muốn biết mỗi chế độ thực sự cho phép làm gì, đọc chế độ sandbox & phê duyệt của Codex.
Phím tắt (danh sách ngắn, trung thực)
Codex CLI dựa vào slash command chứ không phải phím tắt - danh sách phím tắt thật của riêng CLI rất ngắn. Nếu một trang nào đó liệt kê hơn chục "phím tắt Codex", nhiều khả năng họ đang trộn cả app desktop hoặc extension IDE vào.
| Phím | Tác dụng |
|---|---|
Ctrl+C | Hủy lượt hiện tại. |
Ctrl+D | Thoát Codex. |
Ctrl+J | Chèn dòng mới trong ô nhập. |
Ctrl+L | Xóa màn hình. |
Ctrl+R | Tìm ngược trong history. Giới hạn theo phiên bản (khoảng v0.121.0+ theo nguồn bên thứ ba) - kiểm tra lại trên bản cài của bạn. |
Esc | Ngắt lượt hiện tại. |
Esc Esc | Undo hành động vừa rồi. |
Tab | Xếp hàng một tin nhắn tiếp theo trong khi Codex đang chạy. |
Enter | Gửi tin nhắn. |
Muốn đổi phím? Gõ /keymap để remap.
AGENTS.md & Skills - đọc sâu hơn ở đâu?
Codex đọc chỉ dẫn dự án từ AGENTS.md, không phải CLAUDE.md - xem đầy đủ quy tắc gộp/override tại AGENTS.md cho Codex. Workflow tái sử dụng, tương thích chéo nằm trong file SKILL.md - xem Codex Skills là gì.
Muốn thêm workflow dựng sẵn?
Bản thân Codex CLI miễn phí trong gói ChatGPT. Nếu không muốn tự ghép workflow, AgentKit thêm sẵn skill và workflow qua ak kit init engineer --target codex --global, rồi gõ $ak:cook trong session - đây là add-on trả phí, không phải một phần của Codex. Xem AgentKit →
Câu hỏi nhanh
Làm sao xem đủ lệnh cho đúng bản mình đang cài?
Chạy codex --help trong terminal, hoặc gõ / trong session để xem danh sách slash command trực tiếp.
Làm sao kiểm tra config thực sự đang được nạp?
Chạy /debug-config trong session - lệnh này in ra config đã gộp đầy đủ sau khi áp dụng thứ tự ưu tiên.
Codex lưu config ở đâu?
Trong thư mục CODEX_HOME, mặc định ~/.codex - chứa config.toml, auth.json và history.jsonl. Đổi biến môi trường này để dùng thư mục khác.
Cách cập nhật CLI?
Không có lệnh tự cập nhật nào được xác nhận độc lập trong phiên nghiên cứu này - cách an toàn nhất là chạy lại script cài đặt (curl -fsSL https://chatgpt.com/codex/install.sh | sh), rồi kiểm tra codex --version.
Kết luận
Cài đặt, gõ / để xem lệnh, xem ? hoặc codex --help để biết phím tắt, và lưu lại trang này - danh sách đổi khá thường xuyên nên đáng để kiểm tra lại mỗi lần bạn update. Mới bắt đầu với Codex? Đọc OpenAI Codex là gì, rồi cài đặt CLI.