Tài liệu
Zed
Zed khai báo nhà cung cấp tương thích OpenAI trong settings.json và nhận khóa riêng thông qua Agent Panel. Mảng models không phải tùy chọn tiện ích — đó là toàn bộ danh sách model mà Zed nhận diện.
Một khối language_models.openai_compatible trong settings.json khai báo endpoint và các model; key được nhập trong giao diện Agent Panel, không bao giờ trong tệp.
{
"language_models": {
"openai_compatible": {
"kunavo": {
"api_url": "https://api.kunavo.com/v1",
"available_models": [
{
"name": "claude-sonnet-5",
"display_name": "Claude Sonnet 5",
"max_tokens": 200000,
"max_output_tokens": 64000,
"capabilities": { "tools": true, "images": true }
},
{
"name": "claude-haiku-4-5",
"display_name": "Claude Haiku 4.5",
"max_tokens": 200000
}
]
}
}
}
}settings.json được đồng bộ và chia sẻ; khóa đặt trong đó sẽ đi theo tệp.available_models là toàn bộ danh mục — nhà cung cấp tương thích OpenAI không có lệnh gọi khám phá model, nên model bạn không liệt kê sẽ không xuất hiện trong danh sách chọn. Thêm một mục cho mỗi ID bạn định dùng, với max_tokens được đặt theo cửa sổ ngữ cảnh thực của model đó.sk-kn-) và nạp tín dụng từ $10 — các lệnh gọi được thanh toán từ số dư đó và các lệnh gọi thất bại không bị tính phí. Sau đó, bảng điều khiển mở tại phần thiết lập Zed.Từng bước
- Tạo khóa tại
/app/keysrồi sao chép khóa — khóa chỉ hiển thị một lần. - Mở
settings.jsonbằng cách chọn zed: open settings từ bảng lệnh rồi thêm khối ở trên. - Mở cài đặt Agent Panel, tìm nhà cung cấp theo tên bạn đã dùng làm khóa (
kunavoở đây) rồi dán API key vào đó. - Chọn model trong bộ chọn model của Agent Panel — bộ chọn hiển thị
display_namevà gửiname. - Chỉ ghi đè
capabilitieskhác với mặc định của Zed; mặc định bậttools: truecùng hình ảnh và tắt lệnh gọi công cụ song song.
Đã kiểm tra đối chiếu với Tài liệu của Zed về quyền truy cập API vào 6 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.
Xác minh trước khi gỡ lỗi ứng dụng khách
Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong Zed.
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."Đặt model id nào vào trường
Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.
| ID mô hình | Kunavo vào / ra | Phù hợp ở đâu trong Zed |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | mặc định của agent — bật công cụ và hình ảnh |
claude-opus-5 | $3.50 / $17.50 | tái cấu trúc quy mô lớn, khi kế hoạch quan trọng hơn tốc độ |
claude-haiku-4-5 | $0.70 / $3.50 | hỗ trợ trực tiếp trong dòng và chỉnh sửa nhanh |
gpt-5-6-terra | $0.70 / $4.20 | một họ model thứ hai dùng chung mục nhà cung cấp |
Câu hỏi thường gặp
Làm cách nào để thêm nhà cung cấp tương thích OpenAI vào Zed?
Thêm khối language_models.openai_compatible vào settings.json, dùng tên nhà cung cấp làm khóa, đặt api_url trỏ đến thư mục gốc /v1 của điểm cuối và thêm mảng available_models liệt kê từng ID model bạn muốn. Sau đó mở cài đặt nhà cung cấp trong Agent Panel và nhập API key ở đó. Tài liệu của Zed nói rõ rằng không được đặt khóa trong settings.json.
Vì sao model không xuất hiện trong danh sách chọn model của Zed?
Vì model đó không có trong available_models. Zed không truy vấn danh mục từ điểm cuối tương thích OpenAI, nên mảng trong settings.json là danh sách đầy đủ các model mà nhà cung cấp đó cung cấp. Thêm một mục với ID model làm name, display_name để hiển thị trong danh sách chọn và max_tokens đặt theo cửa sổ ngữ cảnh thực của model.
Zed lưu API key của nhà cung cấp tùy chỉnh ở đâu?
Trong giao diện cài đặt nhà cung cấp của Agent Panel hoặc trong biến môi trường Zed tạo từ tên nhà cung cấp — không phải trong settings.json. Zed cố ý giữ thông tin xác thực bên ngoài tệp cài đặt, vì tệp này được thiết kế để dễ mang theo và chia sẻ, còn khóa thì không.
Zed có thể dùng model Claude qua điểm cuối tùy chỉnh không?
Có. Nhà cung cấp openai_compatible gửi thẳng tên model đến api_url, vì vậy điểm cuối sẽ phân giải ID Claude thay vì Zed. Đặt capabilities.tools thành true cho các model hỗ trợ gọi công cụ — đây là mặc định của Zed cho loại nhà cung cấp này — để agent hoạt động giống như với nhà cung cấp chính thức.