Trang chủ › Blog

Cấu hình OpenAI Codex CLI và Codex App với apicheap.store qua file config.toml

· apicheap.store

Codex là công cụ lập trình của OpenAI, có bản chạy trong terminal (Codex CLI) và bản ứng dụng desktop (Codex App). Cả hai đọc chung một file cấu hình là config.toml, nên bạn có thể khai báo một nhà cung cấp tương thích chuẩn OpenAI thay cho máy chủ mặc định. Bài này hướng dẫn trỏ Codex sang apicheap.store, từ cách cài tự động đến cấu hình thủ công, đổi model và xử lý lỗi.

Nếu bạn dùng Claude Code thay vì Codex, hãy xem bài kết nối Claude Code CLI với apicheap.store.

Chuẩn bị trước khi cấu hình

Bạn cần chuẩn bị ba thứ:

  1. Tài khoản tại apicheap.store và số dư trong ví.
  2. Một API key dạng sk-..., tạo trong mục API Keys của trang quản lý.
  3. Tên model sẽ dùng.

Có hai cách chọn model:

Trong các ví dụ dưới đây, smart-live-combo chỉ là tên minh hoạ. Nếu tài khoản của bạn chưa tạo combo trùng tên này, Codex sẽ báo lỗi không tìm thấy model. Hãy thay bằng tên combo bạn đã tạo hoặc mã model lẻ.

Cách nhanh nhất: dùng script cài đặt

Script cài đặt sẽ hỏi API key, cho bạn chọn model hoặc combo, rồi ghi biến môi trường và file cấu hình Codex giúp bạn.

Trên Windows, mở PowerShell và chạy:

irm https://apicheap.store/setup.ps1 | iex

Nếu bạn quen dùng CMD:

curl.exe -fsSL https://apicheap.store/setup.bat -o setup.bat && setup.bat

Trên macOS hoặc Linux, mở Terminal và chạy:

curl -fsSL https://apicheap.store/setup.sh | bash

Chạy xong, đóng terminal và mở lại để biến môi trường mới có hiệu lực. Nếu muốn tự tay kiểm soát từng dòng cấu hình, đọc tiếp phần thủ công bên dưới.

Cấu hình thủ công: file config.toml

Vị trí file cấu hình:

Nếu thư mục .codex chưa có, hãy tạo mới. Dán nội dung sau vào file:

model = "smart-live-combo"
model_provider = "quotarouter"

[model_providers.quotarouter]
name = "apicheap.store"
base_url = "https://apicheap.store/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
http_headers = { Authorization = "Bearer sk-YOUR_API_KEY" }

[agents.subagent]
model = "smart-live-combo"

Ý nghĩa từng dòng:

Đặt API key và file đăng nhập

Codex cần biết API key qua biến môi trường OPENAI_API_KEY.

Trên Windows (PowerShell, lưu vĩnh viễn cho tài khoản người dùng):

[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'sk-YOUR_API_KEY', 'User')

Trên macOS, thêm vào ~/.zshrc; trên Linux, thêm vào ~/.bashrc hoặc ~/.zshrc:

export OPENAI_API_KEY="sk-YOUR_API_KEY"

Riêng Codex App cần thêm file auth.json để hiển thị trạng thái đã đăng nhập. File nằm cùng thư mục với config.toml (%USERPROFILE%\.codex\auth.json hoặc ~/.codex/auth.json):

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-YOUR_API_KEY"
}

Bạn cũng có thể đăng nhập nhanh bằng lệnh, Codex sẽ tự ghi thông tin xác thực:

echo sk-YOUR_API_KEY | codex login --with-api-key

Sau đó mở terminal mới và gõ codex để bắt đầu.

Kiểm tra kết nối trước khi làm việc thật

Trước khi giao việc lớn cho Codex, nên thử gọi thẳng API để chắc chắn key và tên model đều đúng. Lệnh sau liệt kê các model và combo mà key của bạn được phép gọi:

