Bỏ qua tới nội dung
RexAPFTài liệuMở RexAPF Web
Tài liệuAPITích hợp công cụ
API

Dùng RexAPF với Codex CLI

Cấu hình OpenAI Codex CLI gọi model qua API Gateway của RexAPF bằng hai tệp ~/.codex/config.toml và ~/.codex/auth.json.

3 phút đọcYêu cầu: Codex CLI, khoá API RexAPF
Trên trang này
  1. Các bước thủ công
  2. Tạo khoá API
  3. Cài Codex CLI
  4. Ghi tệp config.toml
  5. Ghi tệp auth.json
  6. Khởi chạy trong thư mục dự án
  7. Chạy tạm trên Windows
  8. Model khuyến nghị
  9. Khắc phục sự cố
Cấu hình bằng 1 lệnhScript ghi ~/.codex/config.toml và auth.json, tự sao lưu tệp cũ
Model mặc định
$ curl -sL https://rexapf.com/scripts/setup-codex.sh | bash -s -- "YOUR_API_KEY" "https://rexapf.com/v1" "gpt-5.4"
Base URLhttps://rexapf.com/v1
Biến môi trườngOPENAI_API_KEY
Modelgpt-5.4

Codex CLI gọi API Gateway theo định dạng OpenAI Responses (POST /v1/responses). Bạn khai báo RexAPF là một model provider trong config.toml và đặt khoá API vào auth.json.

Script cấu hình nhanh ở đầu bài sao lưu hai tệp cũ (nếu có) thành config.toml.bak.<thời-gian> và auth.json.bak.<thời-gian>, rồi ghi lại cả hai tệp với nội dung như phần thủ công dưới đây.

Các bước thủ công

  1. Tạo khoá API

    Mở API Gateway › Khóa API, nhấn Tạo khóa API, đặt nhãn (ví dụ “Codex”) rồi nhấn Tạo khóa. Sao chép khoá ngay vì khoá đầy đủ chỉ hiện một lần. Xem Khoá API.

  2. Cài Codex CLI

    bash
    $ npm install -g @openai/codex
  3. Ghi tệp config.toml

    Tạo thư mục ~/.codex nếu chưa có, rồi ghi ~/.codex/config.toml:

    ~/.codex/config.toml
    model = "gpt-5.4"
    model_provider = "rexllm"
    model_reasoning_effort = "high"
    
    [model_providers.rexllm]
    name = "RexLLM"
    base_url = "https://rexapf.com/v1"
    wire_api = "responses"
    
    [agents.subagent]
    model = "gpt-5.4"

    Đổi model (cả ở dòng đầu và trong [agents.subagent]) nếu bạn muốn model mặc định khác.

  4. Ghi tệp auth.json

    ~/.codex/auth.json
    {
      "OPENAI_API_KEY": "sk_9r_..."
    }

    Thay sk_9r_... bằng khoá vừa tạo.

  5. Khởi chạy trong thư mục dự án

    bash
    $ cd my-project
    $ codex
Terminal — ~/.codex
✅ Codex CLI đã được cấu hình cho RexLLM!

   Base URL : https://rexapf.com/v1
   Model    : gpt-5.4
   Config   : /Users/ban/.codex/config.toml
   Auth     : /Users/ban/.codex/auth.json

👉 Mở terminal và chạy: codex
Kết quả khi chạy script cấu hình Codex
Base URL phải có /v1

base_url cần kết thúc bằng /v1. Script tự thêm /v1 nếu bạn truyền địa chỉ thiếu hậu tố này; khi cấu hình tay, bạn phải tự kiểm tra.

Chạy tạm trên Windows

Script cấu hình chỉ chạy trên macOS và Linux. Trên Windows (PowerShell), bạn có thể đặt khoá cho phiên hiện tại và truyền Base URL qua tham số:

Windows (PowerShell)
$env:OPENAI_API_KEY="sk_9r_..."
codex --config openai_base_url="https://rexapf.com/v1" -m gpt-5.4

Muốn dùng lâu dài trên Windows, tạo hai tệp như trên trong %USERPROFILE%\.codex\.

Model khuyến nghị

ModelGhi chú
gpt-5.4Mặc định của script, dùng cho tác vụ lập trình chính
gpt-5.4-miniNhẹ hơn, phản hồi nhanh, hợp với việc nhỏ

Codex dùng định dạng Responses, nên hãy chọn model OpenAI-compatible, không chọn model Claude. Mở API Gateway › Model để xem model đang hoạt động, giá và chạy Health Check cho từng model. Xem Model & bảng giá.

Khắc phục sự cố

Hiện tượngCách xử lý
Lỗi 401 với invalid_api_keyKiểm tra giá trị OPENAI_API_KEY trong auth.json, không để dấu cách hoặc ký tự thừa
Lỗi 401 với api_key_revokedKhoá đã bị thu hồi. Tạo khoá mới và cập nhật auth.json
Lỗi 402Chưa có gói còn hạn và số dư credit bằng 0. Mở API Gateway › Thanh toán
Lỗi 429Hết ngân sách cửa sổ gói, chạm giới hạn chi tiêu hoặc RPM. Đọc code trong thông báo lỗi và xem Mã lỗi & giới hạn
Codex vẫn gọi OpenAI hoặc đòi đăng nhập ChatGPTKiểm tra dòng model_provider = "rexllm" và khối [model_providers.rexllm] có trong config.toml
Lỗi 404 khi gọi modelSai ID model. Sao chép ID chính xác từ API Gateway › Model
Khôi phục cấu hình cũ

Bản sao lưu nằm cạnh tệp gốc, dạng ~/.codex/config.toml.bak.<thời-gian>. Chép đè lên tệp gốc để quay lại cấu hình trước đó.

Vẫn chưa được, xem Khắc phục sự cố hoặc liên hệ hỗ trợ.

Trang này có hữu ích không?Cập nhật 22/10/2026