Hướng dẫn kết nối OpenAI Codex qua trung gian: Cấu hình Base URL tùy chỉnh cho GPT
Hướng dẫn kết nối tác nhân lập trình terminal OpenAI Codex (Codex CLI): Cài đặt, cấu hình Base URL tùy chỉnh và khóa thông qua biến môi trường hoặc config.toml để sử dụng mô hình GPT.
I. Codex là gì
OpenAI Codex (Codex CLI) là tác nhân (agent) lập trình trên terminal chính thức của OpenAI, hỗ trợ các điểm cuối API tùy chỉnh. Bằng cách trỏ nó vào cổng OpenAI tương thích của trang web chúng tôi, bạn có thể sử dụng các dòng mô hình GPT cùng với khóa sk- của mình.
II. Cài đặt Codex CLI
npm install -g @openai/codexSau khi cài đặt, hãy nhập codex vào terminal; sử dụng codex --model gpt-5.5 hoặc chọn mô hình trong giao diện tương tác để chuyển đổi mô hình.
III. Cấu hình Codex
① Biến môi trường (Nhanh nhất)
export OPENAI_BASE_URL="https://www.relay-api.com/v1"
export OPENAI_API_KEY="sk-khóa_của_bạn"
codex --model gpt-5.5② config.toml (Khuyên dùng, thuận tiện cho sử dụng lâu dài)
# ~/.codex/config.toml
[model_providers.myrelay]
name = "Cổng chuyển tiếp API siêu thông minh"
base_url = "https://www.relay-api.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
[model]
model_provider = "myrelay"
model = "gpt-5.5"Sau khi lưu, hãy chạy codex --model gpt-5.5 là xong.
IV. Đối chiếu địa chỉ giao diện (API)
| Nhóm mô hình | Cổng vào của chúng tôi (Base URL) | Giao thức |
|---|---|---|
| Claude / Anthropic | https://www.relay-api.com | Anthropic Messages |
| GPT / OpenAI | https://www.relay-api.com/v1 | OpenAI Chat Completions |
| Gemini | https://www.relay-api.com/v1beta | Google generateContent |
V. Khắc phục sự cố thường gặp
| Hiện tượng | Xử lý |
|---|---|
| 401 / 403 | Khóa không hợp lệ, chưa được kích hoạt hoặc không đủ số dư; hãy xác nhận khóa sk- chính xác và nạp thêm tiền. |
| 404 / Mô hình không khả dụng | Tên mô hình không khớp với slug của nền tảng hoặc mô hình chưa được bật; hãy kiểm tra lại ID mô hình. |
| Unknown model | ID mô hình đã nhập phải chính xác (bao gồm cả chữ hoa/thường), hãy kiểm tra lại tại danh mục mô hình. |
Khuyến nghị bảo mật: Không viết khóa vào kho mã nguồn công khai, hãy sử dụng .env hoặc biến môi trường; các tác vụ tạo nội dung tiêu tốn nhiều token, hãy chú ý số dư.
Giải thích về Base URL: Trang web chúng tôi chấp nhận cả /v1beta/models/... và /v1beta/v1beta/models/... (cũng như /v1/... và /v1/v1/...), vì vậy việc client tự bổ sung /v1 hoặc /v1beta không ảnh hưởng đến việc gọi API: Bạn có thể nhập địa chỉ root của tên miền hoặc địa chỉ có kèm /v1beta đều sử dụng được. Vui lòng tra cứu và sao chép ID mô hình trong phần "ID mô hình" ở góc trên bên phải trang "Token" trên bảng điều khiển.