TokiLabsDocs
系統設定

macOS 設定指南

適用於 macOS 12 以上（Intel 與 Apple 晶片皆可）。macOS 預設使用 zsh，設定寫入 ~/.zshrc。

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

1. 開啟終端機

按 ⌘ + 空白鍵 搜尋「終端機」（Terminal）並開啟。也可以使用 iTerm2 等第三方終端機。

2. 安裝 Node.js

建議使用 Homebrew 安裝 Node.js 18 以上版本。沒有 Homebrew 的話請先安裝：

Terminal
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Terminal
brew install node
node -v
不想安裝 Homebrew，也可以從 nodejs.org 下載 LTS 版 .pkg 安裝檔。

3. 設定環境變數

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

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

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

檢查是否生效

如果你把預設 shell 換成了 bash，請把上面指令中的 ~/.zshrc 改成 ~/.bash_profile。可以用 echo $SHELL 查看目前的 shell。
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

或者使用 Homebrew / npm：

Terminal
brew install --cask claude-code
# 或
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 詳細設定。

圖形介面應用程式讀不到變數？

從 Dock 或啟動台開啟的應用程式（如 VS Code、Cursor）不一定會載入 ~/.zshrc。最簡單的方法是在終端機裡用 code . 啟動 VS Code；或者直接在擴充功能設定中填寫介面網址和金鑰，參見 VS Code / Cline / Cursor。

還原設定

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

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