Hướng dẫn dùng Beeknoee trong VS Code

Có 2 cách dùng Beeknoee trong VS Code

Cách	Dùng gì	Hợp với ai
A. Extension Claude Code (do Anthropic phát hành)	Giao diện chat ngay trong VS Code, dùng chung phiên với `claude` ở terminal	Ai đã quen Claude Code, muốn có giao diện
B. Extension OpenAI-compatible (Cline, Roo Code, Kilo Code, Continue)	Chỉ cần Base URL + API Key + Model	Ai muốn chạy mọi model (GPT, Gemini, Grok, DeepSeek…), không chỉ Claude

💡 Cách A chỉ chạy được model dòng Claude. Cần model khác → chọn cách B.

Yêu cầu chung

VS Code 1.94 trở lên
API Key từ Beeknoee Platform (dạng sk-bee-xxxx...)

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

Cách A — Extension Claude Code

📌 Bước 1: Cài extension

Mở VS Code → Extensions (Ctrl+Shift+X) → tìm "Claude Code" (tác giả Anthropic) → Install.

Extension cũng cài được trên Cursor và các bản fork khác của VS Code.

📌 Bước 2: Khai báo Beeknoee cho extension

⚠️ Đây là chỗ nhiều người làm sai. Chạy Quick Setup (ghi ~/.claude/settings.json) là đủ cho claude ở terminal, nhưng chưa đủ cho extension: extension kiểm tra thông tin đăng nhập từ cấu hình riêng của nó trước khi khởi chạy, nên nếu chỉ có settings.json thì nó vẫn hiện màn hình Sign in.

Mở Command Palette (Ctrl+Shift+P) → chạy Preferences: Open User Settings (JSON)
Thêm khối sau (giữ nguyên các thiết lập cũ):

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://platform.beeknoee.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-bee-YOUR_API_KEY" },
    { "name": "CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK", "value": "1" },
    { "name": "API_TIMEOUT_MS", "value": "600000" }
  ],
  "claudeCode.disableLoginPrompt": true
}

Chạy Developer: Reload Window để nạp lại

Giải thích 4 biến:

Biến	Vì sao cần
`ANTHROPIC_BASE_URL`	Trỏ extension về Beeknoee
`ANTHROPIC_AUTH_TOKEN`	Key Beeknoee, gửi ở header `Authorization: Bearer`
`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`	Bắt luôn dùng streaming — tránh lỗi timeout khi model suy nghĩ lâu (xem Xử lý lỗi)
`API_TIMEOUT_MS`	Cho phép request dài tới 10 phút

claudeCode.disableLoginPrompt giúp bỏ qua màn hình đăng nhập Anthropic — đây là thiết lập do chính Anthropic cung cấp cho người dùng provider bên thứ ba.

📌 Bước 3: Kiểm tra

Mở một file bất kỳ → bấm icon ✱ ở góc phải trên editor (hoặc Ctrl+Esc)
Gõ một câu hỏi
Mở trang Usage — request phải xuất hiện

Chọn model

Gõ / trong khung chat → chọn model. Muốn đổi model mặc định cho 3 khe Haiku / Sonnet / Opus, thêm vào claudeCode.environmentVariables:

{ "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-4-6" }

Xem model ID chính xác tại trang Models trên Dashboard.

📌 Dùng cả terminal lẫn extension

Extension và CLI dùng chung lịch sử hội thoại: gõ claude --resume ở terminal để mở tiếp phiên vừa chat trong extension.

Cách gọn nhất để có cả hai:

Chạy Quick Setup → cấu hình xong cho claude ở terminal
Thêm khối claudeCode.environmentVariables ở trên → xong cho extension

Cách B — Extension OpenAI-compatible

Các extension này chỉ cần 3 thông tin giống nhau:

Field	Giá trị
API Provider	`OpenAI Compatible`
Base URL	`https://platform.beeknoee.com/v1`
API Key	`sk-bee-YOUR_API_KEY`
Model ID	`claude-sonnet-4-6`, `gpt-5.5`, `gemini-3.5-flash`… (xem trang Models)

Roo Code

Extensions (Ctrl+Shift+X) → tìm "Roo Code" → Install
Mở panel Roo Code → icon ⚙️ Settings
API Provider → chọn OpenAI Compatible
Điền Base URL, API Key, Model theo bảng trên
Save

💡 Roo Code hỗ trợ nhiều "profile" cấu hình — bạn có thể tạo một profile Beeknoee riêng và giữ nguyên profile cũ.

⚠️ Muốn dùng tool calling (agent tự sửa file, chạy lệnh), chọn model có hỗ trợ tool calling — xem cột capability ở trang Models.

Các extension khác

Extension	Hướng dẫn riêng
Cline	Xem hướng dẫn
Kilo Code	Xem hướng dẫn
Continue	Xem hướng dẫn

🔧 Lỗi thường gặp

Lỗi	Nguyên nhân	Cách xử lý
Extension Claude Code vẫn bắt Sign in	Chỉ mới ghi `~/.claude/settings.json`	Thêm `claudeCode.environmentVariables` như Bước 2 — extension không đọc `settings.json` cho bước kiểm tra đăng nhập
Icon ✱ không xuất hiện	Chưa mở file nào, hoặc VS Code < 1.94	Mở một file bất kỳ; kiểm tra Help → About
`401`	Key sai / đã revoke, hoặc điền vào sai biến	Dùng `ANTHROPIC_AUTH_TOKEN` (không phải `ANTHROPIC_API_KEY`) cho extension
Cline/Roo Code báo model không tồn tại	Model ID gõ sai	Copy chính xác `providerModelId` ở trang Models
Trả lời bị cắt giữa chừng	Model suy nghĩ lâu, request không stream	Với extension Claude Code: thêm `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`; các extension khác: bật streaming trong settings của chúng

Xem thêm Xử lý lỗi.

Xem thêm

Claude Code — bản CLI đầy đủ
Claude Desktop — app desktop, tab Code
Quick Setup — cài 1 lệnh cho terminal
Models — danh sách model và ID chính xác