Claude Code を自分のローカルモデルで使用する

Claude Codeはふたつの環境変数を参照してリクエストの送信先を決定します。 ANTHROPIC_BASE_URL をTokiosに向け、Tokios APIキーを設定すれば、Claude Codeは Ollama、LM Studio、llama.cpp、vLLM 上のローカルモデルに対して動作します。モデルを実行しているマシンだけでなく、どのマシンからでも利用可能です。すべてのリクエストはプライベートなトンネルを経由して自前のハードウェアに送信されます。

前提条件

ローカルモデルとペアリング済みのTokiosコネクターが動作していること — Connector install
登録済みのモデルデプロイ名 — Register a model
Tokios APIキー — API Keys
Claude Codeがインストール済みであること

環境の設定

Windows CMD
macOS & Linux

claude-code-windows.cmd

set ANTHROPIC_BASE_URL=https://api.tokios.com
set ANTHROPIC_API_KEY=sk-tok-YOUR_KEY
claude --model gemma-tunnel

claude-code-unix.sh

export ANTHROPIC_BASE_URL=https://api.tokios.com
export ANTHROPIC_API_KEY=sk-tok-YOUR_KEY
claude --model gemma-tunnel

必ず登録済みのモデル名を --model で指定してください。Claude Codeのモデルピッカーには claude* のIDのみが表示されるため、Tokiosのモデルは表示されません。明示的に名前を指定することで、リクエストがご自身のデプロイにルーティングされます。

設定を永続化する

新しいターミナルセッションごとに変数をエクスポートする手間を省くため、Claude Code自身の設定ファイル、シェルプロファイル、または .env ファイルに追加します。 ~/.claude/settings.json シェルに依存せずClaude Codeの設定と共に保存されるため、最も移植性の高い方法です。プロジェクト単位でスコープする場合は、プロジェクト内の .claude/settings.json を使用します。

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tokios.com",
    "ANTHROPIC_API_KEY": "sk-tok-YOUR_KEY"
  }
}

Claude Codeはこのファイルを起動時に読み込むため、既に開いているセッションは再起動するまで編集内容を反映しません。キーがここで拒否される場合は、 ANTHROPIC_API_KEY を ANTHROPIC_AUTH_TOKEN に置き換えてください。これは生の Authorization: Bearer 値を設定するもので、独自キーを発行するゲートウェイが期待する形式です。

~/.bashrc または ~/.zshrc シェルプロファイルを開いて以下を追記します。

export ANTHROPIC_BASE_URL=https://api.tokios.com
export ANTHROPIC_API_KEY=sk-tok-YOUR_KEY

その後、再読み込みします。

source ~/.bashrc   # or source ~/.zshrc

.env ファイル ワークフローが .env ファイルをサポートしている場合（例えば direnv やシェルプラグイン経由）、プロジェクトルートに .env を作成します。

.env

ANTHROPIC_BASE_URL=https://api.tokios.com
ANTHROPIC_API_KEY=sk-tok-YOUR_KEY

Claude Codeを起動する前に読み込みます。

export $(cat .env | xargs) && claude --model gemma-tunnel

接続の確認

クイックなワンショットプロンプトを実行し、Claude CodeがTokios経由でローカルモデルに到達しているかを確認します。

claude --model gemma-tunnel -p "Say hello"

期待される出力：

Hello! How can I help you today?

応答が表示されれば、リクエストがTokiosゲートウェイを経由してローカルモデルに正常に流れています。

Claude CodeはAnthropicメッセージ形式でリクエストを送信します。Tokiosはそれをローカルバックエンドが期待する形式に変換し、レスポンスをストリームで返します。

ハードウェアと互換性

サービングとランタイム接続

クライアント接続

比較

Claude Code を自分のローカルモデルで使用する

前提条件

環境の設定

設定を永続化する

接続の確認

​前提条件

​環境の設定

​設定を永続化する

​接続の確認

前提条件

環境の設定

設定を永続化する

接続の確認