Token Plan (Phiên bản Nhóm)
Tối ưu nhất khi sử dụng cùng phiên bản hiện hành của Codex và các mô hình qwen3.7-max, qwen3.7-plus, qwen3.6-plus hoặc qwen3.6-flash thông qua API Responses.
Kết hợp công cụ + mô hình
Codex với Kế hoạch Mã hóa và Kế hoạch Tiền tệ của Alibaba (Token Plan)
Công cụ lập trình dòng lệnh từ OpenAI có thể nằm trong cùng cuộc trò chuyện người mua với các công cụ lập trình tương thích Alibaba.
Codex có thể kết nối với Alibaba Model Studio thông qua nhà cung cấp tùy chỉnh trong tệp `~/.codex/config.toml`. Tính tương thích phụ thuộc vào cả phiên bản API của mô hình và phiên bản Codex: Alibaba ghi rõ hỗ trợ hiện tại của Codex thông qua API Responses dành cho các mô hình Token Plan Qwen được chọn.
Chọn phương thức truy cập phù hợp
Chọn phương thức truy cập phù hợp
Sử dụng Token Plan cùng phiên bản Codex mới nhất và mô hình Qwen tương thích với Responses. Hiện tại Alibaba yêu cầu người dùng Coding Plan, cũng như người dùng chọn các mô hình chỉ hỗ trợ Chat/Completions khác, phải cài đặt phiên bản cũ hơn của Codex, ví dụ như 0.80.0 — hãy cân nhắc kỹ sự đánh đổi này trước khi đăng ký riêng Codex.
Được đề xuấtToken Plan là lựa chọn tối ưu hơn cho người dùng đang sử dụng phiên bản hiện hành của Codex
Coding Plan
Hướng dẫn hiện hành của Alibaba nêu rõ Coding Plan chỉ hỗ trợ Chat/Completions tại đây và yêu cầu người dùng Codex cài đặt phiên bản cũ hơn như 0.80.0.
Pay-as-you-go Model Studio API
Sử dụng cho khối lượng công việc sản xuất/API hoặc khi một mô hình pay-as-you-go được hỗ trợ cùng vùng triển khai phù hợp hơn với yêu cầu ứng dụng của bạn.
Mẫu cấu hình an toàn
Cấu hình nhà cung cấp Token Plan tương thích với Responses
Ví dụ được chủ ý ẩn đi. Chỉ thay thế các phần giữ chỗ trên thiết bị của bạn và tuyệt đối không dán khóa API thực tế vào Nfero.
Trước khi bắt đầu
- Cài đặt Node.js phiên bản 18 trở lên và kiểm tra bằng lệnh `codex --version`.
- Chọn mô hình có API tương thích với phiên bản Codex bạn dự định sử dụng.
- Lấy khóa chuyên dụng Token Plan hoặc Coding Plan; thiết lập dưới dạng biến môi trường thay vì ghi trực tiếp vào tệp TOML.
- Sao lưu tệp `~/.codex/config.toml` trước khi thay thế nhà cung cấp OpenAI hoặc nhà cung cấp tùy chỉnh hiện có.
Mẫu cấu hình an toàn
- Giao thức
- OpenAI Responses API
- Đường dẫn cấu hình
~/.codex/config.toml
- Thiết lập khóa chuyên dụng thực tế vào biến `OPENAI_API_KEY` trên thiết bị của bạn; không ghi giá trị này trực tiếp vào tệp dưới đây.
- Chọn một trong các mô hình Qwen tương thích với định dạng Responses do Alibaba công bố chính thức, phù hợp với phiên bản Codex hiện tại.
- Thêm nhà cung cấp tùy chỉnh và sử dụng URL gốc (base URL) của Token Plan.
- Mở một cửa sổ terminal mới và chạy lệnh `codex` để kiểm tra cấu hình.
model_provider = "Model_Studio_Token_Plan"
model = "qwen3.7-plus"
[model_providers.Model_Studio_Token_Plan]
name = "Model_Studio_Token_Plan"
base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
# Set locally; never paste the real value into this file or Nfero:
# OPENAI_API_KEY=YOUR_TOKEN_PLAN_API_KEYXác minh kết nối
- Mở một terminal mới để biến môi trường `OPENAI_API_KEY` có sẵn cho Codex.
- Chạy lệnh `codex --version` và xác nhận phiên bản trả về khớp với tuyến đường API bạn đã cấu hình.
- Khởi chạy `codex` và thử hỏi một kho mã chỉ đọc nhỏ trước tiên.
- Nếu bộ chuyển đổi nhà cung cấp báo lỗi kiểm tra sức khỏe, hãy kiểm tra trực tiếp Codex; Alibaba lưu ý rằng một số định dạng yêu cầu dò tìm có thể thất bại ngay cả khi các yêu cầu thực tế vẫn hoạt động bình thường.
Kết hợp mô hình
Các mô hình đề xuất để bắt đầu
Sử dụng công cụ này để thực hiện các nhiệm vụ lập trình tương tác, suy luận, kiểm tra và tài liệu với mỗi mô hình. Xác nhận khả năng sẵn có của mô hình cuối cùng và hỗ trợ kế hoạch chính xác trong Alibaba Cloud trước khi sử dụng trong sản xuất.
Qwenqwen3.7-plus
Tạo văn bảnLập luậnHiểu biết trực quan
Góc kết hợp tốt nhất
Tương thích với Responses trên nền tảng Token Plan, đồng thời là lựa chọn cân bằng giữa khả năng lập trình và suy luận ở phiên bản hiện hành.
Qwenqwen3.7-max
Tạo văn bảnLập luận
Góc kết hợp tốt nhất
Mô hình chủ lực của Token Plan tương thích với Responses, phù hợp cho các tác vụ suy luận phức tạp và xử lý kho mã nguồn (repository).
Qwenqwen3.6-flash
Tạo văn bảnLập luậnHiểu biết trực quan
Góc kết hợp tốt nhất
Giải pháp thay thế của Token Plan tương thích với Responses, tối ưu cho các tác vụ yêu cầu bối cảnh dài (long-context).
Các sự cố thường gặp
Các sự cố thường gặp
Hiện tượng bạn gặp phải
Lỗi 400 Bad Request hoặc bộ chuyển đổi nhà cung cấp thông báo rằng các mô hình trong nước không được hỗ trợ.
Nguyên nhân có khả năng xảy ra
Yêu cầu kiểm tra sức khỏe của bộ chuyển đổi bên thứ ba khác với yêu cầu do Codex gửi.
Cần làm gì
Thử nghiệm trực tiếp từ Codex trước khi loại bỏ nhà cung cấp; lỗi kiểm tra dò tìm không nhất thiết phản ánh vấn đề tương thích thực tế.
Hiện tượng bạn gặp phải
Lỗi định dạng Responses API hoặc lỗi giao thức truyền dữ liệu (wire-protocol error).
Nguyên nhân có khả năng xảy ra
Mô hình đã chọn chỉ hỗ trợ Chat/Completions, hoặc phiên bản Codex hiện tại kỳ vọng định dạng Responses.
Cần làm gì
Sử dụng một mô hình Qwen tương thích với định dạng Responses theo tài liệu chính thức của Alibaba cho phiên bản Codex hiện tại, hoặc làm theo hướng dẫn dành cho phiên bản cũ hơn của Alibaba đối với các tuyến chỉ hỗ trợ Chat/Completions.
Hiện tượng bạn gặp phải
Lỗi 401 hoặc thiếu khóa API.
Nguyên nhân có khả năng xảy ra
Giá trị `OPENAI_API_KEY` không khả dụng trong shell mới hoặc thuộc về một tuyến thanh toán Alibaba khác.
Cần làm gì
Thiết lập khóa kế hoạch chuyên dụng trong biến môi trường, mở một cửa sổ terminal mới và kết nối nó với URL gốc (base URL) tương ứng của kế hoạch đó.
Hiện tượng bạn gặp phải
Phát sinh chi phí pay-as-you-go bất ngờ.
Nguyên nhân có khả năng xảy ra
Nhà cung cấp tùy chỉnh đang sử dụng endpoint/key chung của Model Studio thay vì cặp endpoint/key dành riêng cho kế hoạch.
Cần làm gì
Kiểm tra kỹ cấu hình `model_provider`, `base_url` và nguồn của biến môi trường trước khi thực thi tác vụ tiếp theo.
Các hạn chế quan trọng
- Sử dụng khóa API chuyên dụng và URL gốc từ cùng một kế hoạch thanh toán Alibaba. Khóa Coding Plan, khóa Token Plan và thông tin xác thực chung của Model Studio không thể hoán đổi cho nhau.
- Khóa theo gói chỉ dành riêng cho người dùng được chỉ định trong các công cụ lập trình tương tác hoặc agent. Không chia sẻ khóa, không đưa khóa vào kho lưu trữ (repository), và không tiết lộ khóa trong ảnh chụp màn hình.
- Không sử dụng khóa Coding Plan hoặc Token Plan cho các kịch bản tự động, công việc hàng loạt (batch jobs), backend ứng dụng, dịch vụ công khai hoặc các khối lượng công việc API phi tương tác khác. Hãy sử dụng quyền truy cập API của Model Studio pay-as-you-go cho các trường hợp sử dụng này.
- Danh sách mô hình khả dụng được quản lý theo cơ chế danh sách trắng (allowlist) chính xác từng ký tự và có thể thay đổi. Vui lòng xác minh ID mô hình trong tài liệu kế hoạch Alibaba hiện hành trước khi chỉnh sửa cấu hình đang hoạt động.