Cline AIとは？VS Codeへのインストール、API設定、安全なコード作業の始め方

Clineは、Cline AI、ClineAI、Cline agentなどの名前でも検索される、オープンソースのAIコーディングエージェントです。エディターとターミナルの中で動作し、VS Codeではプロジェクトファイルの読み取り、コード検索、ファイル編集、ターミナルコマンドの実行、ブラウザーやMCPツールの利用ができます。各操作をどこまで許可するかは、ユーザーが権限で管理します。Cline自体は大規模言語モデルではなく、選択したモデルプロバイダーへ接続して推論とコード生成を行います。

この記事では、Clineとは何か、VS Codeへインストールする方法、OpenAI Compatibleで自分のAPIを接続する方法、そして不要な権限を与えずに設定を確認する方法を順番に説明します。設定例にはBetterTokenを使いますが、基本的な考え方はほかの互換endpointにも応用できます。

最初に要点

• Clineはコーディングエージェントであり、モデルそのものではありません。
• VS Code拡張機能を入れた後、Clineのモデルアクセス方式か、自分のAPI Keyを選べます。
• BetterTokenを使う場合はOpenAI Compatibleを選び、Base URLにhttps://www.bettertoken.ai/v1を入力します。
• 最初はプロジェクトファイルの読み取りだけを許可し、自動編集、コマンド、ブラウザー、MCP、YOLO Modeはすぐに有効化しないでください。

Cline、VS Code、モデルAPIの役割

一般的なClineのタスクは、次の3層で動きます。

1. VS Codeがプロジェクト、会話、diff、ターミナル出力、承認画面を表示します。
2. Cline agentがコンテキストを集め、ツールを選び、作業手順を組み立て、権限を確認します。
3. モデルAPIがコンテキストを受け取り、分析、コード、次のツール呼び出し案を返します。

そのため、結果は拡張機能だけで決まりません。モデルは推論やコードの品質、速度、コンテキスト長、料金に影響します。一方、Clineの設定は、モデルがどのファイルやツールを利用できるか、どの操作で承認を求めるかを決めます。

通常のチャット拡張との大きな違いもここにあります。チャットは主に文章を返しますが、Clineは「情報を読む → 次の手順を提案する → ツールを実行する → 結果を確認する」というエージェントループを繰り返し、タスクの完了またはユーザー判断が必要な地点まで進みます。

VS CodeにClineをインストールする方法

1. VS Codeを開きます。
2. Ctrl/Cmd + Shift + Xを押してExtensionsを開きます。
3. Clineを検索し、公式のCline拡張機能を選びます。
4. Installをクリックします。
5. インストール後、Activity BarからClineを開きます。
6. 初期画面でUse your own API keyを選び、カスタムプロバイダーの設定へ進みます。

インストール後にアイコンが表示されない場合は、Developer: Reload Windowを実行するか、VS Codeを完全に再起動してください。バージョンによって表示名が少し変わることはありますが、Providerとモデルの設定はClineのサイドバーから開けます。

API接続前に準備するもの

ClineをBetterTokenへ接続するには、次のものが必要です。

• BetterTokenアカウント
• 専用に作成したAPI Key
• モデルと料金ページからコピーした最新のModel ID
• endpointへ接続できるネットワーク環境
• 最新版のVS CodeとCline拡張機能

API Keyはパスワードと同じように扱ってください。リポジトリ、スクリーンショット、ログ、Issue、公開設定ファイルには載せないでください。チームでは、ユーザーや環境ごとに別のKeyを発行すると、利用上限、失効、リクエスト追跡を管理しやすくなります。

ClineにBetterToken APIを設定する

Clineの設定を開き、次の値を入力します。

項目	入力する値
API Provider	OpenAI Compatible
Base URL	https://www.bettertoken.ai/v1
API Key	BetterTokenのAPI Key
Model	モデルページにある現在の正確なModel ID

設定時は、次の点に注意してください。

1. Base URLはhttps://www.bettertoken.ai/v1です。末尾に/chat/completions、/responses、その他の具体的なAPIパスを追加しないでください。
2. Model IDは古い記事や画像からではなく、現在のモデル一覧から完全に同じ文字列をコピーしてください。
3. 通常、追加のUser-AgentやカスタムHeaderは不要です。上流サービスの公式ドキュメントで明示された場合だけ設定します。
4. すべてのモデルが同じプロトコルで動くとは限りません。BetterTokenのCline設定ドキュメントで、現在確認されている互換範囲を参照してください。

以前にOpenAI用の環境変数を設定していて、Clineが古いendpointへ接続してしまう場合は、macOSまたはLinuxの現在のシェルで次を実行します。

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Windows PowerShellでは次を実行します。

Remove-Item Env:OPENAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:OPENAI_BASE_URL -ErrorAction SilentlyContinue

入力後にDoneで保存し、Clineを再読み込みします。Base URL、API Key、Modelを変更した後は、新しいタスクを作成してください。古いセッションに以前の設定や大きすぎるコンテキストが残るのを避けられます。

