88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support

Codex CLI

WindowsmacOSLinux

Giới thiệu dự án

Codex CLI is a coding agent from OpenAI that runs locally on your computer.

Codex CLI là một tác nhân lập trình (coding agent) của OpenAI, chạy cục bộ trên máy tính của bạn.

  1. Trang chủ chính thức: https://chatgpt.com/codex
  2. Trang dự án: https://github.com/openai/codex
  3. Cách cài đặt: xem hướng dẫn bên dưới trên trang này

Minh họa

introduce-01.webp

Tính năng

Danh mụcTính năng
Trợ lý lập trình trên terminalCodex CLI là trợ lý lập trình tương tác chạy trên terminal, dùng để chỉnh sửa mã, tạo bản vá và chạy lệnh trong dòng lệnh.
Kiến trúc dựa trên công cụCung cấp các công cụ như apply_patch, shell, update_plan, multi_tool_use để thay đổi tệp và thao tác trong kho mã một cách có kiểm soát.
Chỉnh sửa bản vá nguyên tửDùng định dạng bản vá chuyên biệt để thêm/cập nhật/xóa tệp một cách nguyên tử qua apply_patch, thuận tiện cho việc kiểm tra và hoàn tác.
Sandbox và phê duyệtHỗ trợ chính sách sandbox (như workspace-write, read-only) và chế độ phê duyệt (untrusted, on-request, never) để kiểm soát quyền ghi và truy cập mạng.
Theo dõi kế hoạchupdate_plan dùng để liệt kê các bước và theo dõi trạng thái, luôn chỉ có một bước in_progress để tiến độ rõ ràng.
Quy tắc tương tácGửi giải thích ngắn trước các thao tác quan trọng, giữ giọng điệu thân thiện, ngắn gọn và cập nhật tiến độ.
Ràng buộc an toànTuân thủ quy tắc nghiêm ngặt (không tùy ý sửa tệp không liên quan, không thêm tiêu đề bản quyền, không chạy lệnh phá hoại), cần người dùng phê duyệt các thao tác nhạy cảm.
Kiểm thử và định dạngKhuyến nghị chạy kiểm thử và công cụ định dạng liên quan sau khi sửa đổi, nhưng không chịu trách nhiệm sửa các vấn đề không liên quan đến nhiệm vụ hiện tại.
Đầu ra và phong cáchĐầu ra cuối cùng tuân theo quy chuẩn hiển thị của CLI (ví dụ tiêu đề **, dấu backtick cho đường dẫn/lệnh), giữ cấu trúc ngắn gọn, dễ đọc lướt.
Thực thi song songHỗ trợ chạy song song nhiều công cụ qua multi_tool_use.parallel để tăng hiệu quả.

Cách cấu hình mô hình AI

Hướng dẫn bằng hình ảnh cho Windows

1. Mở terminal

windows_open_terminal

2. Cài đặt WSL

Codex hiện đã chạy được trực tiếp trên Windows: bạn có thể cài ngay trong PowerShell bằng powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" (hoặc npm i -g @openai/codex nếu đã cài Node.js), cấu hình bằng phiên bản PowerShell của script ở bước 4, rồi chạy codex trực tiếp trong PowerShell. Nếu bạn cần bộ công cụ Linux, hãy dùng WSL2 như hướng dẫn bên dưới (khi đó cả Codex và script cấu hình đều phải chạy bên trong WSL; xem bước 4).

Cài đặt WSL2, khởi động lại máy tính Windows

wsl --install Khởi động lại máy tính Windows sau khi cài đặt xong

Lưu ý cho Windows

  • Nên dùng PowerShell thay vì CMD
  • Nếu gặp lỗi quyền, hãy thử chạy với quyền quản trị viên
  • Một số phần mềm diệt virus có thể báo nhầm; bạn có thể cần thêm vào danh sách trắng

windows-img-03.webp

Tải Node Version Manager (NVM)

Sau khi khởi động lại, mở PowerShell, gõ wsl để vào Ubuntu, rồi chạy:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

windows-img-04.webp

Cài Node.js 22 bằng NVM

Mở một cửa sổ PowerShell mới trên thanh tab và khởi động WSL wsl

Cài đặt Node.js (gói npm của Codex yêu cầu Node.js 16 trở lên; khuyến nghị bản 22 LTS):

nvm install 22

windows-img-05.webp

