TokiLabsDocs
Cấu hình hệ điều hành

Hướng dẫn cấu hình Windows

Áp dụng cho Windows 10 / 11. Toàn bộ thực hiện trong PowerShell, không cần quyền quản trị.

Một key dùng được cho mọi mô hình. Key chỉ được lưu trong trình duyệt của bạn, không tải lên bất kỳ máy chủ nào.
Chưa có key? Hãy tạo một key tại Lấy API key.

1. Mở terminal

Nhấn Win + X, chọn “Terminal” hoặc “Windows PowerShell”. Mọi lệnh bên dưới đều chạy trong PowerShell, không dùng cửa sổ cmd cũ.

2. Cài đặt Node.js

Claude Code cần Node.js 18 trở lên; trên Windows còn cần Git for Windows (cung cấp Git Bash). Cài bằng winget có sẵn trong hệ thống:

PowerShell
winget install OpenJS.NodeJS.LTS
winget install Git.Git

Sau khi cài xong, đóng và mở lại terminal, rồi kiểm tra phiên bản:

PowerShell
node -v
git --version
Nếu khi chạy npm gặp thông báo “running scripts is disabled on this system”, chạy một lần Set-ExecutionPolicy -Scope CurrentUser RemoteSigned và nhập Y để xác nhận.

3. Đặt biến môi trường

Đặt hai biến dưới đây, địa chỉ API là https://api.tokilabs.xyz.

Tên biếnGiá trịDùng cho
ANTHROPIC_BASE_URLhttps://api.tokilabs.xyzClaude Code, Anthropic SDK
ANTHROPIC_AUTH_TOKENsk-khoa-cua-banClaude Code
PowerShell
# Ghi vào biến môi trường người dùng, có hiệu lực vĩnh viễn (không cần quyền quản trị)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.tokilabs.xyz", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-khoa-cua-ban", "User")

Kiểm tra đã có hiệu lực chưa

Sau khi chạy lệnh, đóng tất cả cửa sổ terminal và VS Code rồi mở lại để biến mới có hiệu lực. Kiểm tra bằng lệnh sau:

PowerShell
$env:ANTHROPIC_BASE_URL
Không muốn dùng lệnh? Cách thiết lập bằng giao diện đồ họa
  1. Nhấn Win, tìm “Chỉnh sửa biến môi trường cho tài khoản của bạn” và mở nó.
  2. Trong khu vực “Biến người dùng”, nhấn “Mới” và lần lượt thêm hai biến trong bảng trên.
  3. Nhấn “OK” để lưu, sau đó mở lại terminal.

4. Kiểm tra kết nối

Nếu trả về một danh sách mô hình dạng JSON có chứa "data" thì địa chỉ và key đều đúng.

PowerShell
# Lưu ý: trong PowerShell phải viết curl.exe, chỉ viết curl sẽ gọi Invoke-WebRequest
curl.exe "$env:ANTHROPIC_BASE_URL/v1/models" -H "Authorization: Bearer $env:ANTHROPIC_AUTH_TOKEN"
Trả về 401 nghĩa là key sai hoặc đã hết hiệu lực; nếu kết nối quá thời gian, hãy kiểm tra cài đặt proxy trên máy, xem Câu hỏi thường gặp.

5. Cài đặt Claude Code

PowerShell · Script cài đặt chính thức
irm https://claude.ai/install.ps1 | iex

Hoặc cài bằng npm:

PowerShell · npm
npm install -g @anthropic-ai/claude-code

Bỏ qua bước đăng nhập tài khoản chính thức khi khởi động lần đầu:

PowerShell
# Chỉ tạo khi tệp chưa tồn tại, tránh ghi đè cấu hình sẵn có
if (!(Test-Path "$HOME\.claude.json")) {
  [IO.File]::WriteAllText("$HOME\.claude.json", '{"hasCompletedOnboarding": true}')
}

Vào thư mục dự án và khởi động:

PowerShell
cd du-an-cua-ban
claude

Sau khi khởi động, nhập /status, thấy Base URL là https://api.tokilabs.xyz nghĩa là đã đi qua API Toki Labs. Nhập /model để đổi mô hình, ví dụ claude-opus-5-5. Xem thêm cài đặt tại Cấu hình chi tiết Claude Code.

Dùng WSL

Nếu bạn phát triển trong WSL (Windows Subsystem for Linux), hãy làm theo Hướng dẫn cấu hình Linux trong terminal WSL. Biến môi trường của WSL và Windows độc lập với nhau, cần cấu hình riêng.

Khôi phục cấu hình

Khi không dùng nữa, chỉ cần xóa các biến môi trường này để trở về mặc định:

PowerShell
foreach ($n in "ANTHROPIC_BASE_URL","ANTHROPIC_AUTH_TOKEN") {
  [Environment]::SetEnvironmentVariable($n, $null, "User")
}