Hướng dẫn cấu hình trình soạn thảo Zed: kết nối NextHub API
Zed hỗ trợ hai cách kết nối: chế độ ACP (dùng lại trực tiếp cấu hình Claude Code) và chế độ Zed Agent (dùng trong bảng AI tích hợp sẵn của trình soạn thảo).
Cách 1: Chế độ ACP (khuyến nghị)
Chế độ ACP gọi trực tiếp Claude Code CLI, chỉ cần hoàn tất cấu hình Claude Code theo CC-Switch / Cấu hình thủ công, là Zed dùng được ngay, không cần thiết lập thêm.
TIP
Zed ACP đã tích hợp sẵn Claude Code Agent, sau khi hoàn tất cấu hình Claude Code, bạn có thể chọn ngay trong bảng Agent của Zed, cấu hình không có ngưỡng cửa.
Cách 2: Chế độ Zed Agent (tự cấu hình Provider)
1. Mở Agent Panel, nhấp vào tên mô hình hiện tại
Tìm Agent Panel ở góc dưới bên phải của Zed, nhấp vào tên mô hình đang hiển thị để vào giao diện chuyển mô hình.
2. Nhấp Configure → Add Provider
Trong giao diện bật ra, nhấp "Configure", rồi nhấp "Add Provider", chọn loại là Compatible APIs (OpenAI).
3. Điền thông tin Provider
Điền theo định dạng sau:
| Trường | Nội dung điền |
|---|---|
| API Key | ApiKey NextHub của bạn |
| Base URL | https://api.nexthub.cc/v1 |
| Model ID | claude-opus-5-5 và các ID khác trong danh sách mô hình |
Base URL nhớ kèm /v1
Zed sẽ dùng địa chỉ bạn điền nguyên văn làm tiền tố yêu cầu. Khi điền https://api.nexthub.cc/v1, cả hai chế độ yêu cầu chat/completions và Responses đều hoạt động bình thường; yêu cầu chat/completions không kèm /v1 sẽ rơi vào đường dẫn sai và gây lỗi.
4. Lưu và chọn mô hình Claude trong bảng Agent
Sau khi lưu cấu hình, quay lại Agent Panel, chọn mô hình Claude bạn vừa thêm trong danh sách thả xuống là dùng được bình thường.