Tài liệu

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.

~/.config/zed/settings.json
{
  "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
          }
        ]
      }
    }
  }
}
API key không được đặt trong tệp này. Tài liệu của Zed nói rõ điều đó — hãy nhập khóa trong cài đặt nhà cung cấp của Agent Panel hoặc đặt biến môi trường mà Zed tạo cho tên nhà cung cấp. settings.json được đồng bộ và chia sẻ; khóa đặt trong đó sẽ đi theo tệp.
Theo Zed, 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 đó.
Chưa có khóa? Tạo tài khoản Kunavo, tạo khóa (bắt đầu bằng 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

  1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
  2. Mở settings.json bằng cách chọn zed: open settings từ bảng lệnh rồi thêm khối ở trên.
  3. 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 đó.
  4. Chọn model trong bộ chọn model của Agent Panel — bộ chọn hiển thị display_name và gửi name.
  5. Chỉ ghi đè capabilities khác với mặc định của Zed; mặc định bật tools: true cù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ìnhKunavo vào / raPhù hợp ở đâu trong Zed
claude-sonnet-5$1.40 / $7.00mặc định của agent — bật công cụ và hình ảnh
claude-opus-5$3.50 / $17.50tá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.50hỗ trợ trực tiếp trong dòng và chỉnh sửa nhanh
gpt-5-6-terra$0.70 / $4.20một họ model thứ hai dùng chung mục nhà cung cấp
Thanh toán theo token từ số dư trả trước, không có phí hàng tháng — xem trang Thanh toán. Với ngữ cảnh lặp lại — chiếm phần lớn dữ liệu mà trình chỉnh sửa hoặc ứng dụng trò chuyện gửi đi — bộ nhớ đệm prompt ảnh hưởng đến hóa đơn nhiều hơn lựa chọn mô hình.

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.