Tài liệu tham khảo toàn diện về các lệnh Codex

Bạn đã cài đặt Codex, gõ lệnh codex vào terminal và tự hỏi: "Rồi sao nữa?"

Nhiều người cũng từng như vậy. Agent lập trình của OpenAI phát triển rất nhanh. Các lệnh dành cho phiên làm việc, plugin, Cloud và điều khiển từ xa liên tục được bổ sung hoặc thay đổi. Nếu không có tài liệu tham khảo cập nhật, bạn sẽ rất dễ bị "lạc hậu" về thông tin.

Bài viết này tổng hợp toàn bộ các lệnh của Codex tại một nơi duy nhất: Từ lệnh CLI, lệnh slash, các flag cho đến phím tắt dành cho cả CLI và ứng dụng. Đây là tài liệu tham khảo về Codex chi tiết nhất mà bạn có thể tìm thấy. Nếu bạn muốn so sánh trực tiếp Codex với Claude Code, Quantrimang.com cũng có bài viết chuyên sâu so sánh Claude Code và OpenAI Codex để đáp ứng nhu cầu đó.

Cài đặt và khởi động Codex

Codex CLI được cài đặt thông qua npm hoặc Homebrew. Trong lần khởi động đầu tiên, Codex sẽ yêu cầu bạn đăng nhập bằng tài khoản ChatGPT hoặc API key.

Cài đặt

# Cài đặt qua npm
npm install -g @openai/codex

# Hoặc qua Homebrew
brew install --cask codex

Xác thực

# Đăng nhập tương tác (mở trình duyệt để thực hiện OAuth)
codex login

# Đăng nhập bằng API key
echo $OPENAI_API_KEY | codex login --with-api-key

# Kiểm tra trạng thái đăng nhập
codex login status

# Đăng xuất
codex logout

Khởi động Codex

# Bắt đầu phiên TUI tương tác
codex

# Khởi động với một câu lệnh (prompt) ban đầu
codex "Explain the architecture of this project"

# Chạy ở chế độ không tương tác (dành cho script)
codex exec -s workspace-write -m gpt-5.6-terra "Refactor auth.ts"

# Khởi chạy ứng dụng desktop
codex app

Mẹo: Luôn khởi động Codex bên trong thư mục dự án phù hợp. Bạn cũng có thể chỉ định thư mục làm việc bằng tham số --cd /path/to/project.

Tổng quan các lệnh CLI

Codex có hai phiên bản. CLI chạy trong terminal của bạn. App là ứng dụng desktop dành cho macOS và Windows. Cột "Ví dụ" hiển thị cách sử dụng phổ biến của từng lệnh.

codex exec: Các flag cho chế độ thực thi không tương tác

codex exec là công cụ chủ lực cho các quy trình làm việc tự động. Hãy thiết lập cẩn thận môi trường sandbox và chính sách phê duyệt để đảm bảo quá trình thực thi theo script diễn ra ổn định, dễ dự đoán và phạm vi truy cập được xác định rõ ràng.

Mô hình khuyến nghị cho chế độ thực thi không tương tác

# Mô hình chuẩn cho thực thi tự động
codex -a never exec -s workspace-write -m gpt-5.6-terra "your prompt"

# Độ sâu suy luận tối đa
codex -a on-request exec -s workspace-write -m gpt-5.6-sol \
-c model_reasoning_effort='"xhigh"' "complex task"

# Chế độ chỉ đọc để phân tích (không thay đổi file)
codex exec -s read-only -m gpt-5.6-luna "Analyze the architecture"

Các mẫu sử dụng phổ biến

Ví dụ về lệnh codex exec

# Đính kèm hình ảnh (ảnh chụp màn hình, thông số thiết kế)
codex exec -s workspace-write -m gpt-5.6-terra -i screenshot.png "Implement this UI"

# Nhiều thư mục có quyền ghi
codex exec -s workspace-write -C apps/frontend --add-dir ../backend "Sync API types"

# Đầu ra dạng JSON cho script
codex exec -s workspace-write --json "List all TODO comments"

# Lưu kết quả vào file
codex exec -s workspace-write -o /tmp/result.txt "Summarize this codebase"

# Đầu ra có cấu trúc theo JSON Schema
codex exec -s workspace-write --output-schema schema.json "Extract all API endpoints"

# Chuyển nội dung prompt qua stdin
cat prompt.txt | codex exec -s workspace-write -

# Sử dụng profile cấu hình 
codex exec -s workspace-write -p thorough "Thorough analysis"

# Mô hình mã nguồn mở cục bộ (Ollama hoặc LM Studio)
codex exec --oss --local-provider ollama -s workspace-write "Explain this function"

# Kiểm tra nghiêm ngặt cấu hình trước khi chạy tự động
codex exec --strict-config -s workspace-write "Check the configuration"

Đánh giá code

Lệnh codex review phân tích các thay đổi trong code mà không cần tương tác và xuất kết quả ra stdout. Lệnh này không sửa đổi các file.

Ví dụ về đánh giá code

# Xem xét các thay đổi chưa được commit (đã thực hiện + chưa thực hiện + chưa được theo dõi)
codex review --uncommitted

# Xem xét thay đổi so với một nhánh (trước khi mở PR)
codex review --base main

# Xem xét một commit cụ thể
codex review --commit abc123

# Xem xét một commit kèm tiêu đề
codex review --commit abc123 --title "Add auth"

# Xem xét với trọng tâm tùy chỉnh
codex review "Focus on security"

# Xem xét qua lệnh exec với đầu ra JSON
codex exec review --uncommitted --json

Quản lý phiên làm việc

Codex lưu trữ các phiên làm việc (không phải dạng tạm thời) tại máy cục bộ. Bạn có thể tiếp tục, phân nhánh (fork), lưu trữ (archive) hoặc truy xuất chúng mà không cần tương tác trực tiếp.

Tiếp tục phiên làm việc

# Tương tác: mở trình chọn phiên làm việc
codex resume

# Tương tác: tiếp tục trực tiếp phiên làm việc gần đây nhất
codex resume --last

# Không tương tác: tiếp tục phiên làm việc mới nhất với một yêu cầu (prompt) mới
codex exec resume --last -s workspace-write -m gpt-5.6-terra \
  "Now add error handling"

# Tiếp tục một phiên làm việc cụ thể theo UUID
codex exec resume 7f9f9a2e-1b3c-4c7a... -s workspace-write -m gpt-5.6-terra \
  "Implement the plan"

# Tạo nhánh phiên làm việc (tạo luồng mới từ ngữ cảnh hiện có)
codex fork --last

# Lưu trữ hoặc khôi phục phiên làm việc
codex archive SESSION
codex unarchive SESSION

# Xóa vĩnh viễn phiên làm việc
codex delete SESSION

Áp dụng các thay đổi

# Áp dụng thay đổi từ phiên làm việc cục bộ
codex apply TASK_ID

# Áp dụng thay đổi từ tác vụ trên đám mây 
codex cloud apply TASK_ID

# Áp dụng một lần thử cụ thể (khi sử dụng tùy chọn --attempts N)
codex cloud apply TASK_ID --attempt 2