3. Cài đặt Codex CLI

Cài đặt Codex CLI

npm i -g @openai/codex Lệnh này tải và cài đặt phiên bản Codex CLI mới nhất từ kho npm chính thức.

windows-img-06.webp

4. Sửa tệp cấu hình (trong WSL)

Codex được cài trong WSL nên cấu hình cũng phải được ghi trong WSL. Trong PowerShell, gõ wsl để vào Ubuntu, rồi chạy:

Sửa tệp cấu hình Codex CLI bằng một lệnh (trong WSL)

bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)

windows-configure

Lời nhắc của script hiển thị bằng tiếng Trung; các giá trị giống như trong bài viết.

Khi được hỏi API 基础地址 (địa chỉ API cơ sở), chỉ cần nhấn Enter (mặc định là https://api.88api.ai, script sẽ tự thêm /v1 thành https://api.88api.ai/v1), sau đó dán token 88API của bạn (nội dung nhập sẽ không hiển thị). Script ghi vào ~/.codex/config.toml bên trong WSL (không phải %USERPROFILE%\.codex của Windows; nếu đã đặt CODEX_HOME thì ghi vào thư mục đó) và mặc định dùng model_provider = "88api", wire_api = "responses" cùng experimental_bearer_token riêng của Provider; khi xong sẽ hiển thị API 基础地址: https://api.88api.ai/v1 và 已写入: …/config.toml. Script mới không còn ghi khóa 88API vào auth.json.OPENAI_API_KEY, tránh lỗi API_KEY_REQUIRED / 401 Unauthorized trên các phiên bản Codex mới.

Lưu ý: script sẽ ghi đè config.toml hiện có; tệp gốc được tự động sao lưu thành config.toml.bak.<thời_gian> (script hiển thị 已备份原配置: …). Nếu bạn đã cấu hình máy chủ MCP, dự án tin cậy hoặc Provider khác, hãy gộp lại từ bản sao lưu.

Không dùng WSL (PowerShell gốc của Windows)

Chỉ dùng phiên bản PowerShell của script khi bạn cài và chạy Codex trong PowerShell gốc của Windows (không dùng WSL). Script này ghi vào %USERPROFILE%\.codex\config.toml:

curl.exe --ssl-no-revoke -fsSL https://88api.ai/helper/codex-cli-setup.ps1 -o "$env:TEMP\codex-cli-setup.ps1"
PowerShell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\codex-cli-setup.ps1"

Các lời nhắc và nội dung được ghi giống như trên; sau đó chạy codex trực tiếp trong PowerShell.

Cấu hình config.toml thủ công (tùy chọn)

Để cấu hình thủ công, ghi nội dung sau vào ~/.codex/config.toml (trên Windows gốc: %USERPROFILE%\.codex\config.toml):

model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"

[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-your-88api-key"

Lưu ý: base_url phải kết thúc bằng /v1 (Codex chỉ nối thêm /responses và không tự thêm /v1; thiếu /v1 thì yêu cầu sẽ bị chuyển hướng sang trang web và báo lỗi). wire_api chỉ được là responses (Codex mới đã bỏ chat).

5. Bắt đầu sử dụng Codex CLI

Bây giờ bạn có thể bắt đầu sử dụng Codex CLI!

Khởi động Codex CLI

Trước tiên gõ wsl để vào Ubuntu. Khởi động trực tiếp: codex. Dùng trong một dự án cụ thể: cd ~/code/your-project (khuyến nghị đặt dự án trong thư mục Linux của WSL; thư mục Windows được viết là cd /mnt/c/Users/<tên_người_dùng>/path/to/project), rồi chạy codex.

windows-img-09.webp

windows-img-10.webp

Thiết lập quyền cho Codex CLI: 1. Cho phép Codex sửa tệp trực tiếp; 2. Codex cần được cấp quyền thủ công khi sửa tệp

Chọn mô hình

/model

Ảnh chụp màn hình là từ phiên bản Codex cũ; hãy đối chiếu tên mô hình với danh sách /model hiện tại và danh sách mô hình 88API bên dưới.

windows-img-11.webp

windows-img-12.webp

windows-img-13.webp

windows-img-14.webp

Lưu ý: sau khi cấu hình, mọi mô hình trong /model đều đi qua endpoint 88API và không dùng hạn mức của tài khoản chính thức. Các mô hình 88API hiện dùng được trong Codex: gpt-6.1-sol (mặc định của script, khuyên dùng), gpt-6-astra (mô hình hàng đầu), gpt-6-sol, gpt-5.6-sol (mặc định của các phiên bản script cũ), gpt-5.6-terra, gpt-5.5 (nhóm của token phải bao gồm mô hình đó; nếu nhóm của bạn không có gpt-6.1-sol, hãy dùng gpt-6-astra). gpt-6-luna và gpt-5.6-luna cũng xuất hiện trong danh sách nhưng 88API chưa cung cấp; chọn chúng sẽ báo lỗi không tìm thấy mô hình.

Hướng dẫn bằng hình ảnh cho macOS

1. Cài đặt Homebrew (bỏ qua nếu đã cài)

Homebrew là trình quản lý gói còn thiếu của macOS.

Trang chủ: https://brew.sh

macos-img-01.webp

Cài đặt Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

macos-img-02.webp

macos-img-03.webp

macos-img-04.webp

2. Cài đặt môi trường Node.js

Các bước cài đặt môi trường Node.js

Cập nhật Homebrew brew update Cài đặt Node.js brew install node

Lưu ý cho macOS

  • Nếu gặp lỗi quyền, bạn có thể cần dùng sudo
  • Lần chạy đầu tiên có thể cần cho phép trong Cài đặt hệ thống (System Settings)
  • Nên dùng Terminal hoặc iTerm2

macos-img-05.webp

macos-img-06.webp

Kiểm tra cài đặt

Sau khi cài đặt, mở terminal và nhập các lệnh sau:

node --version
npm --version

Nếu hiển thị số phiên bản, việc cài đặt đã thành công.

3. Cài đặt Codex CLI

Cài đặt Codex CLI

Mở terminal và chạy:

npm install -g @openai/codex

Nếu gặp lỗi quyền: sudo npm install -g @openai/codex. Bạn cũng có thể cài bằng Homebrew: brew install --cask codex.

macos-img-07.webp

Kiểm tra cài đặt Codex CLI

Sau khi cài đặt, nhập lệnh sau để kiểm tra: codex --version Nếu hiển thị số phiên bản, xin chúc mừng! Codex CLI đã được cài đặt thành công.

4. Sửa tệp cấu hình

Sửa tệp cấu hình Codex CLI bằng một lệnh

bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)

macos-configure

Lời nhắc của script hiển thị bằng tiếng Trung; các giá trị giống như trong bài viết.

Khi được hỏi API 基础地址 (địa chỉ API cơ sở), chỉ cần nhấn Enter (mặc định là https://api.88api.ai, script sẽ tự thêm /v1 thành https://api.88api.ai/v1), sau đó dán token 88API của bạn (nội dung nhập sẽ không hiển thị). Script ghi vào ~/.codex/config.toml (nếu đã đặt CODEX_HOME thì ghi vào thư mục đó) và mặc định dùng model_provider = "88api", wire_api = "responses" cùng experimental_bearer_token riêng của Provider; khi xong sẽ hiển thị API 基础地址: https://api.88api.ai/v1 và 已写入: …/config.toml. Script mới không còn ghi khóa 88API vào auth.json.OPENAI_API_KEY.

Lưu ý: script sẽ ghi đè config.toml hiện có; tệp gốc được tự động sao lưu thành config.toml.bak.<thời_gian> (script hiển thị 已备份原配置: …). Nếu bạn đã cấu hình máy chủ MCP, dự án tin cậy hoặc Provider khác, hãy gộp lại từ bản sao lưu.

Cấu hình config.toml thủ công (tùy chọn)

Để cấu hình thủ công, ghi nội dung sau vào ~/.codex/config.toml:

model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"

[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-your-88api-key"

Lưu ý: base_url phải kết thúc bằng /v1 (Codex chỉ nối thêm /responses và không tự thêm /v1; thiếu /v1 thì yêu cầu sẽ bị chuyển hướng sang trang web và báo lỗi). wire_api chỉ được là responses (Codex mới đã bỏ chat).

5. Bắt đầu sử dụng Codex CLI

Bây giờ bạn có thể bắt đầu sử dụng Codex CLI!

Khởi động Codex CLI

Khởi động Codex CLI trực tiếp: codex. Dùng trong một dự án cụ thể: trước tiên cd ~/path/to/your/project, rồi chạy codex.

macos-img-09.webp

macos-img-10.webp

Thiết lập quyền cho Codex CLI: 1. Cho phép Codex sửa tệp trực tiếp; 2. Codex cần được cấp quyền thủ công khi sửa tệp

Ảnh chụp màn hình là từ phiên bản Codex cũ; hãy đối chiếu tên mô hình với danh sách /model hiện tại và danh sách mô hình 88API bên dưới.

macos-img-11.webp

macos-img-12.webp

macos-img-13.webp

macos-img-14.webp

Lưu ý: sau khi cấu hình, mọi mô hình trong /model đều đi qua endpoint 88API và không dùng hạn mức của tài khoản chính thức. Các mô hình 88API hiện dùng được trong Codex: gpt-6.1-sol (mặc định của script, khuyên dùng), gpt-6-astra (mô hình hàng đầu), gpt-6-sol, gpt-5.6-sol (mặc định của các phiên bản script cũ), gpt-5.6-terra, gpt-5.5 (nhóm của token phải bao gồm mô hình đó; nếu nhóm của bạn không có gpt-6.1-sol, hãy dùng gpt-6-astra). gpt-6-luna và gpt-5.6-luna cũng xuất hiện trong danh sách nhưng 88API chưa cung cấp; chọn chúng sẽ báo lỗi không tìm thấy mô hình.

6. Khắc phục sự cố thường gặp trên macOS

Lỗi quyền khi cài đặt

Hãy thử các cách sau:

  • Cài bằng sudo: sudo npm install -g @openai/codex
  • Hoặc cấu hình npm dùng thư mục người dùng: npm config set prefix ~/.npm-global

Cài đặt bảo mật của macOS chặn chạy

Nếu hệ thống chặn Codex CLI:

  • Mở "Cài đặt hệ thống" (System Settings) → "Quyền riêng tư & Bảo mật" (Privacy & Security), tìm codex bị chặn trong mục "Bảo mật" và nhấn "Vẫn mở" (Open Anyway)
  • Không nên tắt Gatekeeper toàn cục bằng sudo spctl --master-disable (Codex cài qua npm thường không bị chặn, và các phiên bản macOS mới không còn cho tắt trực tiếp bằng lệnh này)

Hướng dẫn bằng hình ảnh cho Linux

1. Cài đặt môi trường Node.js

Codex CLI cần môi trường Node.js để chạy.

Các bước cài đặt môi trường Node.js

Thêm kho NodeSource sudo curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - Cài đặt Node.js sudo apt-get install -y nodejs

Lưu ý cho Linux

  • Một số bản phân phối có thể cần cài thêm phụ thuộc
  • Dùng sudo nếu gặp lỗi quyền
  • Đảm bảo người dùng của bạn có quyền ghi vào thư mục toàn cục của npm

linux-img-01.webp

linux-img-02.webp

Kiểm tra cài đặt

Sau khi cài đặt, mở terminal và nhập các lệnh sau:

node --version
npm --version

Nếu hiển thị số phiên bản, việc cài đặt đã thành công.

2. Cài đặt Codex CLI

Cài đặt Codex CLI

Mở terminal và chạy:

npm install -g @openai/codex

Nếu gặp lỗi quyền: sudo npm install -g @openai/codex

linux-img-03.webp

Kiểm tra cài đặt Codex CLI

Sau khi cài đặt, nhập lệnh sau để kiểm tra: codex --version Nếu hiển thị số phiên bản, xin chúc mừng! Codex CLI đã được cài đặt thành công.

3. Sửa tệp cấu hình

Sửa tệp cấu hình Codex CLI bằng một lệnh

bash <(curl -fsSL https://88api.ai/helper/codex-cli-setup.sh)

macos-configure

Lời nhắc của script hiển thị bằng tiếng Trung; các giá trị giống như trong bài viết.

Khi được hỏi API 基础地址 (địa chỉ API cơ sở), chỉ cần nhấn Enter (mặc định là https://api.88api.ai, script sẽ tự thêm /v1 thành https://api.88api.ai/v1), sau đó dán token 88API của bạn (nội dung nhập sẽ không hiển thị). Script ghi vào ~/.codex/config.toml (nếu đã đặt CODEX_HOME thì ghi vào thư mục đó) và mặc định dùng model_provider = "88api", wire_api = "responses" cùng experimental_bearer_token riêng của Provider; khi xong sẽ hiển thị API 基础地址: https://api.88api.ai/v1 và 已写入: …/config.toml. Script mới không còn ghi khóa 88API vào auth.json.OPENAI_API_KEY.

Lưu ý: script sẽ ghi đè config.toml hiện có; tệp gốc được tự động sao lưu thành config.toml.bak.<thời_gian> (script hiển thị 已备份原配置: …). Nếu bạn đã cấu hình máy chủ MCP, dự án tin cậy hoặc Provider khác, hãy gộp lại từ bản sao lưu.

Cấu hình config.toml thủ công (tùy chọn)

Để cấu hình thủ công, ghi nội dung sau vào ~/.codex/config.toml:

model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"

[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-your-88api-key"

Lưu ý: base_url phải kết thúc bằng /v1 (Codex chỉ nối thêm /responses và không tự thêm /v1; thiếu /v1 thì yêu cầu sẽ bị chuyển hướng sang trang web và báo lỗi). wire_api chỉ được là responses (Codex mới đã bỏ chat).

4. Bắt đầu sử dụng Codex CLI

Bây giờ bạn có thể bắt đầu sử dụng Codex CLI!

Khởi động Codex CLI

# Chuyển đến thư mục dự án của bạn
cd /path/to/your/project
# Khởi động Codex CLI
codex

linux-img-05.webp

linux-img-06.webp

Thiết lập quyền cho Codex CLI: 1. Cho phép Codex sửa tệp trực tiếp; 2. Codex cần được cấp quyền thủ công khi sửa tệp

Ảnh chụp màn hình là từ phiên bản Codex cũ; hãy đối chiếu tên mô hình với danh sách /model hiện tại và danh sách mô hình 88API bên dưới.

linux-img-07.webp

linux-img-08.webp

linux-img-09.webp

linux-img-10.webp

Lưu ý: sau khi cấu hình, mọi mô hình trong /model đều đi qua endpoint 88API và không dùng hạn mức của tài khoản chính thức. Các mô hình 88API hiện dùng được trong Codex: gpt-6.1-sol (mặc định của script, khuyên dùng), gpt-6-astra (mô hình hàng đầu), gpt-6-sol, gpt-5.6-sol (mặc định của các phiên bản script cũ), gpt-5.6-terra, gpt-5.5 (nhóm của token phải bao gồm mô hình đó; nếu nhóm của bạn không có gpt-6.1-sol, hãy dùng gpt-6-astra). gpt-6-luna và gpt-5.6-luna cũng xuất hiện trong danh sách nhưng 88API chưa cung cấp; chọn chúng sẽ báo lỗi không tìm thấy mô hình.

5. Khắc phục sự cố thường gặp trên Linux

Lỗi quyền khi cài đặt

Hãy thử các cách sau:

  • Cài bằng sudo: sudo npm install -g @openai/codex

  • Hoặc cấu hình npm dùng thư mục người dùng: npm config set prefix ~/.npm-global

  • Sau đó thêm vào PATH: export PATH=~/.npm-global/bin:$PATH

Thiếu thư viện phụ thuộc

Một số bản phân phối Linux cần cài thêm phụ thuộc:

# Ubuntu/Debian
sudo apt install build-essential
# CentOS/RHEL
sudo dnf groupinstall "Development Tools"

ChatGPT/Codex Client

Trang trước

Claude Code

Trang tiếp theo

Mục lục

Minh họa
Tính năng
Cách cấu hình mô hình AI
Hướng dẫn bằng hình ảnh cho Windows
1. Mở terminal
2. Cài đặt WSL
3. Cài đặt Codex CLI
4. Sửa tệp cấu hình (trong WSL)
5. Bắt đầu sử dụng Codex CLI
Hướng dẫn bằng hình ảnh cho macOS
1. Cài đặt Homebrew (bỏ qua nếu đã cài)
2. Cài đặt môi trường Node.js
3. Cài đặt Codex CLI
4. Sửa tệp cấu hình
5. Bắt đầu sử dụng Codex CLI
6. Khắc phục sự cố thường gặp trên macOS
Hướng dẫn bằng hình ảnh cho Linux
1. Cài đặt môi trường Node.js
2. Cài đặt Codex CLI
3. Sửa tệp cấu hình
4. Bắt đầu sử dụng Codex CLI
5. Khắc phục sự cố thường gặp trên Linux