Catalogs Hide Show
HƯỚNG DẪN CÀI ĐẶT & SỬ DỤNG OPENAI CODEX (NODE.JS)Cẩm nang toàn diện: Trọn bộ lệnh Terminal CLI, Slash TUI, Cấu hình AGENTS.md & Chiến lược tối ưu năng suất lập trình
Trong kỷ nguyên phát triển phần mềm với sự đồng hành của AI Agent, OpenAI Codex CLI (gói npm chính thức
@openai/codex chạy trên môi trường Node.js) đã nhanh chóng trở thành một trong những công cụ dòng lệnh mạnh mẽ nhất dành cho lập trình viên. Khác với những công cụ chat thông thường, Codex hoạt động trực tiếp ngay trong Terminal máy tính của bạn: có khả năng đọc hiểu toàn bộ cấu trúc dự án, trực tiếp chỉnh sửa mã nguồn, thực thi lệnh shell, chạy test và tự động hóa quy trình CI/CD. Bài viết này sẽ hướng dẫn bạn từ bước thiết lập môi trường, danh sách đầy đủ tất cả các lệnh cho đến phương pháp khai thác Codex đạt hiệu quả cao nhất!
TỔNG QUAN VỀ SỨC MẠNH CỦA CODEX CLI TRÊN NODE.JS
Terminal Native
Hoạt động trực tiếp trong cửa sổ dòng lệnh Terminal/PowerShell yêu thích của bạn, không cần rời mắt khỏi không gian làm việc hay chuyển đổi ứng dụng.
Sandbox & Phân Quyền
Cơ chế kiểm soát chặt chẽ với các chế độ Sandbox (chỉ đọc, ghi trong thư mục dự án) cùng chính sách xin phép duyệt lệnh cực kỳ an toàn.
Tự Động Hóa CI/CD
Chế độ chạy ngầm One-Shot qua
codex exec cho phép tích hợp thẳng vào Git Hooks, script build và quy trình kiểm thử tự động.
Chuẩn Hóa AGENTS.md
Đọc hiểu sâu ngữ cảnh dự án thông qua chuẩn mở
AGENTS.md, tự động nạp quy tắc lập trình, tech stack và quy chuẩn test của nhóm.
Code Review Tức Thì
Tính năng
/review chuyên sâu giúp phân tích Git Diff, phát hiện lỗ hổng bảo mật, lỗi logic và tối ưu clean code trước khi commit.Đa Mô Hình Linh Hoạt
Dễ dàng chuyển đổi linh hoạt giữa các dòng model OpenAI tiên tiến, tùy chỉnh mức độ suy luận (Reasoning Effort) theo độ phức tạp của bài toán.
PHẦN 1: HƯỚNG DẪN CÀI ĐẶT & THIẾT LẬP MÔI TRƯỜNG
1. Yêu Cầu Tiên Quyết Hệ Thống
Codex CLI được phân phối qua hệ sinh thái Node.js/npm, do đó máy tính của bạn cần đáp ứng:
• Node.js: Phiên bản 18.0.0 trở lên (khuyến nghị dùng bản LTS mới nhất như v20 hoặc v22).
• Trình quản lý gói:
npm (đi kèm Node.js) hoặc pnpm, yarn.• Hệ điều hành: Windows 10/11, macOS, hoặc Linux (Ubuntu, Debian, Fedora...).
Kiểm tra phiên bản hiện có trên máy:
Bash:
node -v
npm -v2. Cài Đặt OpenAI Codex CLI Toàn Cục (Global)
Bạn mở Terminal (PowerShell / Windows Terminal / Bash) và chạy lệnh sau để cài đặt phiên bản chính thức:
Bash:
# Cài đặt toàn cục qua npm
npm install -g @openai/codex
# Hoặc nếu bạn muốn dùng script cài đặt độc lập (macOS/Linux)
curl -fsSL https://chatgpt.com/codex/install.sh | shSau khi cài xong, kiểm tra xem lệnh đã sẵn sàng trong hệ thống hay chưa:
Bash:
codex --version3. Đăng Nhập & Xác Thực Tài Khoản
Codex hỗ trợ 2 hình thức xác thực chính thức:
Cách A - Đăng nhập tương tác qua tài khoản ChatGPT (Plus / Pro / Team / Enterprise):
Chỉ cần gõ lệnh sau, trình duyệt sẽ tự động bật tab OAuth để bạn xác thực 1 chạm:
Bash:
codex loginCách B - Xác thực bằng OpenAI API Key (Thích hợp cho Server / Docker / CI/CD):
Thiết lập biến môi trường
OPENAI_API_KEY trước khi khởi chạy:
Bash:
# Trên Windows PowerShell
$env:OPENAI_API_KEY="sk-your-openai-api-key"
# Trên Linux / macOS Bash
export OPENAI_API_KEY="sk-your-openai-api-key"Kiểm tra trạng thái phiên đăng nhập bất kỳ lúc nào bằng lệnh:
Bash:
codex login status
PHẦN 2: BẢNG TRA CỨU ĐẦY ĐỦ CÁC LỆNH SỬ DỤNG (CLI & TUI)
1. Các Lệnh Khởi Chạy Từ Terminal CLI
Đây là các câu lệnh bạn gõ trực tiếp bên ngoài shell để gọi Codex làm việc:
| Câu lệnh CLI | Mô tả chức năng & Tình huống sử dụng |
|---|---|
codex | Khởi động giao diện tương tác TUI (Terminal User Interface) ngay trong thư mục hiện tại. |
codex . | Chỉ định tường minh mở phiên làm việc tại thư mục hiện tại. |
codex "Nhiệm vụ..." | Khởi động phiên làm việc kèm theo sẵn câu nhắc (prompt) khởi tạo ban đầu. |
codex exec "Nhiệm vụ..." | Chế độ không tương tác (Headless / One-shot): Codex tự động phân tích, sửa code và thoát với exit code chuẩn; rất lý tưởng cho CI/CD pipeline và script tự động. |
codex --sandbox <mode>(Hoặc viết tắt -s) | Thiết lập chế độ Sandbox an toàn. Có 3 chế độ: • read-only: Chỉ cho phép đọc file, không được sửa đổi mã nguồn.• workspace-write: (Mặc định) Cho phép đọc & sửa đổi file trong workspace.• danger-full-access: Cho phép can thiệp toàn bộ máy tính (cần cẩn trọng). |
codex --ask-for-approval <policy> | Chính sách phê duyệt: • on-request: Dừng lại hỏi người dùng trước khi chạy lệnh shell nguy hiểm.• never: Tự động thực thi trong phạm vi sandbox mà không dừng hỏi. |
codex --full-auto | Chạy ở chế độ hoàn toàn tự động, tự xử lý chuỗi tác vụ mà không yêu cầu phê duyệt thủ công từng bước. |
codex --model <tên_model>(Hoặc viết tắt -m) | Chỉ định model OpenAI cụ thể sử dụng cho phiên làm việc. |
codex --profile <tên_profile> | Tải hồ sơ cấu hình riêng biệt đã lưu trong ~/.codex/config.toml. |
codex --config <key=value> | Ghi đè tạm thời một giá trị cấu hình trực tiếp từ dòng lệnh. |
codex login / logout | Đăng nhập hoặc đăng xuất tài khoản ChatGPT khỏi máy tính. |
codex --help | Hiển thị trợ giúp chi tiết danh sách cờ (flags) và tham số của phiên bản hiện tại. |
2. Các Lệnh Slash ( / ) Trong Giao Diện Tương Tác TUI
Khi đang ở bên trong phiên làm việc của Codex, gõ dấu gạch chéo
/ để gọi các lệnh điều khiển nhanh:| Lệnh Slash | Tác dụng chuyên sâu |
|---|---|
/init | Tự động phân tích codebase và khởi tạo file AGENTS.md chuẩn chỉ với hướng dẫn dự án. |
/model | Mở bảng menu tương tác để chuyển đổi model hoặc tùy chỉnh mức độ suy luận (Low / Medium / High). |
/status | Xem bảng thông số phiên hiện tại: Model đang dùng, lượng token context tiêu thụ, Sandbox mode. |
/permissions | Điều chỉnh trực tiếp quyền hạn truy cập file, quyền thực thi lệnh shell và trạng thái Sandbox ngay trong phiên. |
/review | Khởi chạy tính năng Code Review chuyên sâu: rà soát các thay đổi Git chưa commit, kiểm tra bug và security. |
/clear | Dọn sạch lịch sử hội thoại của phiên hiện tại để giải phóng Context Window, bắt đầu tác vụ mới thanh thoát. |
/help | Xem tóm tắt bảng hướng dẫn các lệnh có sẵn bên trong giao diện TUI. |
/exit | Thoát khỏi phiên làm việc của Codex và quay trở lại màn hình Terminal thông thường. |
3. Các Phím Tắt Tiện Ích Trong Terminal
Ghi nhớ các phím tắt này sẽ giúp bạn làm việc nhanh hơn gấp 3 lần:
• Ctrl + C: Hủy ngay lập tức câu trả lời hoặc lệnh shell đang chạy dở của Agent mà không bị crash phiên.
• Ctrl + D: Phím tắt nhanh để thoát phiên làm việc ngay lập tức.
• Tab: Tự động điền (Auto-complete) tên file, đường dẫn thư mục và gợi ý câu lệnh.
• Mũi tên Lên / Xuống (↑ / ↓): Lật lại lịch sử các câu lệnh và prompt bạn đã nhập trước đó.
PHẦN 3: CẤU TRÚC CHUẨN CỦA FILE AGENTS.MD DỰ ÁN
Bí quyết số 1 để Codex hoạt động chuẩn xác và không sinh mã nguồn lạc đề chính là file
AGENTS.md đặt tại thư mục gốc của dự án. Dưới đây là template chuẩn mực bạn có thể nạp ngay vào dự án của mình:
Markdown (GitHub flavored):
# Hướng Dẫn Phát Triển Dự Án Dành Cho Codex
## 1. Công Nghệ & Môi Trường
- Ngôn ngữ: TypeScript 5.x / Node.js >= 20.x
- Framework: Next.js 15 (App Router) / Tailwind CSS v4
- Database: PostgreSQL qua Prisma ORM
## 2. Quy Chuẩn Lập Trình (Coding Standards)
- Luôn sử dụng cú pháp Functional Components kết hợp Type Interfaces rõ ràng.
- Xử lý bất đồng bộ bắt buộc sử dụng async/await kèm try/catch chi tiết.
- Không sử dụng 'any' trong TypeScript, ưu tiên dùng generic hoặc union type chặt chẽ.
- Không lưu biến nhạy cảm, mật khẩu hoặc secret vào code; luôn đọc từ process.env.
## 3. Lệnh Build & Test
- Cài đặt dependencies: `npm install`
- Chạy môi trường dev: `npm run dev`
- Chạy linter: `npm run lint`
- Chạy unit test: `npm test`
- Build sản phẩm: `npm run build`
## 4. Quy Tắc Khi Sửa Mã Nguồn
- Trước khi thêm tính năng mới, hãy kiểm tra file test tương ứng.
- Sau khi chỉnh sửa mã nguồn, luôn chạy `npm run lint` và `npm test` để xác nhận không phát sinh hồi quy.
PHẦN 4: 6 PHƯƠNG PHÁP SỬ DỤNG CODEX HIỆU QUẢ CAO NHẤT
1. Nguyên Tắc "Atomic Tasks"
Đừng yêu cầu Codex "xây dựng cả hệ thống thanh toán". Hãy chia nhỏ thành từng bước: 1. Định nghĩa Types/Schema ➔ 2. Viết Service Logic ➔ 3. Viết Unit Test ➔ 4. Tích hợp UI.
2. Quản Trị Context Sạch Sẽ
Ngữ cảnh quá dài sẽ làm Agent phản hồi chậm và dễ nhầm lẫn logic cũ. Hãy dùng
/status để theo dõi và chủ động gõ /clear mỗi khi bắt đầu tính năng mới.3. Sandbox Đúng Mục Đích
Dùng
read-only khi cần Codex phân tích cấu trúc, giải thích thuật toán; dùng workspace-write khi code thường ngày; tuyệt đối cẩn thận với danger-full-access.
4. Tự Động Hóa Với
execTận dụng
codex exec trong Git Pre-commit hook để tự động format mã nguồn, kiểm tra lint hoặc tạo nhanh tài liệu API changelog hoàn toàn rảnh tay.
5. Tận Dụng Sức Mạnh
/reviewTrước mỗi lần
git commit, hãy gõ /review. Codex sẽ đóng vai trò như một Senior Dev rà soát lại toàn bộ diff, tìm lỗi tiềm ẩn và cảnh báo góc khuất bạn bỏ quên.
6. Bảo Mật Biến Môi Trường
Tuyệt đối không paste chuỗi API Key hay thông tin tài khoản vào Prompt hoặc
AGENTS.md. Luôn để trong .env và chắc chắn file đó đã nằm trong .gitignore.
CHECKLIST BẮT ĐẦU DỰ ÁN MỚI CÙNG CODEXĐể đạt hiệu suất tối đa khi mở bất kỳ thư mục dự án nào, hãy thực hiện theo 4 bước chuẩn sau:
1. Mở Terminal tại thư mục dự án:
cd /duong-dan-du-an.2. Chạy lệnh:
codex để vào giao diện tương tác.3. Nếu dự án chưa có hướng dẫn, gõ:
/init để tạo bộ khung AGENTS.md, sau đó mở file ra bổ sung các lệnh test/build đặc thù.4. Bắt đầu ra lệnh bằng các câu nhắc súc tích, rõ ràng kèm đường dẫn file cụ thể (Ví dụ: "Kiểm tra file src/auth/login.ts và bổ sung xử lý mã lỗi 429 rate limit").
THẢO LUẬN & TRẢI NGHIỆM TẠI DARKTINA.COMOpenAI Codex trên Node.js đang mở ra cách làm việc mới mẻ, giúp tiết kiệm hàng giờ gõ boilerplate và giảm thiểu tối đa các lỗi vặt thường gặp.
Anh em lập trình viên tại DarkTina đã trải nghiệm Codex CLI chưa? Bạn thích dùng chế độ tương tác TUI hay chế độ tự động
codex exec hơn? Hãy để lại ý kiến thảo luận bên dưới nhé!
