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

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

Áp dụng cho macOS 12 trở lên (cả chip Intel và Apple). macOS mặc định dùng zsh, cấu hình được ghi vào ~/.zshrc.

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 ⌘ + Space, tìm “Terminal” và mở. Cũng có thể dùng terminal bên thứ ba như iTerm2.

2. Cài đặt Node.js

Khuyến nghị cài Node.js 18 trở lên bằng Homebrew. Nếu chưa có Homebrew, hãy cài trước:

Terminal
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Terminal
brew install node
node -v
Nếu không muốn cài Homebrew, có thể tải gói cài đặt .pkg bản LTS từ nodejs.org.

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 · zsh
cat >> ~/.zshrc <<'EOF'

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

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

Nếu bạn đã đổi shell mặc định sang bash, hãy thay ~/.zshrc trong các lệnh trên bằng ~/.bash_profile. Dùng echo $SHELL để xem shell hiện tại.
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 dùng Homebrew / npm:

Terminal
brew install --cask claude-code
# hoặc
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.

Ứng dụng giao diện đồ họa không đọc được biến?

Ứng dụng mở từ Dock hoặc Launchpad (như VS Code, Cursor) không nhất thiết tải ~/.zshrc. Cách đơn giản nhất là khởi động VS Code từ terminal bằng code .; hoặc điền trực tiếp địa chỉ API và key trong cài đặt tiện ích, xem VS Code / Cline / Cursor.

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ở ~/.zshrc 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