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

3:17

OpenCode là gì?

OpenCode là AI coding assistant dạng CLI/TUI — chạy trực tiếp trong terminal, hỗ trợ viết code, debug, và tự động hóa. OpenCode cho phép cấu hình custom API provider tương thích OpenAI, giúp bạn sử dụng Beeknoee API trực tiếp.

💡 Beeknoee API tương thích hoàn toàn với OpenAI SDK — OpenCode nhận diện Beeknoee như một OpenAI-compatible provider.

Yêu cầu

• Node.js 18+ (kiểm tra: node --version)
• API Key từ Beeknoee Platform

📌 Bước 1: Cài đặt OpenCode

Cách 1: Cài qua npm (khuyến nghị — Windows/macOS/Linux)

npm install -g opencode-ai

Cách 2: Cài qua script (macOS/Linux)

curl -fsSL https://opencode.ai/install | bash

Kiểm tra cài thành công:

opencode --version

📌 Bước 2: 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 3: Thiết lập biến môi trường

Lưu API key vào biến môi trường để không phải viết trực tiếp vào file config:

export BEEKNOEE_API_KEY="sk-bee-YOUR_API_KEY"

echo 'export BEEKNOEE_API_KEY="sk-bee-YOUR_API_KEY"' >> ~/.bashrc
source ~/.bashrc

$env:BEEKNOEE_API_KEY = "sk-bee-YOUR_API_KEY"

[System.Environment]::SetEnvironmentVariable("BEEKNOEE_API_KEY", "sk-bee-YOUR_API_KEY", "User")

📌 Bước 4: Tạo file cấu hình opencode.json

OpenCode sử dụng file opencode.json để cấu hình provider. Có 2 vị trí:

💡 Khuyến nghị: Dùng file global nếu muốn Beeknoee hoạt động ở mọi dự án.

Config mẫu đầy đủ:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "beeknoee": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Beeknoee",
      "options": {
        "baseURL": "https://platform.beeknoee.com/v1",
        "apiKey": "{env:BEEKNOEE_API_KEY}"
      },
      "models": {
        "deepseek/deepseek-v3.2": {
          "name": "DeepSeek V3.2"
        },
        "deepseek-reasoner": {
          "name": "DeepSeek R1"
        },
        "gpt-5.5": {
          "name": "GPT-5"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        },
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6"
        },
        "claude-opus-4-6": {
          "name": "Claude Opus 4.6"
        },
        "gemini-3-flash": {
          "name": "Gemini 3 Flash"
        },
        "gemini-3.1-pro-high": {
          "name": "Gemini 3.1 Pro High"
        },
        "glm-4.7-flash": {
          "name": "GLM-4.7 Flash (FREE)"
        }
      }
    }
  }
}

💡 Xem đầy đủ danh sách Model ID tại trang Các Mô Hình AI — ấn nút Copy ID trên mỗi card.

⚠️ Model reasoning (Claude, GPT high-reasoning, DeepSeek R1...): nên dùng ở chế độ streaming. Nếu gặp Cloudflare Error 524 (model suy nghĩ >120s), hãy đảm bảo request đặt "stream": true. Xem Error Handling.

⚠️ Windows PowerShell: Khi tạo file bằng Set-Content -Encoding UTF8, PowerShell thêm BOM gây lỗi. Dùng [System.IO.File]::WriteAllText() thay thế.

Config tối giản (1 model):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "beeknoee": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Beeknoee",
      "options": {
        "baseURL": "https://platform.beeknoee.com/v1",
        "apiKey": "{env:BEEKNOEE_API_KEY}"
      },
      "models": {
        "deepseek/deepseek-v3.2": {
          "name": "DeepSeek V3.2"
        }
      }
    }
  }
}

📌 Bước 5: Kết nối qua lệnh /connect

Ngoài cách config file, bạn có thể kết nối trực tiếp trong OpenCode:

1. Mở terminal → chạy opencode
2. Trong TUI, gõ /connect
3. Chọn "Other" (custom provider)
4. Nhập API key: sk-bee-YOUR_API_KEY

API key sẽ được lưu an toàn tại ~/.local/share/opencode/auth.json.

📌 Bước 6: Chọn model và bắt đầu sử dụng

Sau khi config xong, mở OpenCode trong dự án bất kỳ:

cd /path/to/your/project
opencode

Chọn model beeknoee/deepseek/deepseek-v3.2 (hoặc model khác đã config) và bắt đầu coding!

Thông tin quan trọng

🆓 Models miễn phí

Nếu bạn đã kết nối email qua BeeSynapse Integrations, một số model sẽ được ưu tiên dùng miễn phí:

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 config — Beeknoee tự động route qua free quota nếu có.

💰 Chi phí

• Khi có free quota → Miễn phí, trừ vào quota
• Khi hết quota → Trừ VND từ ví Beeknoee theo giá niêm yết
• Xem giá chi tiết tại API Usage

Xử lý lỗi

"Connection refused" hoặc "Network error"

• Kiểm tra baseURL có đúng: https://platform.beeknoee.com/v1
• Đảm bảo URL kết thúc bằng /v1

"Unauthorized" hoặc "Invalid API key"

• Kiểm tra biến môi trường BEEKNOEE_API_KEY đã được set chưa:

  echo $BEEKNOEE_API_KEY
  

• Kiểm tra API key chưa bị thu hồi tại API Keys

"Model not found"

• Kiểm tra Model ID chính xác tại trang Các Mô Hình AI
• Model ID phân biệt HOA-thường

OpenCode không nhận provider mới

• Thử restart OpenCode
• Kiểm tra file opencode.json có syntax JSON hợp lệ:

  cat ~/.config/opencode/opencode.json | python3 -m json.tool
  

So sánh với các cách tích hợp khác

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.