Codex CLI: Thiết lập khóa API và nhà cung cấp tùy chỉnh

Sử dụng hướng dẫn này để kết nối công việc Codex CLI trên máy cục bộ với AI Prime Tech. Bạn cần có tài khoản cổng API, khóa đang hoạt động trong nhóm Codex dự định sử dụng và mô hình mà khóa đó có thể truy cập. Hãy bắt đầu với tổng quan về Codex API nếu bạn vẫn đang chọn loại truy cập.

1. Kiểm tra khóa và nhóm

Tạo khóa trong bảng điều khiển. Quyền truy cập GPT trả trước sử dụng nhóm Codex nhóm. Nếu có cung cấp quyền truy cập Codex theo thời hạn, hãy sử dụng nhóm và điều khoản được hiển thị cho gói đó; quyền truy cập Claude được cung cấp riêng. Xác nhận danh sách mô hình cho khóa bạn sẽ sử dụng.

Đặt khóa trong terminal hiện tại. Thay thế giá trị giữ chỗ trên máy cục bộ; không commit khóa vào kho mã.

PowerShell

$env:AIPRIMETECH_API_KEY = "YOUR_GATEWAY_KEY"

bash hoặc zsh

export AIPRIMETECH_API_KEY="YOUR_GATEWAY_KEY"

Khởi động lại terminal hoặc trình soạn thảo đã được mở trước khi bạn thiết lập môi trường của nó nếu ứng dụng không nhận được biến. Các ví dụ này đặt biến cho tiến trình hiện tại và các tiến trình con của nó.

2. Cấu hình nhà cung cấp

Hợp nhất cấu hình này vào tệp ở cấp người dùng ~/.codex/config.toml. Trên Windows, đường dẫn tương đương là %USERPROFILE%\.codex\config.toml. Thông tin xác thực của nhà cung cấp phải nằm trong cấu hình người dùng, không phải trong tệp sau của kho mã: .codex/config.toml.

model_provider = "aiprimetech"
model = "gpt-6.1-sol"

[model_providers.aiprimetech]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIMETECH_API_KEY"
wire_api = "responses"
supports_websockets = false

Sử dụng ID nhà cung cấp như aiprimetech và giữ model_provider khớp với bảng cấu hình tương ứng. Codex hiện tại sử dụng giao thức Responses. URL cơ sở là gốc /v1 của cổng API; Codex thêm đường dẫn yêu cầu. Cấu hình này sử dụng phương thức truyền tải HTTP/SSE.

3. Xác minh kết nối

Chạy codex doctor để kiểm tra cấu hình CLI của bạn. Khởi động codex, sau đó sử dụng /status để xác nhận nhà cung cấp và mô hình. Yêu cầu một câu trả lời ngắn trước khi cho phép thực hiện tác vụ lớn hơn trên kho mã. Kiểm tra xem yêu cầu có xuất hiện trên trang sử dụng AI Prime Tech của bạn hay không.

Bạn có thể kiểm tra danh sách mô hình của khóa độc lập với Codex:

Invoke-RestMethod -Uri "https://aiprimetech.io/v1/models" -Headers @{Authorization="Bearer $env:AIPRIMETECH_API_KEY"}

curl --fail-with-body https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $AIPRIMETECH_API_KEY"

Nếu danh mục trả về có mô hình của bạn nhưng yêu cầu thất bại, hãy kiểm tra lỗi thực tế và khả năng cung cấp hiện tại của nhóm. Chỉ có ID trong danh sách chưa đủ để xác nhận thử nghiệm suy luận thành công.

Duy trì hồ sơ CLI tùy chọn

Để chỉ chọn nhà cung cấp này cho những phiên CLI cụ thể, hãy đặt cấu hình ở trên vào ~/.codex/aiprimetech.config.toml và khởi chạy:

codex --profile aiprimetech

Trong Codex 0.134.0 trở lên, hồ sơ CLI sử dụng các tệp riêng biệt. Các ví dụ cũ dùng [profiles.aiprimetech] không phải là định dạng hồ sơ hiện tại. Tiện ích mở rộng IDE sử dụng cấu hình ở cấp người dùng; hãy xác minh nhà cung cấp đang hoạt động sau khi khởi động lại tiện ích, thay vì giả định rằng việc chuyển hồ sơ CLI cũng đã được áp dụng ở đó.

Chọn mô hình

Sử dụng gpt-6.1-sol làm điểm khởi đầu cho việc lập trình, gpt-6-astra cho các tác vụ đòi hỏi cao, hoặc gpt-6-luna cho công việc có phạm vi tập trung. gpt-6-sol là một ID riêng dành cho các quy trình Sol hiện có. Xem chi tiết mô hình và cách so sánh chúng.

Khắc phục sự cố

Dấu hiệu	Kiểm tra
Thiếu biến môi trường	Đặt `AIPRIMETECH_API_KEY` trong tiến trình khởi chạy Codex.
Lỗi xác thực 401	Xác nhận khóa đang hoạt động, đã được sao chép đầy đủ và do cổng này cấp.
403 hoặc mô hình không khả dụng	Xác nhận nhóm khóa, quyền truy cập của gói và ID mô hình chính xác.
404 hoặc phản hồi HTML	Sử dụng `https://aiprimetech.io/v1`; xóa phần trùng lặp `/v1` hoặc phần được nối thêm `/responses`.
`wire_api` bị từ chối	Sử dụng `responses`; các ví dụ cũ về `chat` nhà cung cấp đã lỗi thời.
Lỗi số dư, gói hoặc giới hạn tốc độ	Đọc thông báo lỗi, kiểm tra tài khoản và giảm số tác vụ đồng thời trước khi thử lại.
Kết nối kết thúc giữa chừng khi đang nhận phản hồi	Thử một yêu cầu ngắn, kiểm tra kết nối mạng/proxy và ghi lại ID yêu cầu để được hỗ trợ.

Claude và các tính năng Codex được lưu trữ trên đám mây

Để dùng Claude thông qua cơ chế chuyển đổi Responses của cổng, hãy làm theo Claude với Codex bằng một khóa tương thích thuộc nhóm Claude. Ví dụ GPT ở trên dành cho quyền truy cập nhóm Codex.

Quyền truy cập cổng không cung cấp quyền sử dụng không gian làm việc ChatGPT hay quyền truy cập Codex trên đám mây. Xem so sánh các cách đăng nhập để hiểu phạm vi của từng sản phẩm.