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.

Trước khi chạy việc: kiểm tra server và key.

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.

BASE URL · có /v1
https://api.nghimmo.com/v1
MODEL · Codex CLI
gpt-5.6-terra
MODEL · Cline / Continue
nghi/gpt-5.6-terra

1. Kiểm tra key trước khi dùng

  1. 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.
  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.
  3. 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.

config.toml · cấu hình người dùng
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 đó:

Windows · PowerShell
$env:SHOP_CODEX_KEY = "YOUR_API_KEY"
codex
macOS / Linux · Bash / Zsh
export SHOP_CODEX_KEY="YOUR_API_KEY"
codex

Kiể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

  1. Cài extension Codex chính thức từ OpenAI.
  2. 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ũ.
  3. Trong terminal đã đặt SHOP_CODEX_KEY, chạy code . để extension nhận biến môi trường.
  4. 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:

  1. Chọn provider OpenAI Compatible, Base URL https://api.nghimmo.com/v1.
  2. Nhập key Codex và model nghi/gpt-5.6-terra theo 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.
  3. 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:

Continue · config.yaml
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
      - apply

Mẫ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.