# Codex CLI

Nguồn: https://docs.aicentos.com/vi/clients/codex-cli

Language: vi

> Dùng aicentos trong Codex CLI —— cấu hình thủ công model_providers trong config.toml

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](https://docs.aicentos.com/vi/clients/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ị

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](https://aicentos.com)
* Tạo Key: [https://aicentos.com/keys](https://aicentos.com/keys)
* Nạp tiền khi hết số dư: [https://aicentos.com/wallet](https://aicentos.com/wallet)

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

```bash
codex --version
```

## Cấu hình cần điền

| Trường                  | Giá trị                                      |
| ----------------------- | -------------------------------------------- |
| Provider ID             | `aicentos`                                   |
| Tên Provider            | `aicentos`                                   |
| Biến môi trường API Key | `AICENTOS_API_KEY`                           |
| Base URL                | `https://aicentos.com/v1`                    |
| Mô hình                 | tên mô hình trong "Model Square" của Console |

## Các bước thiết lập

### 1. Thiết lập biến môi trường API Key

```bash
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.toml

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

```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ợ](https://docs.aicentos.com/vi/billing/models-list).

### 3. Khởi động Codex

```bash
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 tra

```
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 ý

* **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](https://docs.aicentos.com/vi/api/chat/openai/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 quan

* [Kết nối Codex (cách CC Switch)](https://docs.aicentos.com/vi/clients/codex)