最初のリクエストは読み取り専用で試す

最初から「プロジェクト全体をリファクタリングして」と頼まないでください。通常のコードファイルを1つ開き、次のプロンプトを送ります。

現在開いているファイルだけを読んでください。このファイルの目的、主な入力、出力を説明してください。ファイルは変更せず、ターミナルコマンドも実行しないでください。

初回テストが成功したと判断できる条件は次のとおりです。

• Clineがファイル内容に基づいて説明する
• 認証、モデル、接続に関するエラーが出ない
• ファイル変更やコマンド実行が発生しない
• BetterToken DashboardにリクエストとToken使用量が表示される

Clineから回答はあるのにDashboardに記録がない場合は、実際に選ばれているProviderがOpenAI Compatibleか確認し、Base URL、API Key、Model ID、ネットワークプロキシを順番に見直してください。サポートへ相談するときも、完全なKeyをスクリーンショットに含めないでください。

Clineがコードタスクを進める流れ

一般的なタスクは次の流れで進みます。

1. ユーザーが目的、変更を許可する範囲、完了条件を伝えます。
2. Clineが関連ファイルを読み、呼び出し関係や関連コードを検索します。
3. モデルが次の手順として、追加の読み取り、編集、テスト、質問などを提案します。
4. Clineが権限カテゴリを確認し、必要なら承認を求めます。
5. ツールの結果がコンテキストへ戻り、モデルが次の手順を判断します。
6. ユーザーが最終的なdiff、コマンド出力、テスト結果を確認します。

進め方が明確でないタスクは、Plan Modeから始めます。このモードでは、Clineはコードを調べて方針を話し合えますが、ファイル変更やコマンド実行はしません。方針を確認した後、Act Modeへ切り替えて実装させます。

Plan Modeの例です。

ログインendpointが時々HTTP 500を返す原因を調査してください。関連するコードとテストだけを読み、可能性の高い原因、影響するファイル、最小で安全な修正案を列挙してください。コードは変更しないでください。

計画を確認したらAct Modeへ切り替えます。

確認済みの最小修正を実装してください。変更対象はログインendpointと直接関係するテストだけに限定します。最も関連するテストを実行し、成功したら停止してください。他のモジュールはリファクタリングしないでください。

「ログインを直して」だけよりも、結果を確認しやすくなります。

初回におすすめする権限設定

最初は次のような保守的な設定にします。

権限	初期設定の目安
Read project files	有効
Read all files / workspace外	無効
Edit project files	毎回確認、または最初は無効
Execute safe commands	最初の数回は手動確認
Execute all commands	無効
Use the browser	必要なタスクだけ有効
Use MCP servers	対象サーバーを検証してから有効
YOLO Mode	実プロジェクトでは無効

コマンドを承認するときは、コマンド名だけでなく、引数、作業ディレクトリ、対象ファイルも確認してください。npm testとnpm installでは影響が異なり、git statusとgit pushも同じではありません。

CheckpointsやGitはローカルのコード変更を戻す助けになりますが、外部へ送信済みのネットワークリクエスト、削除されたクラウドデータ、漏えいしたシークレットを元に戻すことはできません。重要なリポジトリではbranchまたはworktreeを使い、機密ファイルを必要なくエージェントのアクセス範囲へ入れないようにしてください。

API、MCP、Cline Rulesの違い

この3つは役割が異なります。

• モデルAPIは、Clineが分析、計画、生成を行うための知能を提供します。
• MCPは、データベース、外部サービス、社内システムなどのツールとデータソースを追加します。
• Cline Rulesは、コーディング規約、アーキテクチャ上の制約、テスト要件、作業ルールを伝えます。

MCPはモデルAPIの代わりにはなりません。安全な順序は、まずAPIを接続して読み取り専用テストを通し、次にプロジェクトのRulesを追加し、最後に明確な用途がある信頼できるMCPサーバーだけを接続することです。MCPの認証情報は、リポジトリへ直接書かず、環境変数や安全なシークレット管理へ保存してください。

Clineの料金はどこで発生するか

Clineはオープンソースですが、モデルの実行には計算資源が必要です。Clineには組み込みの従量課金、サブスクリプション、BYOKなど複数のモデルアクセス方法があります。BetterTokenは自分のAPIを使う方式なので、最終的な料金は選択したモデルへ送ったリクエストによって決まります。

使用量には、通常次が含まれます。

• input tokens：プロンプト、プロジェクトファイル、Rules、タスク履歴
• output tokens：回答、生成コード、tool callsの内容
• cache tokens：選択したモデルとendpointがキャッシュに対応する場合のみ

Cline内の料金表示は一般に推定値です。最終的な記録はプロバイダーの請求またはBetterToken Dashboardで確認してください。無駄なコンテキストと費用を減らすには、次を意識します。

