Hướng dẫn cài đặt Codex CLI

Nếu bạn định dùng dòng mô hình GPT / Codex, cũng có thể cài sẵn Codex CLI trước. Sau khi cài xong, bạn cũng có thể kết nối NextHub qua CC-Switch.

Các bước cài đặt

1. Xác nhận môi trường Node.js

Codex CLI cũng cần môi trường Node.js, khuyến nghị kiểm tra phiên bản trước:

node -v
npm -v

2. Cài đặt toàn cục Codex CLI

Trong terminal thực thi lệnh sau để cài đặt Codex:

npm install -g @openai/codex

3. Xác minh Codex đã cài đặt thành công hay chưa

Thực thi lệnh dưới đây, in ra số phiên bản bình thường hoặc khởi động được Codex là được:

codex --version
codex

Cách kết nối 1: CC-Switch (khuyên dùng)

Sau khi cài đặt xong, cứ tiếp tục với hướng dẫn CC-Switch. Trong CC-Switch chọn Codex, điền địa chỉ yêu cầu https://api.nexthub.cc/v1 (giao thức OpenAI Responses cần kèm /v1), rồi điền ApiKey của bạn là dùng được qua nhóm GPT-Azure (0.47x).

Cách kết nối 2: cấu hình thủ công

Nếu không muốn dùng công cụ cấu hình, bạn chỉ cần tự sửa hai tệp cấu hình của Codex.

1. Mở thư mục cấu hình Codex

Windows (CMD)

start "" "%USERPROFILE%\.codex"

macOS (Terminal)

open "$HOME/.codex"

Nếu trong thư mục không có tệp tương ứng thì tự tạo.

2. Cấu hình config.toml

Ghi nội dung sau vào ~/.codex/config.toml:

model = "gpt-5.6"
model_provider = "nexthub"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.nexthub]
name = "nexthub"
base_url = "https://api.nexthub.cc/v1"
wire_api = "responses"
requires_openai_auth = true

Địa chỉ yêu cầu phải kèm /v1

Codex dùng giao thức OpenAI Responses (/v1/responses), base_url cần kèm /v1. Điền ID mô hình do nhóm GPT-Azure / GPT-Pro cung cấp vào model theo nhu cầu (như gpt-5.6, gpt-6-astra), lấy theo dữ liệu thời gian thực trên Model Plaza.

3. Cấu hình auth.json

Ghi ApiKey vào ~/.codex/auth.json (khóa của nhóm GPT-Azure hoặc GPT-Pro):

{
  "OPENAI_API_KEY": "ApiKey NextHub của bạn"
}

4. Xác minh

Chạy codex trong terminal và gửi một tin nhắn thử; đầu giao diện hiển thị mô hình đã chọn và trả lời bình thường là kết nối thành công.

Prompt toàn cục

~/.codex/AGENTS.md là tệp prompt toàn cục của Codex, nếu chưa có sẽ tự tạo, bạn có thể ghi các quy ước làm việc của mình vào đó.