Công cụ lập trình
OpenCodex
Kết nối Codex với TokenLab thông qua OpenCodex với định tuyến API theo từng model
Để agent của tôi thiết lập việc này
Sao chép tác vụ này vào một agent đang chạy trên máy tính của bạn:
Read https://tokenlab.sh/docs/vi/integrations/opencodex and help me connect OpenCodex to TokenLab.
Check my installed OpenCodex and Codex versions, active configuration, and running proxy first.
Preserve existing accounts, providers, models, and permissions. Back up files before changing them.
Have me enter the API key locally; never ask for, print, or paste it in chat.
Use the TokenLab preset and the selected model's documented API format.
Check configuration loading first. Explain the cost before running a small real request.
Match the reply with its TokenLab request record.Cách thức hoạt động của kết nối
OpenCodex là một proxy cục bộ nằm giữa Codex và các API model. Hướng dẫn này sử dụng OpenCodex 2.73.0 và Codex CLI 0.149.0.
Tích hợp Chat Completions của preset TokenLab đã được phát hành và xác minh toàn diện trong phiên bản 2.72.0. Phiên bản 2.73.0 duy trì tích hợp đó và bổ sung định tuyến Responses theo từng model cũng như Anthropic Messages. Các tuyến đường được liệt kê dưới đây đã được kiểm tra với TokenLab bằng văn bản được truyền phát (streamed text) và các vòng lặp gọi hàm/kết quả.
Codex gửi các yêu cầu Responses đến proxy OpenCodex cục bộ. Sau đó, OpenCodex gửi yêu cầu của model đã chọn đến TokenLab. Một yêu cầu Responses trên kết nối cục bộ không có nghĩa là model đó được gọi thông qua API Responses của TokenLab.
| Các model được chọn trong Codex | OpenCodex → TokenLab |
|---|---|
gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, grok-4.7, deepseek-v4.1-flash, deepseek-v4-pro, kimi-k3, glm-5.3 | Responses: POST /v1/responses |
claude-opus-5, claude-opus-5-5, claude-sonnet-5, claude-sonnet-5-5, claude-fable-5, claude-fable-5-1 | Anthropic Messages: POST /v1/messages |
gemini-3.8-flash | Chat Completions: POST /v1/chat/completions |
Base URL của preset là https://api.tokenlab.sh/v1. Hãy giữ nguyên: OpenCodex sẽ tự xây dựng URL Messages hoặc Responses tương ứng. Các model nằm ngoài các mặc định Responses được liệt kê và định tuyến Claude sẽ sử dụng bộ điều hợp Chat của preset.
TokenLab hỗ trợ API gốc của Gemini cho các model khai báo hỗ trợ, nhưng preset TokenLab của OpenCodex 2.73.0 gọi Gemini thông qua Chat Completions. Đừng thay đổi toàn bộ nhà cung cấp (provider) thành Responses hoặc Gemini; điều đó cũng sẽ làm thay đổi các yêu cầu đối với những model không chấp nhận định dạng đó.
Cài đặt hoặc cập nhật
Sử dụng Node.js 18 trở lên để cài đặt qua npm:
npm install -g @bitkyc08/opencodex@2.73.0
ocx --version
codex --versionCodex cũng phải được cài đặt. OpenCodex cung cấp hướng dẫn cài đặt và hướng dẫn kết nối Codex. Windows gốc và WSL có các cấu hình riêng biệt; hãy chạy thiết lập và Codex trong cùng một môi trường.
Thêm TokenLab
Tạo một key trong TokenLab API Keys. Để thiết lập trên terminal, hãy làm theo Bắt đầu nhanh để đặt TOKENLAB_API_KEY mà không cần đưa giá trị của nó vào lịch sử lệnh. Khởi động OpenCodex từ terminal đó; một dịch vụ chạy ngầm cần biến này trong môi trường khởi chạy của chính nó.
Đối với cài đặt OpenCodex mới, hãy chạy ocx init, chọn TokenLab và nhập key cục bộ hoặc sử dụng tham chiếu môi trường theo nghĩa đen ${TOKENLAB_API_KEY}. Xem lại các lựa chọn kết nối Codex và tự động khởi động của trình hướng dẫn trước khi áp dụng.
Đối với cài đặt hiện có, hãy thêm preset mà không thay thế các nhà cung cấp khác:
ocx provider add tokenlab --api-key '${TOKENLAB_API_KEY}'Dấu nháy đơn giúp lưu tham chiếu biến môi trường, không phải giá trị của key. Lệnh này cũng hoạt động trong PowerShell. Nếu tokenlab đã tồn tại, hãy chỉnh sửa nhà cung cấp đó trong bảng điều khiển thay vì ghi đè bằng --force.
Bạn cũng có thể chọn TokenLab trong danh sách Add provider của bảng điều khiển và nhập key tại đó. OpenCodex lưu cấu hình của nó tại $OPENCODEX_HOME/config.json, thường là ~/.opencodex/config.json.
Khởi động proxy nếu nó chưa chạy, sau đó mở bảng điều khiển của nó:
ocx start
ocx status
ocx guiTrong trang nhà cung cấp, hãy kiểm tra Base URL và các model đã được khám phá. Preset này khám phá GET /v1/models?category=chat và giữ lại các model có khả năng tool-use. Hình ảnh, video, âm thanh, embeddings và các model quyết định bị loại trừ. Việc khám phá với một key sẽ phản ánh quyền truy cập model và chính sách phân phối của key đó.
Chạy ocx sync để kết nối Codex và làm mới danh mục model của nó, sau đó bắt đầu một phiên Codex mới. Thao tác này thay đổi kết nối proxy và danh mục của Codex; hãy xem lại các cài đặt nhà cung cấp tùy chỉnh hiện có và sao lưu trước khi đồng bộ hóa. Nó không yêu cầu thay thế tài khoản hoặc chính sách quyền của bạn.
Chọn model và xác minh yêu cầu
Chọn mục tokenlab/<model-id> trong trình chọn model của Codex, hoặc chọn nó cho một lần khởi chạy CLI:
codex -m "tokenlab/gpt-6.1-sol"OpenCodex sử dụng tokenlab/ để chọn nhà cung cấp; ID model được gửi đến TokenLab là gpt-6.1-sol. Hãy chọn một ID chính xác hiện đang khả dụng từ Models.
Để kiểm tra kết nối nhanh, hãy gửi:
Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.Yêu cầu này sử dụng số dư TokenLab của bạn. Kiểm tra phản hồi và model, thời gian, trạng thái tương ứng trong Requests. Việc khám phá nhà cung cấp và khởi động thành công không đảm bảo quyền truy cập suy luận (inference access).
Tính năng truyền phát (streaming) và gọi hàm (function calling) hoạt động trên các tuyến đường trong bảng. Đầu vào hình ảnh và các điều khiển tư duy (thinking controls) phụ thuộc vào model được chọn: hãy kiểm tra khả năng của model đó và chỉ sử dụng các lựa chọn nỗ lực (effort choices) mà OpenCodex cung cấp cho model đó. Đầu vào hình ảnh và các yêu cầu tư duy đã được kiểm tra trên các model đại diện cho các tuyến đường Responses và Messages; đầu vào hình ảnh Gemini đã được kiểm tra trên tuyến đường Chat của nó. Một model hỗ trợ tư duy không nhất thiết phải hiển thị văn bản tư duy hoặc hỗ trợ mọi cấp độ nỗ lực.
Giữ một model Responses trên Chat Completions
Để sử dụng đường dẫn Chat cho một trong các model Responses được liệt kê, hãy hợp nhất một mục modelAdapters vào đối tượng providers.tokenlab hiện có trong cấu hình của OpenCodex. Ví dụ này giữ gpt-6-astra trên Chat cho Codex:
{
"modelAdapters": {
"gpt-6-astra": "openai-chat"
}
}Đây là ví dụ về trường nhà cung cấp, không phải là thay thế cho toàn bộ cấu hình. Hãy bảo toàn các ghi đè model, thông tin xác thực và nhà cung cấp khác, sau đó khởi động lại proxy và mở một phiên Codex mới. Việc chỉ xóa mục model này sẽ khôi phục mặc định Responses của nó.
Định tuyến Messages của Claude gắn liền với endpoint TokenLab chính tắc. Ghi đè Chat ở trên áp dụng cho các mặc định Responses; nó không chuyển Claude sang Chat. Đối với một client Chat-native, các model Responses được liệt kê đã sử dụng Chat mà không cần ghi đè này. Xem Định tuyến nhà cung cấp OpenCodex.
Chính sách phân phối và các công cụ TokenLab khác
Preset không ép buộc tiêu đề X-TokenLab-Delivery-Policy. TokenLab sử dụng mặc định chính sách phân phối của API key của bạn. Việc chọn Chat, Responses hoặc Messages tách biệt với việc chọn chính sách phân phối; xem Cài đặt nhà cung cấp TokenLab.
TokenLab Skills bổ sung các hướng dẫn tích hợp. Chúng không thay đổi nhà cung cấp hoặc định dạng API của model chính.
JEV Auto trong OpenCodex 2.73.0 sử dụng backend quyết định của TypeSafe. Nó không cung cấp TokenLab làm backend đó. Việc gọi System One API của TokenLab thông qua MCP là một thao tác riêng biệt; đừng đặt key TokenLab vào trường thông tin xác thực của TypeSafe.
Tạo hình ảnh và video trong cùng một agent
Codex cũng có thể tạo hình ảnh và video ngắn với server MCP của TokenLab. Mỗi lần tạo đều được thanh toán từ cùng một số dư TokenLab. OpenCodex chỉ định tuyến các yêu cầu model, và bản thân Codex khởi động các server MCP. Thêm server vào Codex trong terminal nơi TOKENLAB_API_KEY được thiết lập:
codex mcp add \
--env TOKENLAB_MCP_TOOL_PROFILE=core \
--env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
tokenlab -- \
npx -y @tokenlabai/mcp-server@0.6.48MCP không thay đổi nhà cung cấp hoặc định dạng API của model chính. Chạy codex mcp list và kiểm tra xem tokenlab có được liệt kê hay không. Sau đó thử trong một phiên Codex mới:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video trả về một ID tác vụ. Agent sẽ gọi get_task_status cho đến khi video sẵn sàng.
Khắc phục sự cố và khôi phục thiết lập của bạn
- TokenLab bị thiếu trong trình chọn: kiểm tra
ocx --version; hướng dẫn này nhắm đến phiên bản 2.73.0. Làm mới danh mục vớiocx syncvà bắt đầu một phiên Codex mới. - Lỗi 401 hoặc thiếu thông tin xác thực: kiểm tra xem key có đang hoạt động và khả dụng cho tiến trình đang chạy OpenCodex hay không. Một biến môi trường trong terminal khác sẽ không cập nhật dịch vụ đang chạy.
- Thiếu model: kiểm tra ID chính xác, quyền của key và tình trạng khả dụng hiện tại. Các model không phải chat và các model chat không có
tool-usekhông được bao gồm trong preset này. - Yêu cầu không được hỗ trợ hoặc sai endpoint: so sánh model đã chọn với bảng định tuyến và kiểm tra các ghi đè bộ điều hợp đã lưu. Định dạng bắt buộc là
tokenlab.accepted_request_formatstrong chi tiết model; danh sách model không thay thế cho trường chi tiết đó. Claude và Gemini không được gửi đến Responses chỉ vì Codex sử dụng Responses cục bộ. - Công cụ hoặc đầu vào hình ảnh bị lỗi: giữ lại lỗi gốc và Request ID. Kiểm tra khả năng của model và tuyến đường OpenCodex đang hoạt động trước khi thay đổi cài đặt; đừng xóa lịch sử hội thoại hoặc kết quả công cụ để che giấu lỗi.
Để ngừng định tuyến Codex qua proxy, hãy sử dụng ocx stop; OpenCodex sẽ dừng proxy và khôi phục kết nối Codex gốc. ocx restore khôi phục kết nối gốc trong khi vẫn giữ proxy chạy cho các client khác. Xem lại tài liệu tham khảo CLI của OpenCodex trước khi thay đổi cài đặt được chia sẻ bởi các client khác.