# Codex

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

Language: vi

> Dùng aicentos trong Codex —— nhập một chạm bằng CC Switch, hoặc cấu hình thủ công config.toml

Codex tương thích giao thức OpenAI, chỉ cần trỏ nhà cung cấp mô hình về aicentos là có thể dùng toàn bộ mô hình aicentos tích hợp.

Dưới đây có hai cách kết nối: **quản lý một chạm bằng CC Switch** (khuyến nghị), hoặc **tự sửa config.toml bằng tay**.

## Cách một: dùng CC Switch (khuyến nghị)

CC Switch cũng hỗ trợ quản lý cấu hình Provider của Codex, nhiều bộ cấu hình chuyển đổi một chạm.

Xem chi tiết tại [Kết nối CC Switch →](https://docs.aicentos.com/vi/clients/cc-switch)

## Cách hai: cấu hình thủ công

### Thông tin cần chuẩn bị

| Mục                          | Giá trị                   |
| ---------------------------- | ------------------------- |
| Provider ID                  | `aicentos`                |
| Tên Provider                 | `aicentos`                |
| Base URL                     | `https://aicentos.com/v1` |
| Biến môi trường chứa API Key | `AICENTOS_API_KEY`        |

Trước tiên, tạo một Key chuyên dụng tại trang "API Key" trong Console, khuyến nghị đặt tên có chữ `codex` để dễ theo dõi mức sử dụng.

### Thiết lập API Key

Cấu hình biến môi trường trong terminal:

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

Muốn lưu lâu dài thì thêm vào `~/.zshrc` hoặc `~/.bashrc`, rồi tải lại:

```bash
source ~/.zshrc
```

Xác nhận biến đã có hiệu lực:

```bash
echo $AICENTOS_API_KEY
```

### Cấu hình Provider cho Codex

Sửa `~/.codex/config.toml`, thêm vào:

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

### 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.

## Xử lý sự cố

Khi yêu cầu thất bại, đối chiếu output terminal của Codex và nhật ký mức sử dụng trong Console để xử lý sự cố. Các nguyên nhân thường gặp:

* Tên mô hình ghi sai (lấy "Model Square" làm chuẩn).
* Định dạng Base URL không đúng (chỉ điền đến `/v1`, đừng thêm thừa đường dẫn).
* Biến môi trường không được terminal hiện tại đọc vào (mở lại terminal hoặc `source` file cấu hình).