• 1つのタスクに検証可能な目標を1つだけ設定する
• 理由なくリポジトリ全体を読み込ませない
• 広範囲の変更前に検索と読み取りを行う
• 話題が変わったら新しいタスクを作る
• 長時間実行の前に現在のモデル価格を確認する
• 単純な作業ではtool callingが安定した高速で安価なモデルを検討する
• 大きな変更は先にPlanして、やり直しを減らす

よくあるエラーと確認方法

症状	最初に確認すること
401、Unauthorized、Invalid API Key	Keyの文字列、前後の空白、失効の有無
404	Base URLがhttps://www.bettertoken.ai/v1と完全一致し、APIパスを追加していないか
model not found	現在のModel IDを大文字小文字や記号まで完全にコピーしたか
保存後も古い設定が使われる	保存後に拡張機能またはVS Codeを再読み込みし、新しいタスクを作ったか
接続が繰り返し失敗する	ローカルネットワーク、プロキシ、ファイアウォール、DNS
回答はあるがDashboardに記録がない	現在のProvider、アカウント、古い環境変数、Base URL
出力が不自然、ツールが失敗する	モデルがagent/tool callingに適しているか、モデル設定が正確か
Token消費が急に増える	コンテキスト過多、長い履歴、同じファイルの繰り返し読み取り

一度に変更する項目は1つにしてください。まずProvider、Base URL、Key、Modelを確認し、その後でコンテキスト長、出力上限、Header、プロキシなどの詳細設定を調整します。

Clineに向いているタスク

Clineは、次のような作業に向いています。

• 未知のモジュールを理解し、関連ファイルを探す
• 再現手順または既存テストがある小さなBugを修正する
• 複数ファイルへ一貫した変更を加える
• lint、build、テストを実行して失敗理由を説明する
• 既存パターンに沿った範囲の明確な機能を実装する
• 明示的なアクセス方針の下でMCPツールを利用する

実務向けのプロンプト例です。

目標：注文一覧にステータス絞り込みを追加する。
変更してよい範囲：注文一覧ページ、直接利用するクエリパラメーター、関連テストのみ。
行わないこと：注文モジュール全体のリファクタリング、依存関係の更新、決済ロジックの変更。
完了条件：ユーザーがステータスを選択して正しい結果を確認でき、ページ更新後も絞り込み条件が保持される。
検証：注文一覧に関係するテストを実行し、成功したら停止する。

1行の質問だけなら、Clineは過剰な場合があります。また、分離や権限ポリシーなしで機密性の高いリポジトリへ無制限のアクセスを与えるべきではありません。固定された反復処理や無人実行には、VS Codeを開き続けるよりCLIまたはCI連携が適していることがあります。

よくある質問

Cline AIとは何ですか？

Clineは、エディターとターミナルで動作するオープンソースのAIコーディングエージェントです。コードの読み取り、ファイル編集、コマンド実行、ブラウザー、MCPを利用できます。外部のモデルAPIが推論と生成を担当し、Clineの権限機構がツール利用をユーザー管理下に置きます。

ClineAI、Cline agent、Clineは同じものですか？

検索では、これらは通常同じコーディングエージェントを指します。公式な製品名はClineです。

ClineはVS Codeで使えますか？

はい。公式拡張機能はVS Codeのサイドバーで動作し、会話、diff、タスク状態、承認リクエストを表示します。

自分のAPIをClineへ接続するにはどうしますか？

Clineの設定で適切なProviderを選びます。BetterTokenの場合はOpenAI Compatibleを選択し、https://www.bettertoken.ai/v1、自分のAPI Key、現在の正確なModel IDを入力して保存し、拡張機能を再読み込みします。

Clineのサブスクリプションは必須ですか？

必須ではありません。Clineは独自の課金方法と外部API Keyを含む複数のモデルアクセス方式に対応しています。アカウント、地域、必要なモデル、予算に合わせて選びます。

ClineとMCPの違いは何ですか？

Clineはタスクを実行するエージェント、モデルAPIは知能、MCPは外部ツールとデータを追加する仕組みです。役割が異なり、互いを補完します。

Clineは安全ですか？

安全性は、権限、プロンプト、モデル、MCPサーバー、実行環境に左右されます。最小権限、コマンド確認、Git、シークレット分離、YOLO Modeを初期状態で無効にすることで、リスクを大きく下げられます。

まとめ

Clineは、VS Code内の単なるチャットではありません。プロジェクトのコンテキスト、ファイル変更、ターミナルコマンド、確認可能なdiffを1つのエージェントワークフローにまとめます。正しい始め方は、公式拡張機能をインストールし、モデルAPIを1つ設定し、読み取り専用テストを通してから、編集、コマンド、ブラウザー、MCPの権限を必要に応じて段階的に広げることです。

BetterTokenでは、OpenAI Compatible、Base URL https://www.bettertoken.ai/v1、自分のAPI Key、現在有効なModel IDを使用します。小さく具体的なタスクから始め、権限を追加するたびに本当に必要かを判断してください。

参考資料：

• Cline公式概要
• Cline公式インストール手順
• ClineのOpenAI Compatible設定
• BetterTokenのCline設定ガイド
• BetterTokenアカウントを作成