Hướng dẫn cấu hình ZCode: kết nối NextHub API
ZCode là môi trường phát triển agent (ADE) do Zhipu phát triển, hỗ trợ thêm bất kỳ dịch vụ model nào tương thích giao thức Anthropic / OpenAI làm nhà cung cấp tùy chỉnh. Sau khi cấu hình xong NextHub, bạn có thể dùng trực tiếp model Claude và GPT ngay trong ZCode.
Các bước kết nối
1. Cài đặt ZCode
Truy cập trang chủ ZCode để tải bộ cài Windows / macOS / Linux và cài đặt. Ở trang chào mừng khi khởi động lần đầu, bạn có thể bỏ qua bước kết nối tài khoản và vào thẳng giao diện chính.
2. Vào cài đặt model
Nhấn tên model ở ô nhập → Quản lý model (hoặc vào panel Cài đặt model từ Cài đặt), rồi nhấn Thêm nhà cung cấp ở cuối danh sách nhà cung cấp bên trái.
3. Điền thông tin nhà cung cấp (kênh Claude)
| Trường | Nội dung điền |
|---|---|
| Tên | NextHub |
| Giao thức giao diện | Anthropic |
| Địa chỉ giao diện (Base URL) | https://api.nexthub.cc |
| API Key | ApiKey NextHub của bạn (nhóm Claude) |
Base URL đừng kèm /v1
Địa chỉ giao diện cho giao thức Anthropic cùng định dạng với ANTHROPIC_BASE_URL của Claude Code: điền dạng thuần https://api.nexthub.cc, không thêm /v1 ở cuối, đường dẫn giao diện Messages sẽ được ZCode tự động nối thêm.
4. Thêm model và bật
Nhấn Thêm model, điền thủ công model ID mà dịch vụ hỗ trợ, ví dụ claude-opus-5-5, claude-fable-5 (danh sách đầy đủ xem kênh và model, lấy dữ liệu thời gian thực của Model Plaza làm chuẩn). Sau khi lưu, bật công tắc bật của nhà cung cấp.
5. Xác minh
Quay lại hộp thoại, chọn model vừa thêm trong bộ chọn model, gửi một tin; nhận được phản hồi là đã kết nối thành công.
Cũng có thể kết nối kênh GPT
Thêm một nhà cung cấp nữa: giao thức giao diện chọn OpenAI, địa chỉ giao diện điền https://api.nexthub.cc/v1 (có /v1), API Key dùng khóa (API) của nhóm GPT-Azure (0.47x) hoặc GPT-Pro (0.11x), model ID điền gpt-5.6, gpt-6-astra, v.v. Hai nhà cung cấp có thể tồn tại song song, chuyển đổi bất cứ lúc nào trong bộ chọn model.
Các vấn đề thường gặp
Cấu hình nhà cung cấp của ZCode và biến môi trường terminal là hai mục nhập độc lập, không đồng bộ với nhau. Nếu kết nối cứ xoay vòng, hãy kiểm tra trước xem địa chỉ giao diện có bị thừa đường dẫn không -- với giao thức OpenAI, ZCode sẽ tự động nối thêm /chat/completions, nếu địa chỉ chứa đường dẫn thừa sẽ trả 404; model ID phải khớp hoàn toàn với danh sách model.