Codex CLI là gì: agent lập trình mã nguồn mở của OpenAI

Thử hình dung anh chị thuê người giúp việc theo giờ lần đầu. Chẳng ai giao ngay chùm chìa khóa cả nhà. Buổi đầu chỉ cho xem qua các phòng, tuần sau cho dọn dẹp, quen tay rồi mới để tự làm khi chủ vắng nhà.

Giao việc cho AI lập trình cũng nên như vậy. Codex CLI của OpenAI làm sẵn đúng ba nấc tin tưởng đó.

Codex CLI là agent lập trình chạy trong terminal của OpenAI, dùng để đọc mã nguồn, sửa file và chạy lệnh ngay trên máy anh chị bằng câu lệnh tiếng thường. OpenAI công bố công cụ này ngày 16/04/2025, cùng ngày ra mắt hai model o3 và o4-mini, và mở toàn bộ mã nguồn trên GitHub theo giấy phép Apache 2.0.

Đọc nhanh trong 30 giây

• Codex CLI là agent lập trình mã nguồn mở (Apache 2.0) của OpenAI, chạy trong terminal, ra mắt 16/04/2025.
• Nó đọc code, sửa file, chạy lệnh, với ba chế độ phê duyệt từ "chỉ gợi ý" tới "tự làm hết trong sandbox".
• Cài bằng npm install -g @openai/codex, cần Node.js 22 trở lên và khóa OpenAI API.
• Hợp với đội phát triển đã dùng OpenAI API và có thói quen dùng Git.

Codex CLI là gì, dùng vào việc gì?

Codex CLI là một chương trình dòng lệnh: anh chị mở terminal trong thư mục dự án, gõ codex rồi giao việc như nói với đồng nghiệp ngồi cạnh. Agent đọc code, đề xuất thay đổi, chạy lệnh kiểm tra, và chỉ ghi vào thư mục làm việc khi anh chị cho phép. README gọi cách làm này là "chat-driven development": lập trình bằng hội thoại, nhưng agent chạy được code thật.

Ba điểm OpenAI nhấn mạnh trong README:

• Không cần dựng gì thêm: chỉ cần khóa OpenAI API là chạy.
• Tự động mà vẫn an toàn: ở chế độ tự động hoàn toàn, lệnh chạy trong sandbox bị chặn mạng và chỉ được đụng vào thư mục hiện tại.
• Đa phương thức: có thể đưa ảnh chụp màn hình hoặc sơ đồ để agent làm theo.

Bảng ví dụ trong README gồm: viết unit test rồi chạy tới khi qua, sinh file migration, đổi tên hàng loạt file bằng git mv, rà lỗ hổng bảo mật và viết báo cáo.

Ba nấc tin tưởng: chọn chế độ phê duyệt nào?

Codex CLI cho anh chị chọn mức tự chủ của agent bằng cờ --approval-mode.

Ba nấc giao chìa khóa: càng lên cao, agent càng tự làm nhiều, sandbox càng quan trọng.

Ở chế độ Full Auto, mỗi lệnh chạy với mạng bị tắt và chỉ được làm việc trong thư mục hiện tại cùng file tạm. Codex còn cảnh báo nếu anh chị bật Auto Edit hoặc Full Auto trong thư mục chưa quản lý bằng Git, để luôn có đường lùi.

Sandbox giống phòng thí nghiệm có vách kính: agent thao tác thoải mái bên trong, nhưng không mở được cửa ra ngoài. Cơ chế này khác nhau theo hệ điều hành:

• macOS 12 trở lên: lệnh được bọc bằng Apple Seatbelt (sandbox-exec), mọi thứ chỉ đọc trừ thư mục dự án, thư mục tạm, ~/.codex, và chặn kết nối ra ngoài.
• Linux: OpenAI khuyên chạy trong container Docker, tường lửa chặn mọi kết nối ra ngoài trừ OpenAI API.

Lưu ý

Sandbox chặn lệnh kết nối ra ngoài, nhưng nội dung file agent đọc vẫn được gửi tới OpenAI API để model xử lý. Code chứa thông tin khách hàng thì cần xem lại chính sách dữ liệu API của OpenAI trước.

Cài Codex CLI trong 5 phút

Yêu cầu theo README tại thời điểm ra mắt: macOS 12 trở lên, Ubuntu 20.04 trở lên hoặc Debian 10 trở lên, Windows 11 thì phải qua WSL2. Node.js bản 22 trở lên, RAM tối thiểu 4 GB, khuyên dùng 8 GB. Git 2.23 trở lên là tùy chọn nhưng nên có.

Ba lệnh là có agent trong terminal, cấu hình nằm trong thư mục ~/.codex/.

1. Cài toàn cục bằng npm:

npm install -g @openai/codex

README nhắc không chạy sudo npm install -g, nếu lỗi quyền thì sửa quyền của npm.

2. Đặt khóa OpenAI API cho phiên terminal hiện tại:

export OPENAI_API_KEY="your-api-key-here"

Muốn giữ lâu dài thì thêm dòng export này vào file cấu hình shell, ví dụ ~/.zshrc.