curl https://apicheap.store/v1/models \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

Tiếp theo, gửi một request nhỏ tới chính route mà Codex dùng:

curl https://apicheap.store/v1/responses \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "smart-live-combo", "input": "Hello"}'

Nếu nhận về câu trả lời, cấu hình phía máy chủ đã ổn; lỗi còn lại (nếu có) nằm ở file cấu hình trên máy bạn.

Đổi model hoặc combo bất kỳ lúc nào

Sau khi cài xong, bạn có thể đổi model linh hoạt theo từng việc:

  1. Codex CLI: thêm cờ -m khi chạy, ví dụ codex -m smart-live-combo hoặc codex -m gpt-4o.
  2. Codex App: bấm vào thanh chọn model ở góc dưới cửa sổ và chọn model khác.
  3. Đổi mặc định: mở config.toml và sửa dòng model = "tên_model_mới".

Gợi ý chọn model: việc đọc hiểu code, sửa nhiều file và gọi tool nên dùng model mạnh; việc đơn giản như đổi tên biến, viết comment hay tóm tắt log có thể dùng model rẻ hơn để tiết kiệm số dư. Giá từng model xem ở bảng giá trên trang chủ.

Vì sao nên dùng combo với Codex

Codex thường chạy những phiên dài: đọc nhiều file, gọi tool liên tục, đôi khi chia việc cho tác vụ con. Nếu model duy nhất bạn chọn đang bận hoặc tạm dừng giữa chừng, phiên làm việc dễ bị gián đoạn. Combo là nhóm nhiều model; khi một model gặp sự cố, hệ thống tự chuyển sang model kế tiếp trong combo, nên bạn ít phải khởi động lại phiên. Tài liệu tại /docs cũng khuyến khích tạo combo để công việc ổn định hơn.

Xử lý lỗi thường gặp

Lỗi 401. Thiếu API key, key sai hoặc đã bị vô hiệu hoá. Kiểm tra OPENAI_API_KEY bằng echo $env:OPENAI_API_KEY (PowerShell) hoặc echo $OPENAI_API_KEY (macOS/Linux): giá trị phải bắt đầu bằng sk-, không thừa dấu cách. Nhớ cập nhật cả key trong http_headers và auth.json nếu bạn vừa tạo key mới.

Lỗi 404, không tìm thấy model. Tên trong model gõ sai, hoặc bạn dùng tên combo mẫu mà chưa tạo combo đó. Gọi GET /v1/models như ở trên để lấy đúng tên.

Lỗi 429. Gửi quá nhiều request trong thời gian ngắn. Đợi theo header retry-after rồi thử lại, và giảm số phiên Codex chạy song song.

Lỗi 503. Model đang tạm dừng hoặc bảo trì. Đổi sang model hay combo khác.

Codex App vẫn báo chưa đăng nhập. Thiếu hoặc sai file auth.json. Kiểm tra file nằm đúng thư mục .codex và là JSON hợp lệ, hoặc chạy lại lệnh codex login --with-api-key.

Sửa cấu hình mà Codex không nhận. Đóng hẳn Codex App hoặc terminal cũ rồi mở lại; biến môi trường mới chỉ có hiệu lực ở cửa sổ mở sau khi đặt.

Tóm tắt

Để Codex chạy qua apicheap.store, bạn chỉ cần: chọn model hoặc tạo combo trong trang quản lý, khai báo nhà cung cấp trong config.toml với base_url có /v1 và wire_api = "responses", đặt OPENAI_API_KEY, rồi thêm auth.json nếu dùng Codex App. Toàn bộ thông số chính thức và các ví dụ cho công cụ khác nằm trong trang tài liệu kết nối.

Dùng thử API AI tại apicheap.store

Một API key dùng chung cho nhiều model, tương thích chuẩn OpenAI và Anthropic, nạp tiền bằng VietQR hoặc USDT.

Tạo tài khoản Xem hướng dẫn kết nối

Bài viết khác