FreeToken claude code：モデルルーティングのセットアップガイド

FreeToken claude codeは、Claude Codeと互換性のあるモデルプロバイダーの間にある設定レイヤーとして理解するのが適切です。すべてのクライアント設定を個別に変更する代わりに、ローカルゲートウェイを実行し、1つのAdmin UIでモデルを選択して、ターミナルやエディターのクライアントをそのゲートウェイに接続できます。

実用上の利点は、ルーティングを一元管理できることです。デフォルトモデルで通常のリクエストを処理しながら、個別の設定でFable、Opus、Sonnet、Haiku系のティアを異なる互換モデルにルーティングできます。これによりテストが容易になり、クライアント全体の設定を作り直すことなくプロバイダーを変更できます。

以下の手順を順番に実行してください。次のレイヤーへ進む前に各レイヤーを確認することで、接続エラーを簡単に切り分けられるようにすることが目的です。

最初に成功させるテストは、意図的に簡単なものにしてください。エージェントに小さなプロジェクトファイルの調査、関数の説明、または小規模な変更の提案を依頼します。小さなリクエストであれば認証、モデルへのアクセス、コンテキスト処理、ツール権限を同時に確認できるため、最初から大規模なリファクタリングを始めるのは避けてください。

モデルの選択は、ブランド名だけでなくタスクに合わせて行う必要があります。コーディングエージェントには、信頼性の高いツール呼び出し、プロジェクトの指示を処理するのに十分なコンテキスト、安定した出力形式が求められます。チャットで優れた性能を発揮するモデルでも、ファイルを調査してコマンドを実行する必要があるエージェントには適さない場合があります。

通常のリクエストには、デフォルトのMODEL設定を使用します。複雑な推論、高速な編集、軽量なタスクなどで異なる動作が必要な場合は、ティア固有の変数で個別のClaude Codeティアを上書きできます。

フォールバックを追加する際は、失敗したリクエストが成功するまでに複数のプロバイダーへ送られる可能性があることに注意してください。複数のアカウントの利用量を消費する場合があります。リストは短く保ち、意図的な順序に設定し、確認していないプロバイダーへ機密性の高いプロジェクト内容をルーティングしないでください。

推論制御はクライアントから継承される場合、無効になっている場合、または選択した処理レベルに設定されている場合があります。まずはクライアントのデフォルトを使用してください。より深い計画が役立つタスクにのみ推論レベルを上げます。処理負荷を高くすると、レイテンシやリソース使用量が増加する可能性があります。

Claude Codeは、ローカルのベースURLと認証トークンを通じて接続できます。エディター連携では、同じ値がゲートウェイ設定と完全に一致している必要があります。ポート、URL、トークンの1文字の誤りでも、プロバイダーが正常に動作しているのにプロバイダー障害のように見えることがあります。

VS Codeでは、ゲートウェイの環境変数をClaude Code拡張機能の設定に追加してから、拡張機能を再読み込みします。Codex AppまたはVS Code内のCodexでは、適切なconfig.tomlファイルにプロバイダーとモデルの設定を記述し、モデルを変更した後にクライアントを再起動します。

以下の安全対策を使用してください。

• プロバイダーの認証情報をプロジェクトファイルの外部に保存する。
• localhostの外部にゲートウェイを公開する前に、プロキシ認証を有効にする。
• DiscordまたはTelegram連携へのアクセスを、承認済みのユーザー、チャンネル、ディレクトリに制限する。
• プロンプト、ログ、スクリーンショット、共有設定ファイルに秘密情報を記載しない。
• 各ボットとクライアント連携が要求する権限を確認する。
• ホームフォルダー全体へのアクセスを許可するのではなく、プロジェクトディレクトリを限定する。

セットアップに関する問題の多くは、サーバーが起動していない、クライアントが誤ったアドレスを指定している、トークンが一致していない、選択したモデルが利用できないという4つのカテゴリに分類できます。複数の設定を変更する前に、これらの条件を順番に確認してください。