Kết nối API bên thứ ba

Cập nhật nguồn

Ngày kiểm tra nguồn chính thức: 2026-05-27. Các nhà cung cấp model, gateway, tool chuyển cấu hình và chính sách billing thay đổi thường xuyên. Trước khi dùng thật, hãy đối chiếu lại tài liệu chính thức của provider.

Codex có thể dùng OpenAI trực tiếp hoặc kết nối qua một provider/gateway khác tùy bề mặt sử dụng và cấu hình. Chương này tập trung vào cách nghĩ, không khuyến nghị một dịch vụ cụ thể.

Chọn phương án nào

Phương án	Phù hợp	Ưu điểm	Rủi ro
Cấu hình thủ công	Người hiểu config.toml, env vars và API key	Minh bạch, dễ kiểm soát	Dễ sai key/base URL nếu thiếu kinh nghiệm
Codex++	Muốn chuyển cấu hình nhanh bằng tool	Ít thao tác tay	Phụ thuộc tool bên thứ ba
CCX + CC Switch	Muốn quản lý nhiều kênh/model/gateway	Linh hoạt cho nhiều provider	Phức tạp hơn, cần hiểu gateway và billing

Người mới nên bắt đầu bằng cấu hình ít nhất có thể. Đừng kết nối nhiều gateway cùng lúc khi chưa biết cách kiểm tra model nào đang được gọi.

Phương án 1: Cấu hình thủ công

Tư duy cơ bản:

1. Lấy API key từ provider chính thức.
2. Chọn base URL, model và cách xác thực.
3. Ghi cấu hình vào config.toml hoặc biến môi trường, tùy tài liệu Codex hiện tại.
4. Chạy tác vụ nhỏ để xác nhận request đi đúng provider.
5. Theo dõi billing và quota ngay sau lần chạy đầu.

Ví dụ prompt kiểm tra:

Hãy cho biết phiên bản model hiện tại, giải thích bạn đang chạy trong môi trường nào,
và không sửa bất kỳ file nào.

Sau đó kiểm tra:

• Provider dashboard có log request không.
• Token/billing có tăng đúng không.
• Codex có báo lỗi authentication, quota hoặc model not found không.
• config.toml không chứa key thật nếu repo có thể commit.

Quản lý khóa API

Không đưa API key vào README, screenshot, prompt public, issue, PR hoặc repo. Ưu tiên dùng environment variables, secret manager hoặc file local đã được .gitignore.

Hai kiểu đăng nhập thường gặp

Đăng nhập bằng tài khoản ChatGPT/OpenAI: phù hợp khi dùng App hoặc Cloud chính thức. Bạn chủ yếu kiểm tra tài khoản, gói và quyền truy cập.

Đăng nhập bằng API key: phù hợp khi dùng CLI, gateway hoặc provider bên thứ ba. Bạn phải tự quản lý key, base URL, model và billing.

Nếu không chắc đang ở kiểu nào, hãy dừng lại và đọc lại tài liệu của bề mặt đang dùng.

Phương án 2: Codex++

Một số công cụ cộng đồng hỗ trợ chuyển cấu hình hoặc quản lý provider cho Codex. Cách dùng thường là:

1. Cài tool theo tài liệu chính thức của tool đó.
2. Thêm provider hoặc API key.
3. Chọn model/gateway.
4. Để tool sinh hoặc chỉnh cấu hình local.
5. Chạy tác vụ chỉ đọc để kiểm tra.

Sau khi tool chỉnh cấu hình, hãy tự kiểm tra diff của file config. Nếu không hiểu file nào bị sửa, chưa nên dùng cho repo quan trọng.

Phương án 3: CCX + CC Switch

Mô hình gateway phù hợp khi bạn muốn gom nhiều provider và đổi kênh nhanh:

1. Triển khai hoặc cấu hình CCX/gateway theo tài liệu của dự án đó.
2. Thêm channel: provider, API key, base URL, model và giới hạn quota.
3. Dùng CC Switch hoặc tool tương tự để đổi cấu hình client.
4. Khởi động Codex với profile tương ứng.
5. Kiểm tra request log, billing và output.

Gateway giúp linh hoạt nhưng cũng tạo thêm một điểm có thể lỗi. Khi gặp lỗi, hãy tách lớp: Codex config, switch tool, gateway, provider, network và billing.

Cách kiểm chứng sau cấu hình

Chạy một tác vụ chỉ đọc:

Chỉ đọc repo hiện tại. Hãy tóm tắt cấu trúc thư mục, không sửa file,
không chạy lệnh có tác dụng phụ, và liệt kê lệnh kiểm chứng nên chạy sau này.

Sau đó kiểm tra:

• Codex có tuân thủ “chỉ đọc” không.
• Provider log có request đúng model không.
• Không có file chứa secret bị tạo hoặc sửa.
• Billing/quota tăng trong mức dự kiến.
• Có cách rollback cấu hình cũ.

Lỗi thường gặp

Lỗi	Nguyên nhân hay gặp	Cách xử lý
Authentication failed	Key sai, key hết hạn, header sai	Tạo key mới, kiểm tra env var và config
Model not found	Tên model không đúng provider	Đối chiếu danh sách model hiện tại
Quota exceeded	Hết quota hoặc billing chưa bật	Kiểm tra dashboard provider
Network error	Proxy, firewall, base URL sai	Test bằng curl hoặc tác vụ nhỏ
Không biết đang gọi provider nào	Nhiều config chồng nhau	Tắt bớt profile, kiểm tra log và env vars

Bước tiếp theo: Hoàn thành tác vụ đầu tiên