SHOP / ĐỐI TÁC 1 / CODEX
Kết nối key Codex đúng cách
Key Codex và key Claude là hai loại khác nhau. Chọn đúng hướng dẫn theo tên sản phẩm trong đơn hàng.
Nguồn từng thông báo lỗi Codex. Xem trạng thái hiện tại tại trang kiểm tra; nếu server lỗi, dừng thử và liên hệ shop. Có tài liệu cấu hình không đồng nghĩa nguồn đã hết lỗi.
Tên model theo gateway công bố; chỉ dùng model key thực sự được cấp.
https://api.nghimmo.com/v1gpt-5.6-terranghi/gpt-5.6-terra1. Kiểm tra key trước khi dùng
- Lấy API key trong đơn hàng/file TXT. Không dùng buyer key tgb_… hoặc mã kích hoạt Đối tác 2.
- Mở trang check, xem đúng gói, quota, hạn và giới hạn request. Chờ ít nhất 10 giây giữa các lần check.
- Nếu sai gói hoặc lỗi khi vừa nhận, gửi mã đơn và ảnh đã che key cho shop.
Không mặc định mốc tính hạn của Codex giống ảnh key Claude 10M. Lấy mốc cụ thể từ trang check của key được giao.
2. Codex CLI · Responses API
Cài Codex theo tài liệu OpenAI chính thức. Sao lưu cấu hình hiện tại rồi gộp mẫu dưới đây vào ~/.codex/config.toml của người dùng. Windows: %USERPROFILE%\.codex\config.toml. Không ghi đè toàn bộ file và không đặt provider trong cấu hình chia sẻ của dự án.
model = "gpt-5.6-terra"
model_provider = "shop_partner1"
[model_providers.shop_partner1]
name = "Shop - Partner 1"
base_url = "https://api.nghimmo.com/v1"
env_key = "SHOP_CODEX_KEY"
wire_api = "responses"
requires_openai_auth = falseĐặt key thật trong biến môi trường trên máy của bạn, rồi mở Codex từ terminal đó:
$env:SHOP_CODEX_KEY = "YOUR_API_KEY"
codexexport SHOP_CODEX_KEY="YOUR_API_KEY"
codexKiểm tra model/provider trong phiên mới, gửi một yêu cầu ngắn. Mẫu không thay đổi sandbox, quyền chạy lệnh hoặc cơ chế phê duyệt của bạn.
3. Extension Codex trong VS Code
- Cài extension Codex chính thức từ OpenAI.
- Gộp provider vào file cấu hình người dùng như trên. Đóng các cửa sổ VS Code cũ.
- Trong terminal đã đặt SHOP_CODEX_KEY, chạy
code .để extension nhận biến môi trường. - Mở một phiên Codex mới, kiểm tra provider/model rồi thử tác vụ nhỏ.
Nếu mở IDE từ biểu tượng mà không nhận key, kiểm tra môi trường của tiến trình IDE. Không dán key vào source hoặc commit vào Git.
4. Cline, Roo Code và Continue
Những công cụ dùng Chat Completions có cách gọi khác Codex CLI:
- Chọn provider OpenAI Compatible, Base URL
https://api.nghimmo.com/v1. - Nhập key Codex và model
nghi/gpt-5.6-terratheo danh mục key được cấp. Nếu lỗi, thử model mặc định nguồn công bốnghi/gpt-5.5. - Kiểm tra cả Plan/Act nếu tách cấu hình, lưu và thử task nhỏ.
Continue: gộp mẫu vào ~/.continue/config.yaml, đặt SHOP_CODEX_KEY=YOUR_API_KEY trong ~/.continue/.env, rồi tải lại cấu hình:
name: Shop Codex
version: 1.0.0
schema: v1
models:
- name: Partner 1 - Coding
provider: openai
model: nghi/gpt-5.6-terra
apiBase: https://api.nghimmo.com/v1
apiKey: ${{ secrets.SHOP_CODEX_KEY }}
roles:
- chat
- edit
- applyMẫu dành cho Chat/Edit/Apply, không cấu hình embedding hay autocomplete.
5. Hạn mức, bảo hành và xử lý lỗi
- 401
- Kiểm tra loại key, khoảng trắng và biến môi trường đã có trong tiến trình đang chạy.
- 404 / model
- Codex dùng Responses; Cline dùng Chat Completions. Kiểm tra model đúng cách đặt tên của từng công cụ, không dùng model Claude.
- 429
- Giảm chạy đồng thời, đợi theo yêu cầu server. RPM không phải số worker.
- 5xx / timeout
- Xem trạng thái nguồn trước khi thử lại; không gửi hàng loạt yêu cầu lặp.
- Quota / hạn
- Hạn mức theo cách tính nguồn; lịch sử hội thoại dài cũng tiêu token. Không mặc định tương đương quota Đối tác 2.
Bảo hành lỗi key trong thời hạn nguồn; khi đủ điều kiện sẽ xử lý phần token chưa dùng. Chưa cam kết cộng dồn/gia hạn trên cùng key. Gửi mã đơn và ảnh lỗi đã che key cho @your_support_username.
Nguồn đối chiếu: Hướng dẫn đối tác · Cấu hình Codex chính thức. Hướng dẫn chưa thay cho kiểm thử model bằng key của bạn.