コマンドコード BYOK セットアップ

コマンド コード BYOK を通じて TokenHub に接続し、編集を有効にする前に互換性のあるコーディング モデルを検証します。

コマンドコードとは何ですか?

Command Code は、OpenAI 互換および Anthropic-wire モデル プロバイダー向けの BYOK フローを備えたコマンド ライン コーディング エージェントです。

このコマンド コード BYOK ガイドは、公式の /connect ワークフローに従います。 OpenAI 互換の API ルートを使用し、資格情報をローカル認証ストアに保存し、検出が利用できない場合に手動モデル ID を許可します。公式の BYOK フローは、プロバイダーの資格情報をローカルに保存し、ユーザーが /model を使用して結果のモデルを選択できるようにします。 API ワイヤーを慎重に選択し、ディスカバリーが空の場合は完全なモデル ID を入力し、コマンド コードによる作業リポジトリーの変更を許可する前にコードの読み取りとツール呼び出しを検証します。

Command Code は現在、BYOK をベータとしてマークしています。カスタム プロバイダー ウィザードは、ID、ワイヤ プロトコル、API ルート、キー、モデルを順番に要求します。これは一般的な 3 フィールドのフォームではありません。

公式 BYOK ウィザードを使用して TokenHub を追加します

  1. Command Code で /connect を実行します。
  2. (BYOK) Add your own provider を選択します。
  3. Name it に、小文字の ID tokenhub を入力します。これは ~/.commandcode/providers.json のエントリ名となり、モデルは tokenhub/<model-id> としてルーティングされます。
  4. Pick the wire で、デフォルトの OpenAI-compatible ワイヤ openai-completions を選択します。 Anthropic Messages の場合のみ、anthropic-messages を選択してください。
  5. Point at the endpoint に、API ルート https://us-api.tokenhub.com/v1 を入力します。 Command Code は、誤って貼り付けた /chat/completions をトリミングする可能性がありますが、正しいルートを直接入力する必要があります。
  6. Add the key に、TokenHub API キーを貼り付けます。ウィザードはそれを ~/.commandcode/auth.json に保存します。キーをリポジトリにコミットしないでください。
  7. Declare the models で、ウィザードに /models をリクエストさせます。検出で何も返されない場合は、正確な TokenHub モデル ID を手動で入力します。

入力以外の画面では、h を押して簡潔なヘルプを表示するか、esc を押して前のステップに戻ります。セットアップが完了すると、Command Code によって /model が開き、新しいプロバイダーがその組み込みモデルとともに表示されます。

手動変更が必要な場合は、providers.json のみを編集します

プロバイダー定義は ~/.commandcode/providers.json にあります。 /connect または /model を再度開いて、変更を再読み込みします。

{
  "provider": {
    "tokenhub": {
      "name": "TokenHub",
      "baseURL": "__API_BASE_URL__/v1",
      "api": "openai-completions",
      "apiKey": "$TOKENHUB_API_KEY",
      "models": {
        "YOUR_TOKENHUB_MODEL_ID": {}
      }
    }
  }
}

/connect がすでにキーを保存している場合は、それをプロバイダー ファイルに複製しないでください。モデルは contextWindowmaxOutputreasoningEfforts、および options を宣言することもできますが、その TokenHub モデルに対して検証された機能のみを追加します。

プロバイダー カードからの接続を維持する

/connect を再度実行し、tokenhub を選択します。プロバイダー カードには、エンドポイント、モデル数、およびキーのステータスが表示されます。

  • r: キーを置き換えるか、保存します。
  • u: ワイヤ、ヘッダー、キー参照を変更せずにモデルを再度フェッチします。
  • c: 保存されたキーをクリアします。
  • d: プロバイダーとそのローカル資格情報を削除します。

健全なプロバイダーには、緑色のチェックとモデル数が表示されます。 providers.json が無効な場合、Command Code はファイルを上書きせずに不正なエントリをスキップし、そのパスを /connect または --list-models で報告します。

/model からのルーティングを確認する

/model を実行し、TokenHub グループ内のモデルを選択し、読み取り専用のリポジトリの質問をします。 TokenHub ログのモデル ID と /v1/chat/completions を確認します。 401 の場合は、プロバイダー カードに戻り、r を押します。 404 の場合は、baseURL および api を検査します。モデルが存在しない場合は、u を押すか、providers.json で宣言します。

公式リファレンス

モデルの選び方

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

コマンドコード BYOK FAQ

TokenHub にはどのワイヤーを選択すればよいですか?

/v1 で終わる TokenHub API ルートを使用する場合は、OpenAI 互換を選択してください。

コマンドコードは API キーをどこに保存しますか?

/connect フローは、コマンド コードのローカル認証ストレージにプロバイダー キーを保存します。キーを Providers.json にコミットしないようにします。

モデルリストが空の場合はどうなりますか?

BYOK フローまたは Providers.json に正確な TokenHub モデル ID を手動で入力し、/model でそれを選択します。

BYOK セットアップ後にコマンド コードを安全にテストするにはどうすればよいですか?

/model を使用して TokenHub モデルを選択し、読み取り専用リポジトリの質問から始めます。編集またはコマンド権限を付与する前に、リクエスト ログを確認してください。

コマンド コードが間違ったエンドポイントに到達するのはなぜですか?

/connect 中に選択したワイヤを確認してください。 Anthropic Messages エンドポイントを意図的に構成しない限り、TokenHub /v1 ルートは OpenAI 互換ワイヤに属します。

参考資料

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