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

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.

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). Thay base URL, khóa và ID mô hình trong ví dụ:

{
  "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#

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

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 ↗

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:

{
  "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ó.