VS Code の Cline AI：エージェントの仕組みと向いている人
Cline のエージェントループ、権限、コスト、安全な開始方法、OpenAI 互換 API の接続を説明します。
Cline は、エディタとターミナルの中で動く AI コーディングエージェントです。コードの読み取り・検索、変更案の作成、コマンド実行、ブラウザの利用、MCP ツールの呼び出しができます。選択したプロバイダーがモデルを実行し、すべての操作は権限システムを通ります。つまり Cline は VS Code の単なるチャットパネルではなく、制御されたエージェントループです。
自分の API キーで Cline を使いたい場合は？ BetterToken の OpenAI 互換エンドポイントに接続できます。BetterToken はモデル API、残高、リクエスト履歴を提供しますが、Cline の開発元ではありません。変わりやすい接続項目をこの記事で複製しないよう、最新の値は BetterToken の Cline 向けドキュメントで確認してください。
Cline を構成する要素
通常のタスクには三つの層があります。
- エディタ：ファイル、diff、メッセージを表示します。
- Cline：コンテキストを集め、ツール呼び出しを提案し、権限を要求します。
- モデルプロバイダー：プロンプトを処理し、応答またはツール呼び出しを返します。
Cline 自体は言語モデルではありません。品質、速度、コンテキスト長、コストは選択したモデルによって決まり、Cline の設定はモデルが利用できるファイルとツールを決めます。
タスクが進む流れ
- ユーザーが、たとえばエラーの原因を特定して修正案を出す、といった目標を指定します。
- Cline が許可されたファイルを読み、関連するコードを検索します。
- モデルが、読む、編集する、コマンドを実行する、質問する、という次の操作を提案します。
- Cline が権限カテゴリを確認し、必要なら承認を待ちます。
- ツールの結果がコンテキストへ戻り、ループが繰り返されます。
- 最後にユーザーが diff とコマンド結果を確認します。
Cline のドキュメントでは、タスクは独立したセッションとして扱われます。会話、変更、コマンド、トークン使用量、見積コスト、実行時間が保持されます。履歴が長く、コンテキストに入るファイルが多いほど、入力トークンの使用量は増えます。
Cline が得意な作業
コードのすぐそばで行う作業に向いています。
- 未知のモジュールを説明し、関連ファイルを探す。
- 既存テストがある範囲の明確なバグを修正する。
- 複数ファイルにまたがる整合的な変更を適用する。
- linter やテストを実行し、出力を解釈する。
- レビュー可能な diff を伴う小さなリファクタリングを準備する。
- 明確なアクセス方針の下で MCP を介して外部ツールを接続する。
最初は小さな読み取り専用タスクにしてください。開いている一つのファイルを読み、目的を説明するよう Cline に依頼し、プロジェクトの変更やコマンド実行はさせません。書き込みを許可する前に、モデルの応答を確認できます。
権限は段階的に有効化する
変更とコマンドは、既定では確認を必須にする方が安全です。Cline では、プロジェクト内の読み取り、ワークスペース外の読み取り、編集、ターミナル、ブラウザ、MCP を個別に管理できます。
実用的な開始プロファイルは次のとおりです。
- プロジェクトファイルの読み取り — 許可する。
- ワークスペース外の読み取り — 無効にする。
- 編集 — 確認を要求する。
- 安全そうなコマンド — 初期タスクでは確認する。
- システムや依存関係を変えるコマンド — 常に手動にする。
- ブラウザと MCP — 具体的に必要になるまで無効にする。
Auto Approve はツール呼び出しごとに評価されます。YOLO モードはファイル、コマンド、ブラウザ、MCP を自動許可するため、既定にすべきではありません。削除、パッケージのインストール、外部副作用を持つコマンド、シークレットへのアクセスは特に危険です。
承認前にはコマンド名だけでなく、引数、作業ディレクトリ、対象ファイルも確認します。checkpoint でファイル編集を戻せても、削除した外部データを復元したり、すでに送信したネットワークリクエストを取り消したりはできません。
コストが発生する場所
クラウドモデルの課金には通常、次が含まれます。
- 入力トークン：プロンプト、ファイル、ルール、タスク履歴。
- 出力トークン：応答、コード、ツール呼び出し。
- 選択したプロバイダーがキャッシュをサポートする場合のキャッシュトークン。
Cline はタスク見出しにコスト見積を表示しますが、最終的な請求はプロバイダーが決めます。BetterToken では、モデル、ステータス、入力・出力・キャッシュトークン、対応する消費を Dashboard で確認できます。完全なプロンプトは表示されません。
コンテキストを無駄にしないために、各タスクへ検証可能な目標を一つ与え、不要にリポジトリ全体を渡さず、広いリファクタリングより検索と読み取りから始めます。関係のない話題へ移るときは新しいタスクを作り、長時間の実行前には選択モデルの現在価格を確認してください。
自分の API を接続する
Cline は複数の認証方法とプロバイダーをサポートします。BetterToken では OpenAI 互換モード、自分の BetterToken API キー、Base URL https://www.bettertoken.ai/v1 を使用します。Model ID は古い記事ではなく、現在のモデル一覧から取得してください。
完全な設定手順は BetterToken Docs にあります。接続後は読み取り専用のリクエストを送り、Dashboard の記録と照合します。記録がなければ Base URL、キー、Model ID、ネットワーク設定を確認してください。キーの値はログやスクリーンショットで公開してはいけません。
別のツールを選ぶ場面
プロジェクトへのアクセスなしに短いチャットだけが必要なら、Cline は過剰かもしれません。繰り返し可能なヘッドレス作業には CLI または CI 連携の方が適しています。中央集権的なポリシーを持つチームでは、モデル品質だけでなく、役割、権限、ログ、予算管理を比較してください。
まとめ
プロジェクトコンテキスト、編集、コマンド、レビュー可能な diff を一つのループに保ちながらエディタでエージェント作業をするなら Cline を選びます。まず読み取り専用の権限で始め、信頼が得られるに従って書き込みとコマンドを有効にします。従量制の自分の API が必要なら、最新ドキュメントに従って BetterToken を接続し、Dashboard でリクエストを監視してください。