Codex CLI và App: bắt đầu đúng trong 30 phút

English title: Codex CLI and App: Start the Right Way in 30 Minutes

Cập nhật: 29/06/2026. Đây là bài 1 trong chuỗi Codex Power 10 - 10 bài hướng dẫn dùng các năng lực mạnh của Codex theo cách có kiểm soát.

Sau bài này, bạn sẽ mở được Codex đúng repo, biết dùng CLI cho vòng làm nhanh, dùng App để quan sát diff/thread/worktree, và kết thúc một phiên bằng bằng chứng thay vì cảm giác.

Bảng Nhớ Nhanh

Dùng bài này khi: bạn đã quen Claude Code, Cursor hoặc Copilot và muốn mở Codex như một môi trường làm việc thật, không phải một khung chat.

Không dùng bài này khi: bạn đang cần benchmark model, thiết lập Cloud hoặc so sánh giá. Chuỗi này đi từ thao tác local trước.

Xong bài khi: bạn chạy được một phiên nhỏ có plan, có diff, có review và biết rủi ro còn lại.

Ghi nhớ: Bài thực hành này không cố làm bạn nhớ hết tính năng. Nó giúp bạn dựng một vòng làm việc có mục tiêu, có biên và có bằng chứng.

Trước Khi Bắt Đầu

• Mac đã cài Codex CLI và đăng nhập được.
• Một repo thật có Git, README và ít nhất một lệnh kiểm tra.
• Codex App nếu bạn muốn xem thread, terminal, worktree và diff trong giao diện desktop.
• 30 phút tập trung để chạy một task nhỏ từ đầu đến cuối.

Cẩn trọng: Nếu môi trường hoặc quyền đang mơ hồ, hãy dừng một nhịp để kiểm tra. Agent chạy nhanh trong bối cảnh sai sẽ tạo ra diff rất thuyết phục nhưng khó dùng.

Ý Tưởng Trong 3 Phút

Một người mới thường mở Codex rồi hỏi một câu giống hỏi chatbot. Cách đó hữu ích cho giải thích nhanh, nhưng bỏ phí gần hết năng lực: Codex có thể đọc repository, đề xuất kế hoạch, chỉnh file, chạy test, quan sát giao diện, tạo ảnh minh họa, và báo lại bằng bằng chứng.

Hãy xem Codex như một bàn làm việc có ba lớp: lớp hội thoại để chốt ý, lớp thực thi để đụng vào file và lệnh, lớp kiểm soát để xin quyền hoặc dừng khi rủi ro tăng.

• Chat vẫn quan trọng, nhưng chat chỉ là nơi điều phối. Giá trị thật đến từ việc Codex giữ ngữ cảnh, thao tác trên file, rồi tự kiểm chứng.
• Codex có nhiều bề mặt làm việc: trong ứng dụng, trong CLI, trong quy trình không tương tác, và trong các tích hợp với kho mã.
• Một phiên tốt luôn có mục tiêu, phạm vi, cổng dừng và định nghĩa xong việc. Thiếu bốn thứ này, agent dễ biến thành máy tạo thay đổi khó rà soát.

Công Thức 1: Chạy Quy Trình Chính

Khi dùng: bạn đã quen Claude Code, Cursor hoặc Copilot và muốn mở Codex như một môi trường làm việc thật, không phải một khung chat.

1. Mở bằng một yêu cầu có mục tiêu rõ: cần tạo, sửa, rà soát hay giải thích.
2. Cho Codex đọc đúng ngữ cảnh: file, log, ảnh chụp, lỗi build hoặc luật dự án.
3. Yêu cầu kế hoạch khi phạm vi lớn; với việc nhỏ, để Codex thực hiện thẳng và báo lại bằng diff/test.
4. Kết thúc bằng kiểm chứng: build, test, ảnh chụp giao diện hoặc danh sách điểm chưa chắc.

Công Thức 2: Đóng Cổng Kiểm Chứng

Một phiên tốt không cần lúc nào cũng dài. Điều cần giữ là nhịp: giao việc rõ, để Codex đọc đúng, cho nó thực hiện trong phạm vi nhỏ, rồi bắt nó tự chứng minh kết quả.

Prompt Mẫu

Goal: Chạy phiên Codex đầu tiên trên repo này và sửa một lỗi nhỏ có thể kiểm chứng.
Context: Đọc README, package.json và file liên quan trước khi sửa.
Constraints: Không đổi kiến trúc, không thêm dependency, không chạm file ngoài repo.
Done-when: Có plan ngắn, có diff nhỏ, có lệnh kiểm tra hoặc lý do chưa chạy được.

Ví Dụ Tối Thiểu: Phiên CLI/App tối thiểu

codex doctor
cd ~/code/my-repo
codex
codex app .

Khi Có Lỗi

Nếu gặp một trong các lỗi trên, cách sửa thường không phải là viết prompt dài hơn. Cách sửa là thêm đúng mảnh còn thiếu: một đường dẫn ngữ cảnh, một ràng buộc phạm vi, hoặc một tiêu chí nghiệm thu.

Quy Trình Trong Đội

Trong nhóm, bài này nên trở thành buổi nhập môn 30 phút: mỗi người chọn một việc nhỏ trong repo, giao cho Codex bằng cùng một khuôn prompt, rồi so sánh chất lượng kết quả.

Với đội mới bắt đầu, đừng đưa Codex vào khâu rủi ro nhất ngay. Hãy bắt đầu ở nơi có phản hồi nhanh: viết test, tạo bản nháp, rà link, chuẩn hóa tài liệu, tạo ảnh minh họa, hoặc chuẩn bị diff nhỏ để con người rà soát.

Bài Tập 30 Phút

1. Chọn một repo, bài viết hoặc màn hình thật để thực hành.
2. Viết một câu mục tiêu cho bài 1, tránh yêu cầu chung chung.
3. Liệt kê đúng ba nguồn context mà Codex nên đọc trước.
4. Ghi hai ràng buộc không được vượt.
5. Viết Done-when bằng bằng chứng có thể kiểm tra.
6. Chạy prompt trong Codex CLI hoặc Codex App.
7. Dừng sau plan đầu tiên và xem Codex có hiểu đúng không.
8. Cho Codex làm phần nhỏ nhất có thể.
9. Đóng gate: Repo, Plan, Diff, Review.
10. Ghi lại một điều nên đưa vào prompt hoặc AGENTS.md cho lần sau.

10 Điều Cần Nhớ

1. CLI nhanh nhất khi bạn đang ở đúng repo.
2. App mạnh khi cần nhìn thread, terminal, worktree và diff cùng lúc.
3. Một phiên tốt bắt đầu bằng mục tiêu, không bằng sự tò mò mơ hồ.
4. /plan hữu ích khi task nhiều bước hoặc dễ lan phạm vi.
5. @file và /mention giảm lượng đoán của agent.
6. Diff là bằng chứng đầu tiên, không phải lời hứa của agent.
7. /review giúp bắt lỗi trước khi bạn tin kết quả.
8. codex doctor nên chạy khi môi trường có dấu hiệu lạ.
9. Đừng mở quyền rộng khi bạn chưa biết task cần gì.
10. Bài đầu tiên chỉ cần một vòng nhỏ chạy trọn vẹn.

Nguồn tham khảo chính: OpenAI Codex documentation. Bài tiếp: Prompt contract: Goal, Context, Constraints, Done-when.