Cấu hình Codex

Codex sử dụng giao thức OpenAI, cần trỏ địa chỉ API tới endpoint tương thích OpenAI của trang này.

Cách 1: Biến môi trường (đơn giản nhất, dùng chung)

export OPENAI_BASE_URL="https://kuaiapi.net/v1"
export OPENAI_API_KEY="sk-khóa-của-bạn"

Sau đó dùng Codex CLI bình thường là được.

Cách 2: File cấu hình Codex CLI (khuyến nghị dùng lâu dài)

Chỉnh sửa ~/.codex/config.toml:

model_provider = "kuai"

[model_providers.kuai]
name = "KuaiAPI"
base_url = "https://kuaiapi.net/v1"
env_key = "KUAIAPI_API_KEY"
wire_api = "responses"

Và thiết lập trong shell:

export KUAIAPI_API_KEY="sk-khóa-của-bạn"

Cách 3: Plugin VS Code

1. Cài đặt plugin Codex
2. Trong cài đặt plugin, chọn/thêm Provider tùy chỉnh
3. Base URL điền https://kuaiapi.net/v1, API Key điền khóa của bạn
4. Chọn model là có thể trò chuyện

Kiểm tra

codex exec "xin chào"

Trả về bình thường là thành công. Khi báo lỗi, đối chiếu Xử lý sự cố để kiểm tra.

TIP

• Trang cấu hình khuyến nghị (Use Key) sẽ tự động tạo cấu hình Codex phù hợp với nhóm hiện tại, ưu tiên sử dụng
• Tên model lấy theo danh sách model của nhóm

Xử lý sự cố: Gọi công cụ trả về 400 (parallel_tool_calls)

Hiện tượng: Codex trò chuyện bình thường, nhưng hễ cần gọi công cụ (thực thi lệnh/ghi file v.v.) là trả về 400, thông báo lỗi tương tự:

X-OpenAI-Internal-Codex-Responses-Lite requires `parallel_tool_calls` to be false.

Nguyên nhân: Codex phiên bản mới dùng chế độ giao thức Responses Lite cho các model như GPT-5.6, chế độ này quy định "gọi một công cụ", trong request parallel_tool_calls phải ghi rõ là false. Một số phiên bản Codex (đặc biệt là bản alpha preview, hoặc khi bật tùy chọn "bật gọi công cụ song song cho tất cả model") sẽ gửi parallel_tool_calls: true (hoặc lược bỏ trường này), gateway của nền tảng theo yêu cầu giao thức sẽ từ chối request và trả về lỗi 400 nêu trên.

Các bước giải quyết (thử theo thứ tự):

1. Trong cài đặt Codex tắt "Gọi công cụ song song" (Enable parallel tool calls for all model prompts) rồi khởi động lại Codex;
2. Nếu vẫn lỗi, chuyển sang Codex bản ổn định (không dùng kênh alpha/preview), bản ổn định mặc định đã gửi request hợp lệ theo giao thức Lite;
3. Khi các cách trên đều không hiệu quả, liên hệ support (support@kuaiapi.net) phản hồi số phiên bản codex-tui, chúng tôi sẽ hỗ trợ xử lý.

Lưu ý: Vấn đề này là vấn đề thích ứng giữa giao thức mới của Codex và gateway của nền tảng, chúng tôi đã phản hồi cho bên vận hành gateway và theo dõi việc tự động tương thích, sau khi nâng cấp phiên bản sau này sẽ không cần thiết lập thủ công nào.