Bắt Đầu

Cài Đặt

npm install -g @openai/codex

Xác Thực

export OPENAI_API_KEY="sk-..."

Đặt trong shell profile hoặc file .env

Chạy Lần Đầu

codex "explain this project"
codex "add input validation to app.py"

Lệnh

Tương Tác (Mặc Định)

codex                       # bắt đầu phiên tương tác
codex "fix the login bug"   # với prompt ban đầu

codex exec

codex exec "write unit tests for utils.py"
codex exec "refactor db.py to use async"

Không tương tác — chạy tác vụ đến hoàn thành

codex review

codex review                # review thay đổi đã staged
codex review --diff HEAD~3  # review 3 commit cuối

Chế Độ

Chế Độ Phê Duyệt

suggest	Hiển thị thay đổi đề xuất, yêu cầu phê duyệt cho mỗi lần sửa file và lệnh
auto-edit	Tự động áp dụng chỉnh sửa file, yêu cầu phê duyệt cho lệnh shell
full-auto	Áp dụng chỉnh sửa và chạy lệnh không cần phê duyệt

Đặt Chế Độ

codex --approval-mode suggest "add tests"
codex --approval-mode auto-edit "refactor"
codex --approval-mode full-auto "fix lint"

Cấu Hình

File Cấu Hình

# ~/.codex/config.yaml
model: o4-mini
approval_mode: suggest
providers:
  - name: openai
    api_key_env: OPENAI_API_KEY

Ghi đè theo dự án: .codex/config.yaml trong thư mục gốc

Hướng Dẫn Dự Án

# AGENTS.md (trong thư mục gốc dự án)
- Run tests with: uv run pytest
- Use ruff for linting
- Never modify migration files

Tùy Chọn Cấu Hình Hữu Ích

model	Model sử dụng (vd: `o4-mini`, `o3`)
approval_mode	Chế độ phê duyệt mặc định
providers	Cấu hình nhà cung cấp API (key, base URL)
history	Lưu lịch sử hội thoại: `true` / `false`

Sandboxing

Cách Hoạt Động

Codex chạy lệnh trong môi trường sandbox để ngăn tác dụng phụ không mong muốn. Truy cập mạng bị tắt mặc định. Ghi file bị giới hạn trong thư mục dự án.

Tùy Chọn Sandbox

macOS	Apple Seatbelt (mặc định, tích hợp sẵn)
Linux	Sandbox dựa trên Docker
--full-auto	Yêu cầu sandbox phải được bật
--dangerously-auto-approve	Bỏ qua sandbox (không khuyến nghị)

Mẹo

Prompt Hiệu Quả

Cụ thể	"add retry logic to fetch_data()" > "improve code"
Tham chiếu file	"fix the bug in src/auth.py" thu hẹp phạm vi
Nêu ràng buộc	"don't change the public API" đặt ranh giới
Lặp lại	Tiếp tục tinh chỉnh trong cùng phiên

Quy Trình Làm Việc

# Khám phá → lập kế hoạch → thực thi
codex "explain the auth module"
codex "plan how to add OAuth support"
codex --approval-mode auto-edit "add OAuth"

# Review trước khi commit
git add -A
codex review

Flag Thường Dùng

--model, -m	Ghi đè model cho phiên này
--approval-mode	Đặt chế độ phê duyệt
--quiet, -q	Đầu ra tối thiểu
--no-project-doc	Bỏ qua AGENTS.md

OPENAI CODEX CLI THAM KHẢO NHANH