HammerAI プロキシ モードのセットアップ

HammerAI キャラクター チャットをプロキシ モード経由で TokenHub にルーティングし、長いセッションの前に短い応答を検証します。

HammerAIとは何ですか?

HammerAI は、外部 LLM プロキシ モードを備えたローカル ファースト AI キャラクター チャットおよびライティング アプリケーションです。

この HammerAI ガイドでは、公式のプロキシ モード フィールド (/v1 で終わる API ベース、正確なプロバイダー モデル名、API キー、および既知の場合にのみ設定する必要があるオプションのコンテキスト長) を使用します。プロキシ モードは、キャラクター チャット モデルのリクエストを外部 API にルーティングしますが、HammerAI は引き続きローカル会話インターフェイスを提供します。 API ルートと正確なモデル名を使用し、検証された値が不明な場合はコンテキストの長さを空のままにし、短い応答と長いセッションをテストする前にチャットをリロードします。

HammerAI の公式 Proxy Mode は、キャラクター チャット生成リクエストを外部の OpenAI-compatible サービスに送信します。 4 つのプロキシ フィールドを使用し、ローカル モデルのダウンロードや HammerAI ホスト モデル アカウントは必要ありません。

公式 HammerAI インターフェイスからプロキシを有効にする

  1. 任意のキャラクターチャットを開きます。
  2. 右側のパネルを Settings に切り替えます。
  3. LLM メニューを見つけます。
  4. 一番下までスクロールして、Proxy を選択します。
  5. プロキシ フォームに以下の値を入力します。

4 つのフィールドを TokenHub にマップします。

  • Proxy URL: https://us-api.tokenhub.com/v1
  • Proxy Model: TokenHub モデル カタログの完全なモデル ID
  • Proxy API Key: あなたの TokenHub API キー
  • Proxy Context Length: オプション。実際の制限が不明な場合は空のままにしてください

公式プロキシの例では、完全なリクエスト パスではなく、LM Studio の /v1 などの API ベースを使用します。最近の HammerAI バージョンでは、誤って指定された /chat/completions または /completions サフィックスが削除される場合がありますが、/v1 ルートは直接入力されます。

Web とデスクトップの違いを考慮する

TokenHub はリモート HTTPS サービスであり、通常は追加の CORS 設定は必要ありません。 HammerAI の CORS 手順は、Web アプリが LM Studio などのローカル サービスに接続するときに適用されます。これらのローカルサーバーの命令をリモート TokenHub URL に転送しないでください。

プロキシ構成を有効にする

保存して短いメッセージを 1 つ送信し、TokenHub リクエスト ログでそのモデル ID を確認します。 HammerAI は、一部のサービスでは接続を確立する前にアプリを完全にリロードする必要があることに注意しています。 4 つのフィールドがすべて正しいにもかかわらず応答が届かない場合は、HammerAI をリロードして再度テストします。

長時間チャットが失敗した場合は、最初に Proxy Context Length をクリアまたは修正します。 401 の場合は、Proxy API Key を検査します。 404 の場合、Proxy URL/v1 で停止することを確認します。モデルが存在しない場合は、Proxy Model を再度コピーします。これら 4 つのフィールドをチェックすることは、無関係なローカル モデル パラメーターを適用するよりも便利です。

公式リファレンス

モデルの選び方

用途モデルの方向性理由
複雑なタスクツール対応の推論モデル計画、複数手順、長いコンテキストに向いています。
日常的な利用バランス型モデル品質、速度、コストのバランスを取れます。
要約と軽い作業高速・低コストモデル要約や簡単な反復のコストを抑えます。
TokenHub のモデルを見る

HammerAI プロキシ モードに関するよくある質問

プロキシ URL として何を入力すればよいですか?

/v1 で終わる TokenHub API ベースを入力します。 HammerAI の公式プロキシ モードの例では、完全なリクエスト パスではなくベース URL を使用します。

プロキシコンテキストの長さを入力する必要がありますか?

オプションです。モデルの最大のコンテキストがわからない場合は空白のままにしてください。それ以外の場合は、正確な値を入力してください。

保存後にプロキシが応答しないのはなぜですか?

ベース URL、正確なモデル名、API キーを確認して、チャットをリロードします。 HammerAI の公式ガイドでは、一部のサービスでは完全なリロードが必要であると記載されています。

HammerAI はプロキシ モードでデータをどこに送信しますか?

そのキャラクター チャットのモデル リクエストは設定された外部 API に送信され、HammerAI はローカル インターフェイスを提供します。ご利用前に各サービスのデータ取り扱いをご確認ください。

HammerAI プロキシ モードを安全にテストするにはどうすればよいですか?

保存後にチャットを再読み込みし、短いメッセージを送信し、長い会話の前に TokenHub ログで正確なモデルとリクエストのステータスを確認します。

参考資料

この設定は TokenHub と公式ドキュメントに基づいており、最終確認日は 2026-09-08。