Tokiosを利用して独自のローカルモデルとClaude Codeを連携させる方法

Claude Codeは二つの環境変数を参照して、リクエストをどこに送信するかを決定します。 ANTHROPIC_BASE_URL をTokiosのアドレスに設定し、ご自身のTokios APIキーも指定すれば、Claude Codeは Ollama、LM Studio、llama.cpp、vLLM 上で動作するローカルモデルに接続できるようになります。これはモデルを実行しているマシンだけでなく、どのマシンからでも可能です。すべてのリクエストはご自身のプライベートなトンネルを通って自前のハードウェアへと送信されます。

前提条件

A running Tokios Connector paired with your local model — see Connector Install
A registered model deployment name — see Register a Model
A Tokios API key — see 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 の生の値が設定され、独自のAPIキーを発行するゲートウェイでも問題なく利用可能になります。

~/.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はそれをローカルバックエンドが求める形式に変換し、応答をストリーム形式で返送します。

ハードウェアと互換性

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

クライアント接続

比較

Tokiosを利用して独自のローカルモデルとClaude Codeを連携させる方法

前提条件

環境設定

設定内容を永続化する

接続を確認する

​前提条件

​環境設定

​設定内容を永続化する

​接続を確認する

前提条件

環境設定

設定内容を永続化する

接続を確認する