Zed Agent

Zed tích hợp sẵn loại provider OpenAI tương thích, khai báo endpoint, mô hình và độ dài ngữ cảnh trong settings.json, là có thể cho Agent Panel dùng các mô hình aicentos tích hợp.

Chuẩn bịSao chép liên kết neo

Trước tiên, tạo một Key chuyên dụng cho Zed tại trang "API Key" trong Console (khuyến nghị đặt tên zed-agent).

• Console: https://aicentos.com
• Tạo Key: https://aicentos.com/keys
• Nạp tiền Ví: https://aicentos.com/wallet

Zed không ghi API Key vào settings.json, mà đọc biến môi trường cùng tên: Provider ID sẽ được chuyển thành chữ hoa dạng snake_case rồi thêm hậu tố _API_KEY. Vì vậy khi Provider ID đặt là aicentos, tên biến môi trường chính là AICENTOS_API_KEY.

Cấu hình cần điềnSao chép liên kết neo

Các bước thiết lậpSao chép liên kết neo

• Mở settings.json của Zed (command palette thực hiện zed: open settings).
• Thêm cấu hình language_models.openai_compatible:

{
  "language_models": {
    "openai_compatible": {
      "aicentos": {
        "api_url": "https://aicentos.com/v1",
        "available_models": [
          {
            "name": "gpt-5",
            "display_name": "GPT-5 (aicentos)",
            "max_tokens": 128000,
            "max_output_tokens": 16384,
            "capabilities": {
              "tools": true,
              "images": false,
              "chat_completions": true
            }
          }
        ]
      }
    }
  }
}

• Xuất biến môi trường (ghi vào ~/.zshrc rồi tải lại):

export AICENTOS_API_KEY="sk-Key-aicentos-của-bạn"

• Mở Agent Panel, trong dropdown mô hình chọn mô hình dưới provider này.

Cũng có thể trong cài đặt Agent nhấn Add Provider, điền tên Provider, API URL, model ID và cửa sổ ngữ cảnh qua giao diện đồ hoạ.

Kiểm traSao chép liên kết neo

Sau khi cấu hình xong, tạo một hội thoại mới trong Agent Panel, trước tiên test nhẹ bằng một câu prompt đơn giản, xác nhận có thể trả về bình thường rồi mới chính thức dùng gọi công cụ.

Lưu ýSao chép liên kết neo

• api_url chỉ điền đến https://aicentos.com/v1, đừng bổ sung thành /chat/completions đầy đủ; Zed sẽ tự nối.
• API Key không được viết trực tiếp vào settings.json, bắt buộc dùng biến môi trường (hoặc lưu vào system keychain qua giao diện cài đặt Provider); biến môi trường khác rỗng có độ ưu tiên cao hơn keychain.
• max_tokens là cửa sổ ngữ cảnh, khuyến nghị điền theo giá trị thực của mô hình; nếu thiếu sẽ khiến việc quản lý ngữ cảnh bất thường.
• Gọi công cụ mặc định được bật (capabilities.tools), nhập ảnh và gọi công cụ song song mặc định tắt, khi cần thì bật thủ công.
• Tài liệu chính thức: https://zed.dev/docs/ai/llm-providers
• Xem thêm giải thích tại trang tài liệu: https://docs.aicentos.com