Hướng dẫn cấu hình Zed với Beeknoee

Zed là gì?

Zed là code editor hiệu suất cao được viết bằng Rust — siêu nhanh, nhẹ, với AI assistant tích hợp sẵn. Zed hỗ trợ cấu hình custom OpenAI-compatible provider qua file settings.json.

💡 Zed là lựa chọn tuyệt vời nếu bạn muốn editor nhanh nhất có thể + AI coding assistant trong một — không cần cài thêm extension.

Yêu cầu

• Zed phiên bản mới nhất (zed.dev)
• API Key từ Beeknoee Platform

⚠️ Zed hiện chỉ hỗ trợ macOS và Linux. Windows chưa có phiên bản chính thức.

📌 Bước 1: Tạo API Key

1. Truy cập https://platform.beeknoee.com/api-keys
2. Đăng nhập bằng tài khoản Google
3. Nhấn "Tạo API Key"
4. Copy API Key (dạng sk-bee-xxxx...)

⚠️ API key chỉ hiển thị 24 giờ đầu — copy và lưu ngay!

📌 Bước 2: Cài đặt Zed

macOS

brew install --cask zed

Linux

curl -fsSL https://zed.dev/install.sh | sh

Hoặc tải trực tiếp tại zed.dev.

📌 Bước 3: Khai báo provider trong settings.json

Bản Zed mới kết nối endpoint OpenAI-compatible qua khối language_models.openai_compatible (không phải openai). Mở Zed Settings: Cmd+, (macOS) hoặc Ctrl+, (Linux) → chọn Open Settings (JSON) và thêm:

{
  "language_models": {
    "openai_compatible": {
      "Beeknoee": {
        "api_url": "https://platform.beeknoee.com/v1",
        "available_models": [
          {
            "name": "<model-id>",
            "display_name": "Beeknoee — <tên model>",
            "max_tokens": 200000,
            "capabilities": { "tools": true, "images": true }
          },
          {
            "name": "deepseek/deepseek-v3.2",
            "display_name": "Beeknoee — DeepSeek",
            "max_tokens": 128000,
            "capabilities": { "tools": true, "images": false }
          }
        ]
      }
    }
  }
}

• Thay <model-id> bằng Model ID copy từ trang Models.
• api_url phải kết thúc bằng /v1: https://platform.beeknoee.com/v1 (không có dấu / ở cuối).
• Đặt capabilities.tools: false cho model không hỗ trợ function calling (nếu để true sai, request có thể lỗi).

📌 Bước 4: Nhập API Key trong Agent Panel

Với provider openai_compatible, Zed không đọc key từ OPENAI_API_KEY mà yêu cầu nhập trực tiếp:

1. Mở Agent Panel (icon trợ lý AI) → Settings (⚙️)
2. Tìm provider Beeknoee vừa khai báo
3. Dán API key sk-bee-YOUR_API_KEY → Save
4. Restart Zed nếu provider chưa hiện model

💡 Kiểm tra settings.json đúng cú pháp JSON (đủ dấu phẩy/ngoặc) trước khi restart.

📌 Bước 5: Sử dụng

Phím tắt AI trong Zed

Ví dụ sử dụng

• Cmd+? → "Giải thích function này"
• Bôi đen code → Ctrl+Enter → "Optimize performance"
• Cmd+? → "Viết React component cho sidebar navigation"

Models khuyên dùng với Zed

💡 Model ID chính xác và giá realtime xem tại trang Models trên Dashboard (copy đúng ID vào file config).

🆓 Models miễn phí qua BeeSynapse

Khi đã kết nối email tại trang BeeSynapse Integrations, hệ thống tự động ưu tiên free quota:

Danh sách model free thay đổi theo quota nhà cung cấp — xem chính xác tại trang BeeSynapse Integrations. Bạn không cần thay đổi gì — Beeknoee tự route qua free quota trước, hết quota mới trừ VND.

Xử lý lỗi

AI Assistant không hiện model Beeknoee

• Kiểm tra settings.json đã có block language_models.openai
• Kiểm tra biến môi trường OPENAI_API_KEY đã set (chạy echo $OPENAI_API_KEY trong terminal)
• Restart Zed sau khi thay đổi config

"Unauthorized" hoặc "Invalid API key"

• Kiểm tra API key bắt đầu bằng sk-bee-
• Kiểm tra key chưa bị thu hồi

"Model not found"

• Kiểm tra name trong available_models chính xác với Model ID trên Beeknoee
• Model ID phân biệt HOA-thường

HOÀN TẤT! 🎉

Cần hỗ trợ thêm? Sử dụng Support Chat (góc dưới phải trên platform) hoặc liên hệ qua email.