OpenAI Codex CLI - Tác nhân lập trình gọn nhẹ chạy trong terminal

• OpenAI Codex là một tác nhân lập trình gọn nhẹ chạy trong terminal, cho phép các nhà phát triển tận dụng khả năng suy luận cấp độ ChatGPT trong môi trường terminal cùng với thực thi mã, thao tác tệp và quản lý phiên bản
• Codex không cần cấu hình, và chạy an toàn nhờ vô hiệu hóa mạng và sandbox thư mục
• Hỗ trợ tính năng đa phương thức, cho phép triển khai tính năng từ ảnh chụp màn hình hoặc sơ đồ
• Codex là mã nguồn mở hoàn toàn, mang lại lợi thế để các nhà phát triển trực tiếp đóng góp và phát triển nó
• Có thể chạy trên nhiều hệ điều hành, hỗ trợ macOS, Linux, Windows WSL2

---

Giới thiệu OpenAI Codex

• OpenAI Codex là một tác nhân lập trình gọn nhẹ chạy trong terminal
• Các nhà phát triển có thể tận dụng khả năng suy luận cấp độ ChatGPT trong môi trường terminal cùng với thực thi mã, thao tác tệp và quản lý phiên bản
• Không cần cấu hình, và chạy an toàn nhờ vô hiệu hóa mạng cùng sandbox thư mục
• Hỗ trợ tính năng đa phương thức, cho phép triển khai tính năng từ ảnh chụp màn hình hoặc sơ đồ
• Là mã nguồn mở hoàn toàn, để các nhà phát triển trực tiếp đóng góp và phát triển

Mô hình bảo mật và quyền hạn của Codex

• Codex cung cấp cờ --approval-mode để quyết định mức độ tự chủ của tác nhân
• Ở chế độ Suggest, chỉ có thể đọc tệp; mọi thao tác ghi/patch tệp và lệnh shell đều cần phê duyệt
• Ở chế độ Auto Edit, có thể đọc tệp và ghi patch; lệnh shell cần phê duyệt
• Ở chế độ Full Auto, có thể đọc/ghi tệp và thực thi lệnh shell, với mạng bị vô hiệu hóa và bị giới hạn trong thư mục làm việc hiện tại

Chi tiết sandbox theo nền tảng

• Trên macOS 12+, sử dụng Apple Seatbelt để bọc lệnh
• Trên Linux, sử dụng Docker để chạy Codex trong một image container tối giản
• Cả hai cách tiếp cận đều hoạt động minh bạch trong sử dụng hằng ngày

Yêu cầu hệ thống

• Hệ điều hành: macOS 12+, Ubuntu 20.04+/Debian 10+, Windows 11 (WSL2)
• Node.js: 22 trở lên (khuyến nghị LTS)
• Git: 2.23+ (khuyến nghị cho tính năng trợ lý PR)
• RAM: tối thiểu 4GB (khuyến nghị 8GB)

Tham chiếu CLI

• codex: chạy REPL tương tác
• codex "…": prompt ban đầu cho REPL tương tác
• codex -q "…": chế độ "im lặng" không tương tác
• Các cờ chính: --model/-m, --approval-mode/-a, --quiet/-q

Bộ nhớ và tài liệu dự án

• Codex hợp nhất các hướng dẫn Markdown theo thứ tự sau: ~/.codex/instructions.md, codex.md (gốc repository), codex.md (thư mục làm việc hiện tại)
• Có thể vô hiệu hóa bằng --no-project-doc hoặc CODEX_DISABLE_PROJECT_DOC=1

Chế độ không tương tác / CI

• Có thể chạy Codex ở chế độ headless trong pipeline
• Có thể loại bỏ nhiễu từ UI tương tác bằng CODEX_QUIET_MODE=1

Công thức

• codex "Refactor the Dashboard component to React Hooks": refactor class component và chạy kiểm thử
• codex "Generate SQL migrations for adding a users table": suy luận ORM và tạo rồi chạy tệp migration
• codex "Write unit tests for utils/date.ts": tạo và chạy kiểm thử
• codex "Bulk‑rename *.jpeg → *.jpg with git mv": đổi tên tệp an toàn và cập nhật cách sử dụng
• codex "Explain what this regex does: ^(?=.*[A-Z]).{8,}$": giải thích biểu thức chính quy
• codex "Carefully review this repo, and propose 3 high impact well-scoped PRs": đề xuất các PR có tác động lớn
• codex "Look for vulnerabilities and create a security review report": tìm và giải thích lỗi bảo mật

