Tích hợp

Dùng Codex CLI với API key riêng: cấu hình config.toml từng bước

Chạy Codex CLI bằng API key STEYG Code thay cho tài khoản OpenAI: khai báo model provider trong ~/.codex/config.toml, đọc key bằng env_key, chọn model GPT đang bán và ước tính chi phí mỗi bước agent.

6 phút

Codex CLI gọi model qua đâu?

Codex CLI gửi request theo giao thức Responses API của OpenAI. Mặc định nó dùng tài khoản OpenAI của bạn; khai báo một model provider riêng trong ~/.codex/config.toml thì toàn bộ request đi sang gateway khác, còn cách dùng Codex trong terminal giữ nguyên.

STEYG Code phục vụ Responses API tại https://steyg.one/api/v1, cùng base URL với các client OpenAI-compatible. Chi phí trừ vào ngân sách USD trả trước bằng VND, dùng chung một key với Claude Code, Cursor hay Cline (cấu hình Claude Code ở bài dùng Claude Code với API key riêng).

Khai báo STEYG Code trong config.toml

Mở ~/.codex/config.toml (tạo mới nếu chưa có) và thêm khối dưới đây. env_key cho Codex biết đọc API key từ biến môi trường nào, nên key không nằm trong file; tài liệu Codex cũng khuyên tránh cách nhúng thẳng token vào file. Model id trong khối được lấy từ danh mục đang bán lúc tải trang.

Đặt khối này ở file của người dùng: Codex bỏ qua model_provider và model_providers trong .codex/config.toml của project. Id provider cũng không được trùng id có sẵn (openai, ollama, lmstudio), vì vậy khối dưới dùng id steyg.

~/.codex/config.toml
model = "gpt-6.1-sol"
model_provider = "steyg"

[model_providers.steyg]
name = "STEYG Code"
base_url = "https://steyg.one/api/v1"
env_key = "STEYG_CODE_API_KEY"
wire_api = "responses"
Model id đọc từ danh mục đang bán lúc 02:04 20/10/2026: gpt-6.1-sol. API key đọc từ biến môi trường STEYG_CODE_API_KEY, không ghi vào file.

Đặt API key rồi chạy thử

Tạo API key trong trang STEYG Code và đưa nó vào biến môi trường STEYG_CODE_API_KEY của terminal sẽ chạy Codex, đọc từ keychain hay trình quản lý mật khẩu thay vì dán vào file trong repository. Sau đó mở một repository, chạy codex và giao một việc nhỏ để chắc kết nối đúng.

Request chạy xong thì token, model và chi phí hiện trong usage của dashboard. Đổi model là sửa một dòng model trong file; danh sách id key của bạn được gọi có ở GET /api/v1/models.

Chọn model GPT và ước tính chi phí mỗi bước

Codex gửi lại gần hết ngữ cảnh làm việc ở mỗi bước, nên đơn giá cache hit quyết định phần lớn hoá đơn. Bảng dưới tính một bước minh hoạ gồm 150.000 token cache hit, 30.000 token input mới và 4.000 token output cho từng model GPT đang bán, theo đơn giá đang áp.

Đây là giả định để so sánh, không phải số đo của bạn. Đơn giá đầy đủ của mọi model, quy ra tiền Việt, có ở bài bảng giá API GPT, Claude theo token.

ModelMột bước (USD)Một bước qua gói StarterSố bước với $5 dùng thử
GPT 6 Astragpt-6-astra$0.65≈965đ7 bước
GPT 6 Lunagpt-6-luna$0.0065≈10đ769 bước
GPT 6.1 Solgpt-6.1-sol$0.12≈171đ43 bước
Đọc từ bảng giá đang bán lúc 02:04 20/10/2026 (giờ Việt Nam). Bước minh hoạ: 150.000 token cache hit + 30.000 token input + 4.000 token output. Đây là giả định để so sánh model, không phải số đo.

Lỗi thường gặp

Phần lớn lỗi khi nối Codex với gateway rơi vào vài trường hợp sau:

  • 401: biến STEYG_CODE_API_KEY chưa có trong phiên terminal đang chạy Codex, hoặc key đã bị xoá.
  • 402: ngân sách đã hết. Gateway dừng thay vì tính vượt; mua thêm ngân sách hoặc nâng gói, key giữ nguyên.
  • “Requested model … is not available in STEYG Code”: lỗi nêu đúng id mà dòng model đã gửi và id đó không có trong danh mục; đối chiếu với GET /api/v1/models.
  • Ứng dụng Codex mở từ Dock hay Start menu có thể không đọc được biến môi trường của shell; khi đó chạy Codex từ terminal hoặc làm theo mẫu cấu hình trong trang STEYG Code.
  • Muốn thử trước khi trả tiền: tài khoản mới có $5 ngân sách dùng thử trong 7 ngày, không cần thẻ.

Tạo API key miễn phí

Tài khoản mới có $5 ngân sách dùng thử trong 7 ngày, không cần thẻ. Một key cho mọi coding agent.

Tạo API key miễn phí

Nội dung được Hộ kinh doanh Truyền thông & Công nghệ STEYG soát lần cuối 2026-10-19. Xem thêm tài liệu API.