3. Chạy chế độ hội thoại bằng codex, hoặc giao việc ngay từ câu lệnh:

codex "explain this codebase to me"

4. Cấu hình nằm trong thư mục ~/.codex/. Model mặc định là o4-mini, đổi sang model khác bằng cờ --model hoặc trong file config.yaml:

# ~/.codex/config.yaml
model: o4-mini
fullAutoErrorMode: ask-user

Thử ngay với hai việc thật

Việc 1: nhân viên mới làm quen dự án cũ. Thay vì ngồi đọc hàng trăm file, anh chị mở terminal ở thư mục dự án và gõ:

codex "Giải thích cấu trúc dự án này: thư mục nào chứa giao diện, thư mục nào gọi API, file cấu hình nằm đâu"

Ở chế độ Suggest mặc định, agent chỉ đọc, không sửa gì. Đây là cách an toàn để thử công cụ trên code thật của công ty.

Việc 2: ghi nội quy chung cho cả nhóm. Codex gộp hướng dẫn từ ba nơi theo thứ tự: ~/.codex/instructions.md cho thói quen cá nhân, codex.md ở gốc repo cho luật chung của dự án, codex.md trong thư mục con cho phần riêng. Giống bảng nội quy dán ở cửa từng phòng: luật chung của cả nhà, thêm vài dòng riêng cho phòng bếp.

Mẹo

Viết vào codex.md những điều như "comment bằng tiếng Việt", "không sửa file trong thư mục migrations cũ", rồi commit vào repo. Ai trong nhóm chạy Codex cũng theo cùng một luật, không cần nhắc miệng.

Codex CLI khác gì Claude Code?

Codex CLI khác Claude Code ở hai điểm chính: mã nguồn mở hoàn toàn và chạy bằng model của OpenAI. Claude Code của Anthropic ra bản research preview ngày 24/02/2025, cùng là agent trong terminal, nhưng gói npm ghi giấy phép riêng của Anthropic chứ không phải giấy phép mã nguồn mở.

Hai agent cùng sống trong terminal, khác nhau ở giấy phép và model phía sau.

Anh chị muốn đọc kỹ về Claude Code có thể xem bài Claude Code là gì: agent lập trình trong terminal.

Những điều cần biết trước khi dùng

• Chi phí API: Codex CLI miễn phí, nhưng mỗi lần agent suy nghĩ là tốn token trên tài khoản OpenAI API của anh chị. Nên đặt hạn mức chi tiêu trên trang quản lý API trước khi cho cả nhóm dùng.
• Windows: chưa chạy trực tiếp, phải cài WSL2.
• Dự án còn rất mới: README ghi rõ code sẽ còn thay đổi nhiều. Đừng dựng quy trình sản xuất phụ thuộc chặt vào từng cờ lệnh lúc này.

Nhận xét của chuyên gia

Tôi đánh giá cao việc OpenAI mở mã nguồn và thiết kế ba mức phê duyệt rõ ràng. Với doanh nghiệp, câu hỏi đầu tiên khi đưa agent lập trình vào là nó được phép làm gì trên máy nhân viên. Codex CLI trả lời bằng một bảng ba dòng, đủ để trưởng nhóm viết quy định nội bộ.

Hợp với ai: đội phát triển nhỏ đã dùng OpenAI API, cần agent làm việc lặt vặt như viết test, đổi tên, giải thích code cũ; công ty muốn tự đọc mã nguồn agent trước khi cho chạy trên máy nội bộ.

Chưa hợp với ai: văn phòng dùng Windows thuần không có ai cài được WSL2; nhóm không có thói quen dùng Git, vì mất đường lùi khi agent sửa sai; doanh nghiệp chưa có quy định về việc gửi mã nguồn ra dịch vụ AI bên ngoài.

Cách bắt đầu của tôi: tuần đầu chỉ dùng chế độ Suggest trên một repo không nhạy cảm, mỗi người giao 5 việc nhỏ và ghi lại việc nào agent làm tốt. Sau đó mới viết codex.md cho dự án và cân nhắc Auto Edit. Full Auto để dành cho việc lặp đi lặp lại đã có test kiểm tra.

Một câu để nhớ: giao chìa khóa cho agent cũng như giao cho người mới, từng nấc một, và luôn giữ Git làm chìa dự phòng.

Câu hỏi thường gặp

Codex CLI có miễn phí không?

Công cụ miễn phí và mở mã nguồn theo Apache 2.0. Anh chị trả tiền cho lượng token dùng qua OpenAI API của mình.

Codex CLI có chạy trên Windows không?

Chưa chạy trực tiếp. Anh chị cần cài Windows Subsystem for Linux (WSL2), OpenAI mới thử nghiệm trên macOS và Linux với Node.js 22 trở lên.

Làm sao để Codex CLI không tự sửa code?

Giữ chế độ Suggest mặc định. Mọi thao tác ghi file và chạy lệnh đều phải được anh chị đồng ý, trả lời "n" là không có gì thay đổi.

Xem thêm các mốc khác trong chuỗi dòng thời gian AI.

Nguồn: openai/codex trên GitHub, 16/04/2025.