Cài đặt Codex CLI, xác minh tệp thực thi, đăng nhập và bắt đầu bằng một tác vụ nhỏ trong thư mục dự án. Các trình cài đặt chính thức hiện hỗ trợ macOS, Linux và Windows; npm và Homebrew vẫn là lựa chọn thay thế. Hãy chọn một phương thức bên dưới. Cài đặt hoạt động được là bước đầu tiên; quyền truy cập tài khoản và thanh toán API là các lựa chọn riêng biệt.
1. Chọn một phương thức cài đặt
Các lệnh này lấy từ hướng dẫn cài đặt Codex CLI chính thức. Hãy dùng trình cài đặt cho môi trường nơi bạn sẽ chạy agent. Cài đặt tệp thực thi Windows không cài thêm một bản Linux riêng bên trong WSL, và cài đặt trên laptop không cài đặt trên máy chủ từ xa mà bạn sẽ kết nối sau đó.
curl -fsSL https://chatgpt.com/codex/install.sh | shpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Nếu bạn đã quản lý công cụ phát triển bằng trình quản lý gói, hãy dùng lựa chọn thay thế của nó thay vì chạy cả hai trình cài đặt:
| Phương thức | Cài đặt | Cập nhật |
|---|---|---|
| npm | npm install -g @openai/codex | npm install -g @openai/codex |
| Homebrew | brew install --cask codex | brew upgrade --cask codex |
| Độc lập | Chạy trình cài đặt cho hệ điều hành của bạn | Chạy lại chính trình cài đặt đó |
Phương thức npm yêu cầu npm hoạt động bình thường; trước tiên hãy kiểm tra npm --version. Phương thức độc lập hữu ích nếu bạn không cần các công cụ Node khác. Trên máy được quản lý, hãy dùng phương thức cài đặt được quản trị viên hỗ trợ để các lần cập nhật sau vẫn dễ dự đoán.
2. Xác minh tệp thực thi nào đang chạy
Sau khi cài đặt, hãy mở terminal mới nếu không tìm thấy lệnh. Trên macOS hoặc Linux, command -v codex hiển thị tệp thực thi được shell chọn. Trong PowerShell, dùng Get-Command codex. So sánh đường dẫn đó với phương thức cài đặt bạn đã chọn trước khi cài lại. Hai bản cài đặt có thể khiến bạn cập nhật một bản nhưng tiếp tục khởi chạy bản còn lại.
codex --version
codex --help
# Open your own project directory before starting
cd /path/to/your/project
codex login
codex login status
codex --sandbox read-only "Explain this project's structure and how its tests run. Do not modify files."Thay đường dẫn dự án mẫu bằng đường dẫn của bạn. Lệnh cuối sử dụng sandbox chỉ đọc để giải thích ban đầu. Đây là bước kiểm tra hữu ích vì bạn có thể xác nhận đúng repository và quyền truy cập model trước khi yêu cầu agent thực hiện thay đổi. Nếu muốn kiểm tra các cờ khả dụng, hãy dùng phần trợ giúp của CLI đã cài đặt hoặc tài liệu tham chiếu lệnh.
3. Chọn đúng phương thức tài khoản
codex login bắt đầu quy trình đăng nhập tài khoản. Hãy kiểm tra tài khoản trình duyệt và workspace trước khi hoàn tất. Để thanh toán trực tiếp bằng API OpenAI, lựa chọn được tài liệu hóa chấp nhận Platform key qua đầu vào chuẩn:
# After supplying OPENAI_API_KEY through your credential setup:
printenv OPENAI_API_KEY | codex login --with-api-keyLệnh API này dành cho OpenAI Platform key. Đây không phải toàn bộ thiết lập cho gateway bên thứ ba. Nhà cung cấp tùy chỉnh cần cấu hình, endpoint, nguồn thông tin xác thực và model được hỗ trợ riêng. Tài liệu xác thực giải thích các phương thức, còn hướng dẫn Codex API key của chúng tôi trình bày thiết lập nhà cung cấp chuyên sâu hơn.
4. Biến phản hồi đầu tiên thành tác vụ đầu tiên hữu ích
- Hỏi mã nguồn và các bài kiểm thử liên quan nằm ở đâu, sau đó kiểm tra câu trả lời với repository.
- Chọn một thay đổi nhỏ và nêu hành vi mong đợi của nó.
- Dùng branch sạch hoặc một checkpoint, đồng thời chọn quyền phù hợp với thay đổi đó.
- Để Codex chạy các bước kiểm tra liên quan, sau đó xem xét diff và phần giải thích của nó.
Ví dụ, hãy bắt đầu bằng một bài kiểm thử đang thất bại hoặc một thay đổi nhỏ trong tài liệu. Tránh biến tác vụ đầu tiên thành việc viết lại toàn bộ ứng dụng: lúc đó sẽ khó đánh giá cài đặt, thông tin xác thực, dependency cục bộ và chất lượng tác vụ cùng lúc. Khi vòng lặp ngắn hoạt động tốt, hãy thêm hướng dẫn dự án và mở rộng phạm vi.
Nếu quá trình thiết lập dừng, hãy sửa đúng lớp tương ứng
“Không tìm thấy lệnh” cho thấy vấn đề ở cài đặt hoặc PATH. Lỗi 401 cho thấy vấn đề xác thực. Lỗi model cho thấy vấn đề ở nhà cung cấp và model được chọn. Cảnh báo giới hạn cho thấy vấn đề sử dụng hoặc thanh toán. Giữ nguyên các lớp đang hoạt động và làm theo danh sách kiểm tra lỗi 401 hoặc hướng dẫn về giới hạn sử dụng khi phù hợp; cài lại tệp thực thi sẽ không bổ sung tín dụng cho tài khoản.
Để đánh giá Kunavo cho công việc Codex cục bộ, hãy tạo tài khoản và làm theo tích hợp Codex. Tích hợp này sử dụng cấu hình nhà cung cấp tương thích với Responses. Hãy xác minh một tác vụ nhỏ trước khi dựa vào phương thức thanh toán mới cho dự án lớn hơn.
Câu hỏi thường gặp
Cài đặt Codex CLI như thế nào?
Sử dụng trình cài đặt độc lập chính thức cho hệ điều hành của bạn, hoặc lựa chọn thay thế bằng npm hay Homebrew. Nếu cần, hãy mở terminal mới, kiểm tra codex --version, sau đó khởi động Codex từ thư mục dự án và chọn phương thức xác thực.
npm install -g @openai/codex còn được hỗ trợ không?
Có. Tài liệu cài đặt chính thức được kiểm tra vào ngày 17 tháng 9 năm 2026 liệt kê npm cùng với các trình cài đặt độc lập và Homebrew. Hãy chọn một phương thức cài đặt và dùng quy trình cập nhật tương ứng để tránh các bản sao xung đột.
Tôi có cần đăng ký ChatGPT để cài đặt Codex không?
Cài đặt và quyền truy cập model là hai việc riêng biệt. Hãy chọn một phương thức đăng nhập ChatGPT khả dụng hoặc quyền truy cập API được tính phí riêng cho công việc cục bộ được hỗ trợ. Kiểm tra các tùy chọn tài khoản hiện tại trước khi chọn cách thanh toán; cài đặt CLI không cộng thêm tín dụng model.
Tôi có thể cài đặt Codex trên Windows không?
Có. OpenAI cung cấp trình cài đặt độc lập cho Windows. Nếu chọn làm việc bên trong WSL, hãy cài đặt và chạy phiên bản Linux trong môi trường đó, đồng thời lưu ý các đường dẫn dự án và biến môi trường riêng của nó.
Tài liệu cài đặt chính thức và trợ giúp CLI cục bộ được kiểm tra ngày 17 tháng 9 năm 2026.