ローカルモデルを Tokios に接続する

Tokios はアウトバウンド専用のトンネルを介してプライベートなモデルに到達します。マシン上でインバウンドのトラフィックを待ち受けるものは何もありません。このクイックスタートでは、3 つのマイルストーンを順を追って説明します。ランタイムの接続、トンネルの動作確認、そしてクライアントの接続です。まず tokios.com/console にサインインし、Setup タブを開きます。（初回の場合、確認リンクからメールを確認してください。有効期限は 24 時間です。）

マイルストーン 1: ランタイムの接続

コネクタをインストールし、モデルを登録して、Tokios からアクセスできるようにします。

コネクタのペアリング

コンソールのSetup タブで、任意でコネクタに名前を付け、Start pairing をクリックします。Tokios は、約 15 分間有効なワンタイムのペアリングコード（TKS-XXXX-XXXX）を表示します。ペアリングコードはペアリング用のハンドルであり、API キーではありません（API キーはマイルストーン 3 で作成します）。

コネクタのインストールと承認

モデルが動作しているマシンで、コンソールに表示される OS 用のインストールコマンドを実行します。

irm https://tokios.com/downloads/install/windows | iex; tokios-install -Code 'TKS-XXXX-XXXX'

curl -fsSL https://tokios.com/downloads/install/macos | sh -s -- --code TKS-XXXX-XXXX

curl -fsSL https://tokios.com/downloads/install/linux | sh -s -- --code TKS-XXXX-XXXX

なお、tokios-connector がすでにインストールされている場合は、インストーラーをスキップしてペアリングコードを直接渡します。

Already installed

tokios-connector TKS-XXXX-XXXX

コネクタは単一の WebSocket を介して外部にダイヤルします。インバウンドポートもパブリック IP も不要です。コンソールに戻り、デバイスをapproveします。トークンはトンネルを介して安全に配信されるため、ファイルに貼り付ける必要はありません。

モデルの登録

コンソールのModels タブで、公開するモデルと、クライアントが使用する公開名を選択します。例えば、gemma-tunnel のような名前です。この公開名は、すべての API リクエストにおける "model" の値となります。

成功状態: モデルがアクティブなコネクタと共に Models タブに表示されます。トンネルはライブ状態ですが、まだテストは行っていません。

マイルストーン 2: エンドツーエンドの検証

API キーを作成する前に、Playground でテストします。これにより、トンネルとモデルが連携して動作することを確認できます。

Playground で試す

まずPlayground タブを開き、モデルを選択し、プロンプトを入力して、Run をクリックします。Playground は現在のセッションで認証を行うため、API キーは不要です。これにより、クライアントを接続する前にトンネルが動作することを確認できます。成功状態: Tokios エンドポイントを介してローカルモデルからレスポンスが返ります。Playground が完了を返す場合、トンネルは正常に動作しており、クライアントの接続準備が整っています。

Playground がタイムアウトする場合は、ローカルモデルが実行中で、コンソールでコネクタがConnected 状態であることを確認してください。一般的な修正方法については、トラブルシューティングを参照してください。

マイルストーン 3: クライアントの接続

API キーを作成し、コーディングエージェントを Tokios 向けに設定します。

API キーの作成

コンソールのKeys タブで、Create key をクリックします。表示名を付け、任意でスコープを制限するモデルパターンを指定します（すべてのモデルを許可する場合は * のままにします）。sk-tok-… キーをすぐにコピーしてください。これは一度しか表示されません。

クライアントの設定とテスト

クライアントを選択します。それぞれ、方言に応じたベース URL、sk-tok-… キー、公開モデル名が必要です。

Anthropic スタイル（Claude Code）: https://api.tokios.com
OpenAI スタイル（Codex、OpenAI SDK）: https://api.tokios.com/v1

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

export OPENAI_API_KEY=sk-tok-YOUR_KEY
# add a Tokios provider to ~/.codex/config.toml:
#   base_url = "https://api.tokios.com/v1"  ·  wire_api = "responses"
codex --profile tokios

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

クライアント別の完全なセットアップ: Claude Code · OpenAI Codex。正常な呼び出しは、クライアントの方言に合わせた形状の完了を返します。上記の curl の場合、OpenAI 形状のレスポンス（省略）が返ります。

{
  "model": "gemma-tunnel",
  "choices": [
    {
      "message": { "role": "assistant", "content": "Hello! How can I help?" },
      "finish_reason": "stop"
    }
  ]
}

成功状態: クライアントが Tokios を介してローカルモデルと通信します。レスポンスはクラウドプロバイダーではなく、ご自身のハードウェアから返されます。

次のステップ

Claude Code との併用

Claude Code を Tokios 向けに設定し、ご自身のローカルモデルに対してコーディングエージェントを実行します。

より多くのモデルを公開する

設定ファイルを使用して、単一のコネクタを介して複数のモデルを提供します。

はじめに

モデル

概念

リファレンス

ローカルモデルを Tokios に接続する

マイルストーン 1: ランタイムの接続

マイルストーン 2: エンドツーエンドの検証

マイルストーン 3: クライアントの接続

次のステップ

Claude Code との併用

より多くのモデルを公開する

​マイルストーン 1: ランタイムの接続

​マイルストーン 2: エンドツーエンドの検証

​マイルストーン 3: クライアントの接続

​次のステップ

Claude Code との併用

より多くのモデルを公開する

マイルストーン 1: ランタイムの接続

マイルストーン 2: エンドツーエンドの検証

マイルストーン 3: クライアントの接続

次のステップ