TokiLabsDocs
OS 別設定

Linux 設定ガイド

Ubuntu、Debian、Fedora、Arch などの主要ディストリビューション、および WSL やリモートサーバー向けです。bash を前提に説明します。

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

1. ターミナルを開く

デスクトップ環境では Ctrl + Alt + T でターミナルを開きます。サーバーの場合は SSH でログインしてください。以下のコマンドはすべて一般ユーザーで実行し、sudo は不要です(Node.js のインストールを除く)。

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

Node.js 18 以上が必要です。ディストリビューション付属の Node は古いことが多いため、root 権限が不要な nvm でのインストールをおすすめします:

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. 環境変数を設定

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

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

# Toki Labs · Claude
export ANTHROPIC_BASE_URL="https://api.tokilabs.xyz"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
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 が返る場合はキーが誤っているか無効です。接続がタイムアウトする場合はプロキシ設定を確認してください。よくある質問 も参照してください。

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

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

サーバーと Docker

サーバーで cron ジョブや systemd サービスを実行する場合、~/.bashrc は読み込まれません。unit ファイルで Environment= を使うか、Docker では -e で渡してください:

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

設定を元に戻す

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

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