TokiLabsDocs
OS 別設定

macOS 設定ガイド

macOS 12 以降（Intel・Apple シリコンどちらも可）向けです。macOS は標準で zsh を使用し、設定は ~/.zshrc に書き込みます。

1 つのキーですべてのモデルを利用できます。キーはお使いのブラウザ内にのみ保存され、どのサーバーにも送信されません。
まだキーがない場合は、先に API キーの取得 で作成してください。

1. ターミナルを開く

⌘ + スペース を押して「ターミナル」（Terminal）を検索し、開きます。iTerm2 などのサードパーティ製ターミナルも使用できます。

2. Node.js をインストール

Node.js 18 以上は Homebrew でのインストールをおすすめします。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. 環境変数を設定

次の 2 つの変数を設定します。API アドレスは https://api.tokilabs.xyz です。

変数名値用途
ANTHROPIC_BASE_URLhttps://api.tokilabs.xyzClaude Code、Anthropic SDK
ANTHROPIC_AUTH_TOKENsk-your-keyClaude Code
Terminal · zsh
cat >> ~/.zshrc <<'EOF'

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

反映されているか確認

デフォルトのシェルを bash に変更している場合は、上のコマンドの ~/.zshrc を ~/.bash_profile に置き換えてください。現在のシェルは echo $SHELL で確認できます。
Terminal
echo $ANTHROPIC_BASE_URL

4. 接続を確認

"data" を含む JSON のモデル一覧が返れば、アドレスとキーは正しく設定されています。

Terminal
curl "$ANTHROPIC_BASE_URL/v1/models" -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"
401 が返る場合はキーが誤っているか無効です。接続がタイムアウトする場合はプロキシ設定を確認してください。よくある質問 も参照してください。

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 your-project
claude

起動後に /status と入力し、Base URL が https://api.tokilabs.xyz になっていれば Toki Labs 経由で接続されています。/model でモデルを切り替えられます（例：claude-opus-5-5）。その他の設定は Claude Code 詳細設定 をご覧ください。

GUI アプリで変数が読み込まれない場合

Dock や Launchpad から起動したアプリ（VS Code、Cursor など）は ~/.zshrc を読み込まないことがあります。最も簡単なのはターミナルで code . を実行して VS Code を起動する方法です。または、プラグインの設定に API アドレスとキーを直接入力してください。VS Code / Cline / Cursor を参照してください。

設定を元に戻す

使用をやめる場合は、これらの環境変数を削除すればデフォルトに戻ります：

Terminal
# エディタで ~/.zshrc を開き、「# Toki Labs · Claude」の下にある 2 行の export を削除してから：
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN