Cấu hình Codex CLI cho GetAPI.ONE

Cài Codex CLI từ nguồn chính thức, giữ khóa ONE trong biến môi trường, cấu hình nhà cung cấp tùy chỉnh tương thích Responses và xác minh kết nối đang hoạt động.

Phạm vi và điều kiện tiên quyết

Hướng dẫn này dành cho Codex CLI trong dòng lệnh. Nó không xác nhận khả năng tương thích của mọi ứng dụng máy tính, tiện ích IDE, mô hình hoặc tính năng Codex.

Tài khoản GetAPI.ONE có số dư sử dụng được hoặc gói phù hợp.
Khóa GetAPI.ONE có tên và phạm vi giới hạn, được lưu riêng tư.
Mô hình chọn từ danh mục hiện tại có liệt kê rõ điểm cuối Responses.
Quyền cài Codex CLI và chỉnh sửa cấu hình Codex cấp người dùng.

1. Cài đặt và xác định Codex CLI

Dùng trang Codex CLI chính thức hiện tại để lấy trình cài đặt phù hợp hệ điều hành. Trình cài đặt độc lập macOS/Linux chính thức được rà soát ngày 2026-09-07 dùng lệnh bên dưới. Người dùng Windows nên làm theo thẻ Windows trên trang chính thức thay vì chạy lệnh shell Unix mà chưa kiểm tra.

Trình cài đặt chính thức macOS / Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Xác nhận lệnh đã cài đặt

codex --version

2. Nạp khóa vào dòng lệnh

Đặt khóa cho shell hiện tại trước khi chạy Codex. Các ví dụ này cố ý chứa giá trị giữ chỗ.

Shell macOS / Linux

export GETAPI_ONE_API_KEY="replace-with-your-private-key"

Tiến trình PowerShell hiện tại

$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"

3. Cấu hình nhà cung cấp ONE

Mở config.toml Codex cấp người dùng (thường nằm trong thư mục .codex) và thêm nhà cung cấp bên dưới. Thay YOUR_RESPONSES_MODEL bằng mô hình hiện tại trong danh mục GetAPI.ONE công bố rõ điểm cuối Responses.

config.toml cấp người dùng

model_provider = "getapi_one"
model = "YOUR_RESPONSES_MODEL"

[model_providers.getapi_one]
name = "GetAPI One"
base_url = "https://www.getapi.one/v1"
env_key = "GETAPI_ONE_API_KEY"
wire_api = "responses"

4. Chạy và xác minh

Mở cửa sổ dòng lệnh mới nếu đã lưu biến môi trường lâu dài; nếu không, giữ cửa sổ hiện tại nơi biến được đặt.
Mở thư mục dự án và chạy codex. Xác nhận nhà cung cấp/mô hình hiển thị khớp với cấu hình dự định.
Chỉ gửi một câu lệnh tối thiểu khi bạn chấp nhận khả năng bị tính phí.
Kiểm tra thành công cần phản hồi CLI hợp lệ và bản ghi yêu cầu hoặc mức sử dụng tương ứng trong bảng điều khiển GetAPI.ONE.

Khắc phục sự cố theo thứ tự

Triệu chứng	Các bước kiểm tra
codex: command not found	Xem lại trình cài đặt chính thức cho hệ điều hành và xác nhận thư mục cài đặt có trong PATH.
Thiếu khóa API	Xác nhận GETAPI_ONE_API_KEY tồn tại trong cùng môi trường khởi chạy Codex và env_key được viết chính xác.
401 / Unauthorized	Sao chép lại khóa ONE, xác nhận khóa được bật và được ghép với https://www.getapi.one/v1.
404 / đường dẫn không tương thích	Xác nhận /v1 vẫn nằm trong base_url và cổng API công bố /v1/responses.
Không tìm thấy mô hình	Thay giá trị giữ chỗ bằng tên danh mục chính xác mà nhóm khóa có thể truy cập và được đánh dấu cho điểm cuối Responses.
Cấu hình không thay đổi	Kiểm tra bạn đã sửa tệp cấp người dùng mà Codex tải, model_provider trỏ tới getapi_one và đã khởi động lại cửa sổ dòng lệnh/ứng dụng khách.