Hướng dẫn kết nối trung gian OpenAI Codex: Cấu hình Base URL tùy chỉnh để sử dụng GPT

Hướng dẫn kết nối đại lý lập trình đầu cuối OpenAI Codex (Codex CLI): Cách cài đặt, cấu hình Base URL tùy chỉnh và khóa API thông qua biến môi trường hoặc file config.toml để sử dụng các mô hình GPT.

I. Codex là gì?

OpenAI Codex (Codex CLI) là đại lý lập trình đầu cuối (terminal) chính thức của OpenAI, hỗ trợ tùy chỉnh các điểm cuối (endpoint) API. Bằng cách trỏ nó đến cổng kết nối (gateway) của trang web chúng tôi tương thích với OpenAI, bạn có thể sử dụng các dòng mô hình GPT với khóa sk- của mình.

II. Cài đặt Codex CLI

npm install -g @openai/codex

Sau khi cài đặt, hãy nhập codex vào terminal; sử dụng codex --model gpt-5.4 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.4

② config.toml (Khuyên dùng, thuận tiện cho việc sử dụng lâu dài)

# ~/.codex/config.toml
[model_providers.myrelay]
name = "Chuyển tiếp API cực nhanh"
base_url = "https://www.relay-api.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

[model]
model_provider = "myrelay"
model = "gpt-5.4"

Sau khi lưu, hãy chạy lệnh codex --model gpt-5.4 để bắt đầu.

IV. Đối chiếu địa chỉ giao diện (API)

Nhóm mô hìnhCổng vào của trang (Base URL)Giao thức
Claude / Anthropichttps://www.relay-api.comAnthropic Messages
GPT / OpenAIhttps://www.relay-api.com/v1OpenAI Chat Completions
Geminihttps://www.relay-api.com/v1betaGoogle generateContent

V. Khắc phục sự cố thường gặp

Hiện tượngCách xử lý
401 / 403Khóa không hợp lệ, chưa được kích hoạt hoặc hết số dư; hãy xác nhận lại khóa sk- và nạp tiền.
404 / Mô hình không khả dụngTê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; kiểm tra lại ID mô hình.
Unknown modelID mô hình được điền phải chính xác (bao gồm cả chữ hoa/thường), hãy kiểm tra lại tại danh sách mô hình.

Lời khuyên bảo mật: Không viết khóa API vào các kho lưu trữ 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 lưu ý số dư.