Codex CLI

Codex CLI là agent lập trình dòng lệnh chính thức của OpenAI, định nghĩa nhà cung cấp mô hình qua ~/.codex/config.toml. Trỏ provider tùy chỉnh về aicentos, là có thể dùng các mô hình aicentos tích hợp ngay trong terminal.

Nếu bạn muốn quản lý nhiều bộ cấu hình bằng giao diện đồ hoạ hơn, cũng có thể đi theo CC Switch để chuyển một chạm; bài này chỉ nói cấu hình thủ công.

Chuẩn bịSao chép liên kết neo

Trước tiên, tạo một Key riêng cho Codex CLI tại trang "API Key" trong Console (khuyến nghị đặt tên codex-cli để dễ theo dõi mức sử dụng):

• Console: https://aicentos.com
• Tạo Key: https://aicentos.com/keys
• Nạp tiền khi hết số dư: https://aicentos.com/wallet

Xác nhận đã cài Codex CLI:

codex --version

Cấu hình cần điềnSao chép liên kết neo

Các bước thiết lậpSao chép liên kết neo

1. Thiết lập biến môi trường API KeySao chép liên kết neo

export AICENTOS_API_KEY="sk-API-Key-của-bạn"

Muốn hiệu lực vĩnh viễn thì ghi vào ~/.zshrc hoặc ~/.bashrc, rồi source một lần, và dùng echo $AICENTOS_API_KEY để xác nhận.

2. Sửa config.tomlSao chép liên kết neo

Thêm vào ~/.codex/config.toml:

model = "tên-mô-hình-của-bạn"
model_provider = "aicentos"

[model_providers.aicentos]
name = "aicentos"
base_url = "https://aicentos.com/v1"
env_key = "AICENTOS_API_KEY"
wire_api = "responses"

Thay tên-mô-hình-của-bạn bằng tên mô hình được liệt kê trong "Model Square" của Console, có thể tham khảo Các mô hình hỗ trợ.

3. Khởi động CodexSao chép liên kết neo

codex

Gửi một yêu cầu đơn giản, xác nhận provider hoạt động bình thường.

Kiểm traSao chép liên kết neo

codex exec "Trả lời trong một câu: 1+1 bằng mấy"

Trả về nội dung bình thường nghĩa là kết nối thành công, nội dung trả về sẽ tiêu tốn một ít hạn mức, có thể đối chiếu trong log sử dụng của Console.

Lưu ýSao chép liên kết neo

• Base URL chỉ điền đến /v1, đừng bổ sung thành đường dẫn đầy đủ /v1/chat/completions.
• Các trường như base_url, env_key chỉ có hiệu lực trong ~/.codex/config.toml cấp người dùng. .codex/config.toml ghi trong dự án sẽ bị bỏ qua, và có thể xuất hiện cảnh báo khi khởi động.
• wire_api điền responses, tương ứng với giao diện Responses của aicentos. Tài liệu chính thức hiện chỉ hỗ trợ giá trị này; nếu bản của bạn báo unknown variant, nghĩa là CLI quá cũ, khuyến nghị nâng cấp trước.
• openai, ollama, lmstudio là các provider ID được bảo lưu, không thể sửa base_url của openai tích hợp sẵn để trỏ về gateway bên thứ ba, bắt buộc phải đặt tên provider mới (bài này dùng aicentos).
• Thứ tự xử lý sự cố: tên mô hình có khớp với Console không → Base URL có dừng ở /v1 không → biến môi trường có hiển thị trong terminal khởi động codex không → số dư tài khoản có đủ không.

Liên kết liên quanSao chép liên kết neo

• Kết nối Codex (cách CC Switch)