Codex CLI là gì?
Codex CLI là tác nhân mã hóa của OpenAI để làm việc với các kho lưu trữ, chỉnh sửa tệp, chạy lệnh và compcho phép các tác vụ phát triển từ thiết bị đầu cuối.
Hướng dẫn này giải thích cách định cấu hình Codex CLI với nhà cung cấp API tùy chỉnh TokenHub. Nó duy trì quy trình làm việc Codex trong khi tập trung các khóa API, mô hình compatible, nhật ký yêu cầu và việc sử dụng mã thông báo trong TokenHub. Các nhà cung cấp tùy chỉnh Codex sử dụng OpenAI Responses API thay vì Chat Completions thông thường, vì vậy việc lựa chọn mô hình phải tính đến Phản hồi, phát trực tuyến và hành vi gọi công cụ. Xác thực nhà cung cấp trong kho lưu trữ phi sản xuất, bắt đầu bằng các nhiệm vụ kiểm tra và giải thích, sau đó chỉ cho phép chỉnh sửa hoặc lệnh shell.
Codex có thể định tuyến yêu cầu mô hình qua cổng API OpenAI compatible tương thích của TokenHub. Giữ nguyên cách cài đặt chính thức, sau đó thay API key, Base URL và model ID.
Endpoint TokenHub dùng trong hướng dẫn này là https://us-api.tokenhub.com/v1/responses.
Khi nào nên dùng
Bắt đầu với repository nhỏ hoặc dự án thử nghiệm. Trước tiên yêu cầu công cụ đọc file, giải thích mã hoặc lập kế hoạch, rồi mới bật chỉnh sửa.
Cài đặt hoặc mở công cụ
Làm theo tài liệu chính thức của Codex để cài đặt hoặc mở công cụ. Nếu giao diện thay đổi, ưu tiên tài liệu hiện tại.
Với công cụ CLI, hãy kiểm tra executable trước khi thêm thông tin xác thực TokenHub:
codex --versionChuẩn bị thông tin xác thực TokenHub
Tạo TokenHub API key và chọn một mô hình phù hợp từ danh sách mô hình TokenHub.
export TOKENHUB_API_KEY="sk-..."Lưu key trong shell cục bộ, kho bí mật của IDE hoặc trường API key an toàn của công cụ. Không commit key vào repository.
Cấu hình nhà cung cấp TokenHub
Trong phần Models, Providers, API Keys hoặc OpenAI Compatible, nhập các giá trị dưới đây.
Giá trị provider
| Trường | Giá trị |
|---|---|
| Nhà cung cấp | OpenAI Compatible hoặc Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | Giá trị của TOKENHUB_API_KEY |
| Mô hình | gpt-4.1 hoặc model ID TokenHub khác |
Vị trí file cài đặt
| Trường | Giá trị |
|---|---|
| User config | ~/.codex/config.toml |
| Provider section | model_providers.tokenhub |
| Secret source | env_key = "TOKENHUB_API_KEY" |
model = "gpt-4.1"
model_provider = "tokenhub"
[model_providers.tokenhub]
name = "TokenHub"
base_url = "__API_BASE_URL__/v1"
env_key = "TOKENHUB_API_KEY"
wire_api = "responses"Codex uses the Responses wire API for this provider, so choose a TokenHub model that supports https://us-api.tokenhub.com/v1/responses.
Nếu phiên bản đã cài ghi schema hơi khác, hãy dùng thiết lập tương tác trước, rồi giữ cùng các giá trị TokenHub: Base URL, API key và model ID.
Nếu công cụ tách chat, edit, apply và fast models, hãy dùng cùng một mô hình TokenHub cho lần thử đầu tiên. Sau đó mới tách theo chi phí, độ trễ và năng lực suy luận.
Biến môi trường tạm thời chỉ để debug
Chỉ dùng biến tạm thời để kiểm tra key, mạng và tên mô hình. Sau khi xác minh, chuyển cùng giá trị vào cấu hình bền vững ở trên.
export TOKENHUB_API_KEY="sk-..."Xác minh kết nối
Trước tiên dùng prompt chỉ đọc để xác nhận mô hình đọc được ngữ cảnh và không sửa file. Sau đó mới thử chỉnh sửa hoặc tác vụ agent.
Đọc README của dự án và tóm tắt trong ba câu. Không chỉnh sửa file.Sau khi prompt chạy thành công, kiểm tra log TokenHub để xác nhận tên mô hình, endpoint, lượng token và billing group.
Khắc phục sự cố
| Hiện tượng | Cách xử lý |
|---|---|
| 401 hoặc lỗi xác thực | Kiểm tra TOKENHUB_API_KEY còn hợp lệ và đã lưu trong cùng terminal, IDE hoặc profile client. |
| 404 hoặc không tìm thấy mô hình | Dùng model ID có trong workspace TokenHub và phù hợp với giao thức đã chọn. |
| Sai endpoint | Giữ Base URL đúng như phần trên. Công cụ tương thích OpenAI thường cần /v1; công cụ tương thích Claude thường không cần. |
| Request timeout | Kiểm tra đường mạng tới https://us-api.tokenhub.com, proxy settings và allowlist của workspace. |
| Công cụ dùng mô hình khác | Kiểm tra lại mọi trường chat, edit, apply, fast hoặc autocomplete. |
Chọn mô hình
Codex CLI tùy chỉnh API FAQ
Tại sao Codex Base URL cần /v1?
Codex nối thêm đường dẫn Phản hồi cho nhà cung cấp base_url, vì vậy nhà cung cấp TokenHub nên sử dụng gốc API, sau đó là /v1.
Tôi có thể thay đổi wire_api thành chat_completions không?
Giữ wire_api = "responses" cho nhà cung cấp tùy chỉnh Codex hiện tại. Nếu mô hình không hỗ trợ Phản hồi, hãy chọn một mô hình khác thay vì sử dụng giá trị giao thức chưa được xác minh.
Tại sao Codex vẫn báo thiếu khóa API?
Kiểm tra xem env_key trong config.toml có khớp chính xác với TOKENHUB_API_KEY không và khởi động Codex từ thiết bị đầu cuối mới có chứa biến.
Codex CLI khác với Claude Code như thế nào?
Cả hai đều là tác nhân mã hóa, nhưng giao thức nhà cung cấp tùy chỉnh của chúng khác nhau: Codex sử dụng Phản hồi OpenAI trong khi Claude Code sử dụng Anthropic Messages. Compare quy trình làm việc, độ tin cậy của công cụ, bối cảnh, độ trễ và chi phí.
Việc sử dụng Codex được tính phí thông qua TokenHub như thế nào?
TokenHub tính phí đầu vào, đầu ra và mức sử dụng bộ nhớ đệm hiện hành của mô hình đã chọn. Không có giá riêng cho từng mẫu Codex CLI, vì vậy hãy kiểm tra trang chi tiết mẫu hiện tại trước khi sử dụng.
Tài liệu tham khảo
Cấu hình này dựa trên TokenHub và tài liệu chính thức; lần xác minh gần nhất: 2026-09-04。