Cài đặt

• Cài đặt qua npm (khuyến nghị): npm install -g @openai/codex
• Build từ mã nguồn: clone repository, sau đó chuyển vào gói CLI để cài dependency và build

Cấu hình

• Codex tìm tệp cấu hình trong ~/.codex/
• Có thể định nghĩa hướng dẫn tùy chỉnh: ~/.codex/instructions.md

FAQ

• OpenAI đã phát hành một mô hình tên là Codex vào năm 2021, đây là một hệ thống AI tạo mã từ prompt ngôn ngữ tự nhiên
• Codex luôn chạy trong sandbox; nếu thấy lệnh đáng ngờ hoặc đề xuất thay đổi tệp, có thể nhập n để không ảnh hưởng đến working tree
• Trên Windows, không chạy trực tiếp mà cần Windows Subsystem for Linux (WSL2)
• Các mô hình được hỗ trợ: mọi mô hình khả dụng thông qua Responses API

Đóng góp

• Dự án này đang được phát triển tích cực và mã có thể thay đổi đáng kể
• Hoan nghênh đóng góp, đồng thời coi trọng độ tin cậy và khả năng bảo trì lâu dài
• Cung cấp hướng dẫn về quy trình phát triển, cách viết thay đổi mã chất lượng cao, mở PR, quy trình review, giá trị cộng đồng và cách nhận trợ giúp

Giấy phép

• Repository này sử dụng giấy phép Apache-2.0

[GN⁺]

Ý kiến trên Hacker News

• Đã thử tài liệu hóa một codebase quy mô trung bình bằng cách so sánh Codex o4-mini và Claude Code

  • Claude Code đã viết tài liệu rất tốt
  • Codex đã tưởng tượng ra những nội dung không có trong mã và mô tả sai kiến trúc
  • Vấn đề của Codex dường như là gặp khó khăn trong việc nạp đúng ngữ cảnh và duy trì sự chú ý
  • Kỳ vọng rất cao vào các mô hình o3 và o4-mini, và hy vọng sẽ có kết quả tốt hơn trong các bài thử khác

• Đã dán toàn bộ hoặc một phần repository vào gemini, rồi dùng script tự viết để áp dụng các thay đổi vào mã

  • Đã thử aider, copilot, continue v.v. nhưng mỗi công cụ đều có nhược điểm riêng

• Claude Code thực sự rất xuất sắc, và trước đây đã từng thất vọng với các coding agent khác

  • Khi dùng Claude Code đã nhận được kết quả tích cực, và chi phí $15 có thể là hợp lý
  • Hy vọng cạnh tranh sẽ mang lại kết quả tốt

• Có demo liên quan và video giới thiệu, đây là phản hồi trực tiếp về Claude Code

  • Không phải mã nguồn mở, và có đề cập đến DMCA
  • Một cuộc phỏng vấn về Claude Code sẽ sớm được công bố, bàn về tầm quan trọng của CLI cho code agent
  • Đang tìm kiếm các trường hợp power user của Claude Code và OAI Codex

• Hiện tại kém hơn Claude Code, nhưng vì là mã nguồn mở nên hy vọng sẽ được cải thiện nhanh chóng

• Codex không hoạt động trực tiếp trên Windows và cần WSL2

  • Có xu hướng phạm vi phát triển native trên Windows đang thu hẹp lại

• Trải nghiệm ban đầu khi dùng Codex không tốt

  • Mô hình mặc định không hoạt động và phải đổi sang mô hình khác
  • Ban đầu bị crash do lỗi NodeJS
  • Sau khi giải quyết các vấn đề ban đầu thì đang so sánh với Claude Code

• Có cách thiết lập khóa API OpenAI bằng biến môi trường

  • Có lo ngại về khả năng các tiện ích 3rd party khác có thể truy cập khóa API

• Đã có kết quả tốt với Amazon Q developer CLI, và tin rằng nó sử dụng claude-3.7-sonnet