VS Code の Cline とは何ですか?
Cline は、VS Code 用のオープンソース コーディング エージェントであり、カスタム OpenAI 互換 API を使用してコードを読み取り、編集を提案し、承認されたツールを実行できます。
この Cline VS Code セットアップでは、プロバイダーの資格情報とモデルの選択が Cline 独自の設定に保持され、書き込みアクセスが承認される前に読み取り専用のコーディング タスクとの接続が検証されます。 Cline は、モデル応答とファイル アクセス、ターミナル コマンド、ブラウザー アクション、およびエディター内の承認コントロールを組み合わせます。チャット応答が成功するかどうかは、最初のチェックにすぎません。テスト ワークスペースを使用し、最初は自動承認を無効にし、編集や長時間の自律タスクでモデルに依存する前にネイティブ ツールの呼び出しを検証します。
Cline は TokenHub の OpenAI compatible 互換 API ゲートウェイ経由でモデルリクエストを送信できます。公式のインストール手順はそのまま使い、API key、Base URL、モデル ID だけを置き換えます。
このガイドで使う TokenHub endpoint は https://us-api.tokenhub.com/v1/chat/completions です。
使う場面
小さなリポジトリや検証用プロジェクトから始めます。まずは読み取り、コード説明、計画作成を試し、その後で編集や自動化タスクを有効にします。
インストールまたは起動
まず Cline 公式ドキュメント に従ってインストールまたは起動します。画面名が違う場合は現在の公式ドキュメントを優先してください。
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 | Cline settings panel |
| Provider mode | OpenAI Compatible |
| Required fields | Base URL, API Key, Model ID |
拡張機能が独自 schema を持つ場合は、まず設定 UI を使ってください。UI は同じ値をユーザー設定に保存し、バージョンで変わる内部キーを推測せずに済みます。
ツール UI で TokenHub provider を保存します。Chat、Edit、Apply、Fast、Autocomplete が分かれている場合、最初のテストでは全て TokenHub に向けます。
ツールが 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 など全てのモデル欄を再確認します。 |
モデルの選び方
Cline for VS Code API FAQ
Cline の TokenHub 設定はどこに保存すればよいですか?
Cline の API プロバイダー設定パネルから保存します。チームのドキュメントではベース URL とモデル ID を共有できますが、実際の API キーを共有することはできません。
なぜクラインは質問には答えられるのに、ファイルを編集できないのでしょうか?
まずモデルがツールの使用をサポートしていることを確認し、次に Cline のファイル書き込み権限と承認設定を確認します。テキスト応答は、基本接続が機能していることを証明するだけです。
ワークスペースを再開した後にプロバイダーが変更されたのはなぜですか?
ワークスペースレベルの構成はユーザー設定をオーバーライドする場合があります。アクティブなプロバイダー、ベース URL、およびモデル ID が依然として TokenHub を指していることを確認します。
Cline API のコストはどのように計算されますか?
拡張機能とモデル API は別個の課金レイヤーです。 TokenHub は、選択したモデルの実際のトークンと該当するキャッシュ使用量に応じて、現在のモデル ページの価格で料金を請求します。
Cline ルールと .clinerules は何をしますか?
これらは、プロジェクトの規則、コマンドの制約、およびワークフローのガイダンスを提供します。これらは、プロバイダーのベース URL、API キー、またはモデル ID 構成を置き換えるものではありません。
参考資料
この設定は TokenHub と公式ドキュメントに基づいており、最終確認日は 2026-09-04。
