# Codex + nhà cung cấp của bạn

Gán nhà cung cấp mô hình riêng cho một cấu hình khởi chạy Codex, hoặc dùng profile Codex bạn đã có.

## Chuẩn bị thông tin nhà cung cấp

Cài Codex và lấy base URL, khóa API và ID mô hình từ nhà cung cấp. Endpoint phải hỗ trợ OpenAI Responses API; chỉ tương thích Chat Completions là không đủ.

Ví dụ này thêm `Codex · work` mà không đổi các mục Codex khác và không sửa cấu hình toàn cục của Codex.

Đã có profile Codex? Hãy chuyển tới [Dùng profile Codex có sẵn](https://facadecode.com/vi/docs/providers/codex/#profile).

## 1. Định nghĩa nhà cung cấp

Thêm cấu hình này vào facade.json (xem [Cài đặt agent](https://facadecode.com/vi/docs/settings/)). Thay base URL, khóa và ID mô hình trong ví dụ:

```json
{
  "clis": {
    "Codex · work": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "args": [
        "-c",
        "model_provider=work",
        "-c",
        "model_providers.work.name=Work",
        "-c",
        "model_providers.work.base_url=https://api.example.com/v1",
        "-c",
        "model_providers.work.wire_api=responses",
        "-c",
        "model_providers.work.env_key=WORK_API_KEY"
      ],
      "env": {
        "WORK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

Dùng cùng ID nhà cung cấp, `work`, trong `model_provider=work` và mọi cài đặt `model_providers.work.…`. Tên biến của khóa, `WORK_API_KEY`, phải khớp với `env_key`.

## 2. Kiểm tra các cài đặt nhà cung cấp

| Cài đặt | Tác dụng |
| --- | --- |
| `model_provider=work` | Chọn nhà cung cấp được định nghĩa trong nhóm cài đặt work. |
| `model_providers.work.name` | Đặt tên hiển thị cho nhà cung cấp đó. |
| `model_providers.work.base_url` | Đặt base URL của API. |
| `model_providers.work.wire_api=responses` | Dùng định dạng Responses API. |
| `model_providers.work.env_key=WORK_API_KEY` | Cho Codex biết biến môi trường nào chứa khóa. |
| `env.WORK_API_KEY` | Cung cấp khóa đó cho tiến trình Codex. |

Mỗi `-c` đặt một tùy chọn Codex cho các agent khởi chạy bằng mục này.

Ví dụ lưu khóa trong facade.json. Nếu khóa đã có trong một biến môi trường, hãy đặt `env.WORK_API_KEY` thành `${env:WORK_API_KEY}`. Trình soạn thảo phải có biến đó trước khi agent khởi chạy.

## 3. Khởi chạy Codex với cấu hình này

Lưu facade.json, chọn **New Agent** và chọn `Codex · work`. Dùng `/model` để kiểm tra mô hình đã chọn, rồi gửi một nhiệm vụ ngắn cho dự án.

Nếu nhà cung cấp báo cáo mức sử dụng, hãy xác nhận yêu cầu xuất hiện ở đúng tài khoản. Để kiểm tra cấu hình khởi chạy, chạy **Show Agent Launch** và chọn vị trí làm việc. Tìm mục này trong báo cáo để xem agent tiếp theo sẽ khởi chạy thế nào với cài đặt hiện tại.

Với lỗi yêu cầu, xem [Khắc phục sự cố](https://facadecode.com/vi/docs/troubleshooting/).

## Ví dụ: QwenCloud

Với khóa QwenCloud Token Plan, dùng `https://token-plan.maas.qwencloudapi.com/compatible-mode/v1` làm base URL và giữ `wire_api=responses`. Chọn mô hình có trong gói của bạn. Khóa trả theo mức sử dụng dùng endpoint của khu vực tương ứng.

[Cài đặt Codex hiện hành của QwenCloud ↗](https://docs.qwencloud.com/developer-guides/clients-and-developer-tools/codex)

## Dùng profile Codex có sẵn

Nếu bạn đã dùng một profile Codex, hãy chọn nó qua đối số của mục:

```json
{
  "clis": {
    "Codex · profile": {
      "type": "codex",
      "args": [
        "--profile",
        "work"
      ]
    }
  }
}
```

Thay `work` bằng profile bạn dùng. Giữ cấu hình nhà cung cấp trong profile đó thay vì lặp lại trong mục Facade. Lưu lại, chọn **New Agent** và chọn `Codex · profile`. Gửi một nhiệm vụ ngắn và xác nhận yêu cầu trong bản ghi mức sử dụng của nhà cung cấp, nếu có.