Kết nối Codex CLI

Độ khó ⌨️ Trung cấp (cần dùng dòng lệnh / terminal)　|　Định dạng giao diện OpenAI / Responses　|　base_url https://byesu.com/v1

Thông tin kết nối

Địa chỉ APIhttps://byesu.com/v1

Khóa APIsk-xxxxxxxxTạo trong bảng điều khiển →

Mô hìnhgpt-5.5

Định dạng API OpenAI tương thích · tên mô hình theo bảng điều khiển

Codex là trợ lý lập trình dòng lệnh chính thức của OpenAI. Mặc định nó kết nối tới OpenAI, ta chỉ cần trỏ nó về Byesu rồi điền Key của bạn là dùng được.

Trước khi bắt đầu

Trước tiên hãy vào Bảng điều khiển → Token để tạo một API Key (xem chi tiết tại Bắt đầu nhanh). Mọi chỗ xuất hiện sk-xxxx bên dưới đều thay bằng Key của riêng bạn.

Bước 1: Cài đặt Codex

Nếu chưa cài, hãy chọn một trong các cách:

npm (đa nền tảng)

npm install -g @openai/codex

Homebrew (macOS)

brew install codex

Sau khi cài xong, kiểm tra lại:

codex --version

Bước 2: Cấu hình (chọn một trong hai)

Cách 1: Script một dòng (nhanh nhất, khuyến nghị)

Địa chỉ giao diện chúng tôi đã viết sẵn vào script cho bạn —— chạy xong chỉ cần dán API Key của bạn (sk-xxxx), nó sẽ tự động cấu hình ~/.codex/config.toml và auth.json (gồm các mục bắt buộc như wire_api=responses, disable_response_storage, bạn không phải lo). Cấu hình xong thì nhảy thẳng tới Bước 3.

Windows

iex (irm 'https://docs.byesu.com/setup/codex.ps1')

macOS / Linux

curl -fsSL https://docs.byesu.com/setup/codex.sh | bash

Cách 2: Cấu hình thủ công

Cấu hình của Codex nằm trong thư mục ~/.codex/, cần hai tập tin.

① ~/.codex/config.toml —— chỉ định mô hình và điểm kết nối:

model = "gpt-5.5"                  # Mới và mạnh nhất hiện nay; cũng có thể điền tên mô hình khác trong bảng điều khiển
model_provider = "byesu"
model_reasoning_effort = "high"    # Cường độ suy nghĩ: minimal / low / medium / high
disable_response_storage = true    # ★ Bắt buộc thêm khi nối gateway bên thứ ba, nếu không có thể báo lỗi

[model_providers.byesu]
name = "byesu"
base_url = "https://byesu.com/v1"
wire_api = "responses"             # ★ Phải là responses, Codex đi qua /v1/responses

② ~/.codex/auth.json —— lưu Key của bạn:

{
  "OPENAI_API_KEY": "sk-token-của-bạn"
}

🤔 Không biết tạo hai tập tin này thế nào? (bấm để xem)

Windows: Trong thư mục C:\Users\tên-người-dùng-của-bạn\.codex\, dùng "Notepad" tạo mới lần lượt config.toml và auth.json (khi Lưu dưới dạng, chọn kiểu lưu là "Tất cả các tập tin"; nếu chưa có thư mục .codex thì tự tạo một thư mục bằng cách gõ vào thanh địa chỉ).

macOS / Linux: Trong terminal chạy mkdir -p ~/.codex && open -e ~/.codex/config.toml (trên Linux thay open -e bằng nano), auth.json làm tương tự.

Bốn chỗ dễ sai nhất

1. wire_api phải là responses (không phải chat), nếu không sẽ báo 404 / sai giao diện.
2. base_url kết thúc bằng /v1, đừng thêm /responses.
3. Đừng quên disable_response_storage = true, nếu không khi nối gateway có thể báo lỗi.
4. Tên trường trong auth.json chính là OPENAI_API_KEY (dù điền vào là token của Byesu).

Bước 3: Chạy thử để kiểm tra

Vào bất kỳ thư mục dự án nào, khởi động:

codex

Sau đó cho nó làm việc gì đó nhỏ, ví dụ nhập «liệt kê các tập tin trong thư mục hiện tại». Nếu trả lời bình thường là đã kết nối thành công ✅

Mẹo nhỏ

Điều chỉnh cường độ suy nghĩ

model_reasoning_effort kiểm soát mô hình "nghĩ bao lâu":

• minimal / low: nhanh, tiết kiệm tiền, phù hợp với các thay đổi đơn giản
• medium: cân bằng mặc định
• high: tái cấu trúc phức tạp, bài toán khó, chất lượng cao nhất nhưng chậm hơn và đắt hơn

Đổi mô hình

Cứ sửa trực tiếp dòng model trong config.toml, đổi sang tên mô hình bất kỳ khả dụng trong bảng điều khiển là được. Nếu muốn phiên bản được Codex tối ưu chuyên biệt, có thể điền gpt-5.3-codex-spark.

Bị kẹt?

Đối chiếu với Lỗi thường gặp & cách khắc phục để kiểm tra, vài lỗi phổ biến nhất:

• Báo 401 / invalid token → Key trong auth.json điền sai hoặc đặt sai vị trí (chi tiết)
• Báo số dư không đủ → vào bảng điều khiển nạp tiền (chi tiết)
• Báo không có kênh khả dụng → mô hình này không nằm trong nhóm của bạn, hãy đổi mô hình khác (chi tiết)