Trang chủ → Hướng dẫn → Dùng Codex với API tùy chỉnh: thiết lập config.toml cho Codex CLI và Codex desktop

Dùng Codex với API tùy chỉnh: thiết lập config.toml cho Codex CLI và Codex desktop

Codex đọc nhà cung cấp từ một tệp duy nhất. Năm dòng cấu hình và một biến môi trường chuyển cả công cụ dòng lệnh lẫn ứng dụng desktop sang endpoint khác — và phần lớn lỗi đến từ biến môi trường chứ không phải cấu hình.

Cấu hình

Thêm một nhà cung cấp vào config.toml và đặt làm mặc định:

model = "gpt-6.1-sol"
model_provider = "apiclan"
model_reasoning_effort = "medium"

[model_providers.apiclan]
name = "APICLAN"
base_url = "https://apiclan.us/v1"
env_key = "APICLAN_API_KEY"
wire_api = "responses"

Có ba chi tiết quan trọng. base_url kết thúc bằng /v1, vì Codex tự thêm /responses. wire_api = "responses" khiến Codex dùng Responses API mà cổng này hỗ trợ. Còn env_key là tên của một biến môi trường, không phải bản thân khóa.

Tệp nằm ở đâu

• macOS / Linux: ~/.codex/config.toml
• Windows: %USERPROFILE%\.codex\config.toml

Hãy tạo thư mục và tệp nếu chưa có. Ứng dụng desktop Codex đọc cùng tệp với công cụ dòng lệnh, nên sửa một lần là áp dụng cho cả hai. Nếu không muốn sửa TOML bằng tay, CC Switch có thể viết giúp bạn — xem hướng dẫn ứng dụng desktop.

Đặt khóa để Codex nhìn thấy

macOS / Linux — thêm vào profile của shell:

echo 'export APICLAN_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows — lưu cho tài khoản người dùng:

setx APICLAN_API_KEY "sk-your-key"

Phần lớn cấu hình hỏng ở bước này. Biến đặt bằng export hay $env: chỉ tồn tại trong terminal đó; ứng dụng desktop mở từ Dock hay menu Start không bao giờ thấy nó. setx trên Windows lưu vĩnh viễn, nhưng chỉ chương trình mở sau đó mới đọc được — hãy thoát hẳn Codex rồi mở lại.

Chọn model và mức suy luận

Đổi model trong cấu hình, hoặc chuyển trong phiên bằng /model:

Model	Phù hợp cho
gpt-6.1-sol, gpt-5.6-terra	Lập trình hằng ngày, sửa code, viết test — rẻ nhất mỗi lượt gọi
gpt-5.6-sol	Khi prompt của bạn đã tinh chỉnh cho GPT-5.6
gpt-6-astra	Bài toán khó mà câu trả lời tốt hơn đáng giá gấp năm lần

model_reasoning_effort nhận low, medium, high và xhigh. Mức càng cao viết càng nhiều: với gpt-5.6-sol ở đây, lượt gọi trung vị ở high trả về 373 token đầu ra so với 139 ở medium — gấp 2,7 lần, tất cả tính phí như đầu ra. Hãy bắt đầu với medium. Giá có trong hướng dẫn giá API OpenAI.

Lưu lượng Codex ở đây trông thế nào

Trong 30 ngày qua, 87% các lượt gọi GPT trên cổng này đến từ Codex, tất cả đi qua /v1/responses có streaming. Lượt gọi trung vị:

• mang khoảng 67.000 token ngữ cảnh, 86% từ cache
• mất 14 giây tổng cộng, token đầu tiên sau 10 giây
• trả về 214 token đầu ra

Bốn lỗi hay gặp nhất

• 401 Unauthorized → Codex không thấy APICLAN_API_KEY. Đặt như trên rồi khởi động lại Codex hoàn toàn. Chạy echo $APICLAN_API_KEY trong cùng môi trường sẽ in ra khóa.
• 404 hoặc một trang HTML → base_url thiếu /v1, hoặc bị lặp hai lần.
• model not found → gõ sai tên model, hoặc khóa của bạn thuộc nhóm không có model đó. Danh sách chuẩn là GET https://apiclan.us/v1/models.
• stream disconnected hoặc hết thời gian với tác vụ dài → suy luận quá lâu vượt quá giới hạn chờ của proxy. Đổi base_url thành https://api.apiclan.us/v1 để tránh giới hạn proxy 100 giây.

Claude Code dùng quy tắc ngược lại — không có /v1 — xem hướng dẫn base URL cho Claude Code.

Bắt đầu sử dụng

Không thuê bao, không mức tối thiểu hàng tháng, không cần gọi cho nhân viên bán hàng. Nạp bằng USDT và tiêu đúng phần bạn dùng — 1 USDT cho bạn 2 tín dụng số dư API.

Đọc hướng dẫn nhanh 30 giây

Ngôn ngữ: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Giá trên trang này được điền tự động từ dữ liệu thanh toán thực tế. Điều khoản bên thứ ba được trích từ tài liệu của chính họ.