TokiLabsDocs
系統設定

Linux 設定指南

適用於 Ubuntu、Debian、Fedora、Arch 等主流發行版，以及 WSL 和遠端伺服器。預設以 bash 說明。

一組金鑰即可呼叫所有模型。金鑰只儲存在你自己的瀏覽器中，不會上傳到任何伺服器。
還沒有金鑰？請先到 取得 API 金鑰 建立一組。

1. 開啟終端機

桌面環境按 Ctrl + Alt + T 開啟終端機；伺服器直接 SSH 登入即可。以下指令都以一般使用者執行，不需要 sudo（安裝 Node.js 除外）。

2. 安裝 Node.js

需要 Node.js 18 以上版本。發行版內建的 Node 往往太舊，建議使用 nvm 安裝，不需要 root 權限：

Terminal · nvm (建議)
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
使用系統套件管理員安裝的 Node，npm install -g 可能需要 sudo。使用 nvm 就沒有這個問題。

3. 設定環境變數

設定下面兩個變數，介面網址為 https://api.tokilabs.xyz。

變數名稱值用途
ANTHROPIC_BASE_URLhttps://api.tokilabs.xyzClaude Code、Anthropic SDK
ANTHROPIC_AUTH_TOKENsk-你的金鑰Claude Code
Terminal · bash
cat >> ~/.bashrc <<'EOF'

# Toki Labs · Claude
export ANTHROPIC_BASE_URL="https://api.tokilabs.xyz"
export ANTHROPIC_AUTH_TOKEN="sk-你的金鑰"
EOF
source ~/.bashrc

檢查是否生效

使用 zsh 的話把 ~/.bashrc 換成 ~/.zshrc；使用 fish 請改用 set -Ux ANTHROPIC_BASE_URL https://api.tokilabs.xyz 這樣的寫法。
Terminal
echo $ANTHROPIC_BASE_URL

4. 驗證連線

回傳一段包含 "data" 的 JSON 模型列表，就表示網址和金鑰都沒問題。

Terminal
curl "$ANTHROPIC_BASE_URL/v1/models" -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"
回傳 401 表示金鑰錯誤或已失效；連線逾時請檢查本機的 Proxy 設定，參見 常見問題。

5. 安裝 Claude Code

Terminal · 官方安裝指令碼
curl -fsSL https://claude.ai/install.sh | bash

或者使用 npm 安裝：

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

略過首次啟動時的官方帳號登入引導：

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

進入專案目錄啟動：

Terminal
cd 你的專案目錄
claude

啟動後輸入 /status，看到 Base URL 為 https://api.tokilabs.xyz 即表示已經過 Toki Labs 介面。輸入 /model 可切換模型，例如 claude-opus-5-5。更多設定請見 Claude Code 詳細設定。

伺服器與 Docker

在伺服器上執行排程任務或 systemd 服務時，~/.bashrc 不會被載入。請在 unit 檔案中使用 Environment=，或在 Docker 中用 -e 傳入：

Terminal
docker run --rm \
  -e ANTHROPIC_BASE_URL=https://api.tokilabs.xyz \
  -e ANTHROPIC_AUTH_TOKEN=sk-你的金鑰 \
  your-image

還原設定

不再使用時，刪除這些環境變數即可恢復預設：

Terminal
# 用編輯器開啟 ~/.bashrc，刪除「# Toki Labs · Claude」下面的 2 行 export，然後：
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN