# Codex

> Dùng Codex với khoá KONG API AI. Thêm KONG API AI vào file config.toml của Codex và đặt khoá trong biến môi trường, trên macOS, Linux hoặc Windows.

Source: https://kongapiai.com/docs/codex

Codex gửi yêu cầu tới KONG API AI khi bạn khai báo KONG API AI trong file cấu hình của Codex. Trên Windows, [Kong Connect](https://kongapiai.com/docs/kong-connect) làm các bước này giúp bạn.

## Cài Codex

Làm theo hướng dẫn cài đặt tại [github.com/openai/codex](https://github.com/openai/codex).

## Cách nhanh: một lệnh

Lệnh dưới đây hỏi khoá của bạn mà không hiện lên màn hình, kiểm tra khoá với KONG API AI, rồi ghi cấu hình cho Claude Code và Codex như các bước bên dưới. File cũ được sao lưu trước khi sửa.

macOS hoặc Linux:

```bash
curl -fsSL https://kongapiai.com/install.sh | bash
```

Windows, trong PowerShell:

```powershell
irm https://kongapiai.com/install.ps1 | iex
```

Để gỡ ra, chạy `curl -fsSL https://kongapiai.com/install.sh | bash -s -- --remove`, hoặc trên Windows chạy `$env:KONG_ACTION='remove'` rồi chạy lại lệnh cài. Muốn xem lệnh làm gì trước khi chạy, mở địa chỉ của lệnh trong trình duyệt.

## Thêm KONG API AI vào Codex

Mở hoặc tạo file `~/.codex/config.toml` (trên Windows: `%USERPROFILE%\.codex\config.toml`) và thêm:

```toml
model_provider = "kong"
model = "gpt-6-astra"

[model_providers.kong]
name = "KONG API AI"
base_url = "https://kongapiai.com/v1"

[model_providers.kong.auth]
command = "sh"
args = ["-c", "echo $KONG_API_KEY"]
```

Trên Windows, thay phần `auth` bằng:

```toml
[model_providers.kong.auth]
command = "powershell"
args = ["-NoProfile", "-Command", "Write-Output $env:KONG_API_KEY"]
```

Codex cũng nhận `env_key = "KONG_API_KEY"` thay cho phần `auth`, nhưng khi đó Codex không đọc danh sách model của KONG API AI và có thể báo "Unknown model".

## Đặt khoá

macOS hoặc Linux: thêm vào `~/.zshrc`, `~/.bashrc` hoặc `~/.config/fish/config.fish`:

```bash
export KONG_API_KEY="gw_live_…"
```

Windows: chạy lệnh dưới đây một lần, cho tài khoản của bạn:

```powershell
setx KONG_API_KEY "gw_live_…"
```

Sau đó thoát hẳn Codex, kể cả app Codex trên máy, rồi mở lại. App Codex không thấy biến chỉ đặt trong một cửa sổ terminal.

## Bắt đầu

```bash
cd /đường-dẫn/tới/dự-án
codex
```

Sau vài yêu cầu, bạn thấy chúng trong trang [Hoạt động](https://kongapiai.com/app#activity) của console.

## Đổi model

Đổi giá trị `model` trong `config.toml` thành một model khác mà khoá được dùng. Xem danh sách tại [Model và giá](https://kongapiai.com/docs/models). Codex chỉ dùng được model của OpenAI.

## Khi có lỗi

- **Lỗi 401, không có khoá:** lệnh trong phần `auth` không chạy được, hoặc chưa đặt `KONG_API_KEY`. Trên Windows, dùng phần `auth` cho PowerShell, đặt khoá bằng `setx`, rồi mở lại Codex.
- **Lỗi 401, khoá sai:** Codex đã gửi một khoá khác, ví dụ `OPENAI_API_KEY`. Kiểm tra lại `model_provider = "kong"`.
- **Không tìm thấy model:** kiểm tra tên model ở trang [Model và giá](https://kongapiai.com/docs/models), và khoá có được dùng model đó không.
- **Lỗi 402:** hết số dư hoặc hết hạn mức tháng của khoá. Xem [Hạn mức và cách chọn nguồn](https://kongapiai.com/docs/limits).
