キロコードとは何ですか？
Kilo AI の Kilo Code は、VS Code、JetBrains、および CLI で利用可能なオープンソース AI コーディング エージェントであり、構成可能なモデル プロバイダーを備えています。
この Kilo Code セットアップ ガイドでは、OpenAI 互換のプロバイダー コントロールを使用して TokenHub に接続します。読み取り専用タスクから始めて、ツール対応モデルを使用して編集とコマンドを検証します。 Kilo Code は、VS Code、JetBrains、および CLI で関連するワークフローを公開しますが、構成スコープはこれらのクライアント間で異なる場合があります。実際に使用しているクライアントでアクティブなプロファイルとプロバイダーを確認し、モデルの品質、ツールの信頼性、レイテンシ、コンテキストの長さ、代表的なリポジトリ タスクのコストを比較します。
Kilo Code は TokenHub の OpenAI compatible 互換 API ゲートウェイ経由でモデルリクエストを送信できます。公式のインストール手順はそのまま使い、API key、Base URL、モデル ID だけを置き換えます。
このガイドで使う TokenHub endpoint は https://us-api.tokenhub.com/v1/chat/completions です。
使う場面
小さなリポジトリや検証用プロジェクトから始めます。まずは読み取り、コード説明、計画作成を試し、その後で編集や自動化タスクを有効にします。
インストールまたは起動
まず Kilo Code 公式ドキュメント に従ってインストールまたは起動します。画面名が違う場合は現在の公式ドキュメントを優先してください。
CLI ツールの場合、TokenHub 認証情報を追加する前に実行ファイルが使えることを確認します：
# open the tool, then open its model or provider settingsTokenHub 認証情報を準備
TokenHub API key を作成し、TokenHub のモデル一覧からこのツールに適したモデルを選びます。
export TOKENHUB_API_KEY="sk-..."キーはローカル shell、IDE のシークレット保存領域、またはツールの安全な API key 欄に保存します。リポジトリにはコミットしないでください。
TokenHub プロバイダーを設定
Models、Providers、API Keys、OpenAI Compatible などの設定画面で次の値を入力します。
Provider の値
| 項目 | 値 |
|---|---|
| プロバイダー | OpenAI Compatible または Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | TOKENHUB_API_KEY の値 |
| モデル | gpt-4.1 または別の TokenHub model ID |
設定ファイルの場所
| 項目 | 値 |
|---|---|
| Provider settings | Kilo Code → Providers → Custom provider |
| Provider API | OpenAI Compatible |
| Required fields | Provider ID, Base URL, API Key, Model ID |
Save the custom provider in Kilo Code, let it fetch /v1/models when available, or add the TokenHub model ID manually. Verify a chat request before enabling agent edits.
ツールが chat、edit、apply、fast model を分けている場合、最初のテストでは同じ TokenHub モデルを使います。動作確認後にコスト、レイテンシ、推論力で分けます。
一時環境変数はデバッグ用
拡張機能が独自 schema を持つ場合は、まず設定 UI を使ってください。UI は同じ値をユーザー設定に保存し、バージョンで変わる内部キーを推測せずに済みます。
一時変数は key、ネットワーク、モデル名の確認にだけ使います。確認後は同じ値を上の永続設定に移してください。
接続を確認
まず読み取り専用のプロンプトで、モデルが文脈を読めること、ファイルを変更しないことを確認します。その後、編集や Agent タスクを試します。
このプロジェクトの README を読み、3 文で要約してください。ファイルは変更しないでください。プロンプトが成功したら、TokenHub のリクエストログでモデル名、endpoint、token 使用量、課金グループを確認します。
トラブルシューティング
| 症状 | 対処 |
|---|---|
| 401 または認証失敗 | TOKENHUB_API_KEY が有効で、同じ terminal、IDE、クライアントプロファイルに保存されているか確認します。 |
| 404 またはモデルが見つからない | TokenHub ワークスペースに存在し、選択したプロトコルに対応するモデル ID を使います。 |
| endpoint が違う | 上記の Base URL と完全に一致させます。OpenAI 互換ツールは通常 /v1 が必要で、Claude 互換ツールは通常不要です。 |
| リクエストがタイムアウトする | https://us-api.tokenhub.com へのネットワーク、プロキシ設定、ワークスペースの allowlist を確認します。 |
| 別のモデルが使われる | chat、edit、apply、fast、autocomplete など全てのモデル欄を再確認します。 |
モデルの選び方
Kilo Code カスタム API に関するよくある質問
Kilo Code が TokenHub モデル リストを読み取れないのはなぜですか?
自動モデル検出が失敗しても、必ずしも API が使用できないことを意味するわけではありません。 TokenHub から正確なモデル ID をコピーし、手動で入力します。
チャットは機能するが、タブ補完が機能しない場合はどうすればよいですか?
チャットとタブでは異なるモデル スロットを使用できます。 Tab 用に低レイテンシーの補完互換モデルを構成し、個別に検証します。
IDE が TOKENHUB_API_KEY を読み取れないのはなぜですか?
デスクトップ アイコンから起動された IDE は、ターミナル環境変数を継承しない場合があります。 Kilo Code の安全な API キー フィールドを使用して、初期検証を完了します。
Kilo Code CLI と IDE 拡張機能は 1 つのモデル構成を共有しますか?
同じ TokenHub モデルを使用できますが、構成スコープとプロファイルが異なる場合があります。各クライアントのベース URL、キー、モデル、およびアクティブなプロファイルを確認します。
Kilo Code はチャットできるが、コードを編集できない場合はどうすればよいでしょうか?
モデルがネイティブ ツール呼び出しと構造化引数をサポートしていることを確認し、編集権限とコマンドの承認を確認します。基本的なテキスト生成では、エージェント ツール チェーンは検証されません。
参考資料
この設定は TokenHub と公式ドキュメントに基づいており、最終確認日は 2026-09-04。
