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

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

Áp dụng cho các bản phân phối phổ biến như Ubuntu, Debian, Fedora, Arch, cũng như WSL và máy chủ từ xa. Mặc định hướng dẫn theo bash.

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

Trên môi trường desktop, nhấn Ctrl + Alt + T để mở terminal; với máy chủ, chỉ cần đăng nhập qua SSH. Các lệnh dưới đây đều chạy bằng người dùng thường, không cần sudo (trừ khi cài Node.js).

2. Cài đặt Node.js

Cần Node.js 18 trở lên. Node đi kèm bản phân phối thường quá cũ, khuyến nghị cài bằng nvm, không cần quyền root:

Terminal · nvm (Khuyến nghị)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install --lts
node -v
Terminal
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
Với Node cài bằng trình quản lý gói của hệ thống, npm install -g có thể cần sudo. Dùng nvm sẽ không gặp vấn đề này.

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
Terminal · bash
cat >> ~/.bashrc <<'EOF'

# Toki Labs · Claude
export ANTHROPIC_BASE_URL="https://api.tokilabs.xyz"
export ANTHROPIC_AUTH_TOKEN="sk-khoa-cua-ban"
EOF
source ~/.bashrc

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

Nếu dùng zsh, thay ~/.bashrc bằng ~/.zshrc; nếu dùng fish, hãy viết theo kiểu set -Ux ANTHROPIC_BASE_URL https://api.tokilabs.xyz.
Terminal
echo $ANTHROPIC_BASE_URL

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.

Terminal
curl "$ANTHROPIC_BASE_URL/v1/models" -H "Authorization: Bearer $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

Terminal · Script cài đặt chính thức
curl -fsSL https://claude.ai/install.sh | bash

Hoặc cài bằng npm:

Terminal · 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:

Terminal
[ -f ~/.claude.json ] || echo '{"hasCompletedOnboarding": true}' > ~/.claude.json

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

Terminal
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.

Máy chủ và Docker

Khi chạy tác vụ định kỳ hoặc dịch vụ systemd trên máy chủ, ~/.bashrc sẽ không được tải. Hãy dùng Environment= trong tệp unit, hoặc truyền vào bằng -e trong Docker:

Terminal
docker run --rm \
  -e ANTHROPIC_BASE_URL=https://api.tokilabs.xyz \
  -e ANTHROPIC_AUTH_TOKEN=sk-khoa-cua-ban \
  your-image

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:

Terminal
# Mở ~/.bashrc bằng trình soạn thảo, xóa 2 dòng export bên dưới “# Toki Labs · Claude”, sau đó:
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN