確認日:2026年9月24日。Cline の公式サイト(cline.bot)、公式ドキュメント(docs.cline.bot)、GitHub(cline/cline)、VS Code Marketplace で確認しました。VS Code 拡張機能の最新版は v4.1.20(2026年9月22日公開)です。この記事は、2025年2月に公開した「AIエージェント「Cline」完全ガイド」を、最新の情報で全面的に書き直したものです。
はじめに:この記事で分かること
Cline は、VS Code などのエディタの中で動く AI コーディングエージェントです。「エージェント」とは、頼まれた作業を AI が自分で手順を考えながら進める仕組みのことです。Cline はファイルを読み、コードを書き換え、ターミナルでコマンドを実行するところまで進めてくれます。
2025年に旧記事を書いてから、Cline は大きく変わりました。ターミナル版(CLI)やデスクトップアプリが加わり、料金の選択肢も増えています。この記事では、これから Cline を使う方に向けて、2026年9月時点の Cline を次の順番で説明します。
- Cline とは何か、2025年からの主な変化
- AI モデルのつなぎ方と料金の考え方
- インストールと初期設定
- 基本の使い方(Plan モードと Act モード)
- 安全に使うための承認設定とチェックポイント
- ルール機能・MCP・スキルで使いやすくする方法
- Claude Code・Cursor との違い
Cline とは
Cline は、Cline Bot 社が中心になって開発している オープンソース(ソースコードが公開されていて、誰でも中身を確認できるソフト)の AI コーディングエージェントです。ライセンスは Apache 2.0 で、GitHub の cline/cline で開発が進められています。
公式ドキュメントでは「エディタとターミナルの中にいる AI コーディングエージェント」と説明され、すべての操作に利用者の承認が必要な点が強調されています。AI が勝手にファイルを書き換えるのではなく、変更内容を見せてから「承認」ボタンを待つのが基本の動き方です。
使える場所
| 使う場所 | 特徴 |
|---|---|
| VS Code 拡張機能 | いちばん基本の使い方。Cursor・Windsurf・VSCodium・Antigravity にも入れられる |
| JetBrains プラグイン | IntelliJ IDEA・PyCharm・WebStorm などで使える |
| CLI(ターミナル版) | ターミナルで対話したり、スクリプトや CI(自動テストなどの仕組み)に組み込んだりできる |
| Cline Desktop | エディタなしで使うデスクトップアプリ(macOS・Windows、ベータ版) |
| Kanban | タスクボードの画面で、複数のエージェントを並行して動かす(プレビュー版) |
| SDK | Cline の中核部分を自分のアプリに組み込むための部品(開発者向け) |
ほかに、ACP という共通の接続方式を通じて Zed や Neovim などのエディタからも使えます。VS Code Marketplace での拡張機能のインストール数は、2026年9月24日時点で約543万件です。
2025年からの主な変化
| 項目 | 2025年の旧記事 | 2026年9月時点 |
|---|---|---|
| 使える場所 | VS Code の拡張機能のみ | JetBrains・CLI・デスクトップアプリ・SDK にも広がった |
| モデルのつなぎ方 | 自分で API キーを取得して設定 | Cline アカウントでログインするだけの方法や、月額制の ClinePass が加わった |
| ルール | .clinerules ファイル | .clinerules/ フォルダに複数の Markdown ファイルを置く形。AGENTS.md なども読み込める |
| 拡張機能 | MCP に対応 | MCP に加えて、スキル・プラグイン・フックに対応。「Customize」画面からまとめて探して入れられる |
| 中身の仕組み | 拡張機能ごとの独自実装 | v4.0(2026年6月)から、CLI などと共通の SDK の上で動くように作り直された |
旧記事では settings.json に cline.apiProvider などを書く設定例を紹介していましたが、これは公式の手順ではありません。現在は、Cline のパネルにある設定画面からプロバイダーとモデルを選びます(次の章で説明します)。また、旧記事の「開発時間が87.5%短縮」といった数値は根拠が確認できないため、この記事では取り上げません。
AI モデルのつなぎ方と料金の考え方
Cline 自体は無料で使えます。ただし、Cline は「頭脳」にあたる AI モデルを自分では持っていません。外部の AI モデルにつないで動くため、料金は主に「使ったモデルの利用料」として発生します。この「どこのモデルにつなぐか」を、Cline では プロバイダーと呼びます。
公式ドキュメントでは、モデルのつなぎ方として次の3つが案内されています。
| つなぎ方 | 仕組み | 料金(2026年9月24日時点) | 向いている人 |
|---|---|---|---|
| Cline(usage-billing) | Cline アカウントでログインし、クレジットを買って使う | 使った分だけ(従量課金)。一部に無料のモデルもある | API キーの管理をしたくない人 |
| ClinePass | Cline のオープンなモデル向けの月額プラン | 月9.99ドル | GLM・Kimi・DeepSeek などを安く多く使いたい人 |
| BYOK(自分のキーを使う) | Anthropic・OpenAI・Google などの API キーを自分で取得して設定 | 各社の API 料金(使った分だけ) | すでに各社のアカウントを持っている人 |
1. Cline(usage-billing):ログインだけで始める
Google・GitHub・メールアドレスで Cline にログインし、Cline のダッシュボードでクレジットを追加して使う方法です。公式ドキュメントでは、100以上のモデルを1つの残高で使えると説明されています。モデル一覧で FREE と表示されたモデルは、期間限定・上限ありで無料で試せます(無料の利用分はモデルの改善に使われることがある、と注意書きがあります)。
2. ClinePass:オープンなモデル向けの月額プラン
ClinePass は 月9.99ドルの定額プランです。公式の説明では、GLM・Kimi・DeepSeek・MiMo・MiniMax・Qwen などの、重みが公開されている(オープンウェイトの)コーディング向けモデルを、通常の API 料金で使う場合と比べて 2〜5倍の量使えます。利用量は「5時間」「週」「月」の3つの枠で管理されます。Claude や GPT のモデルは含まれない点に注意してください。詳しくは ClinePass の公式ページ で確認できます。
3. BYOK:自分の API キーを使う
BYOK は「Bring Your Own Key」の略で、自分で取得した API キー(サービスを使うための合言葉のような文字列)を Cline に設定する方法です。対応しているプロバイダーは、Anthropic・OpenAI・Google Gemini・OpenRouter・AWS Bedrock・DeepSeek などの主要なものに加え、公式ドキュメントに30以上の一覧があります。料金は 各社の API 料金で発生し、Cline には支払いません。
次のような、サブスクリプションを使う方法も用意されています。
- Claude Code:手元に Claude Code(CLI)を入れて Claude の Pro・Max プランでログインしておくと、プロバイダーに「Claude Code」を選んでその枠で使えます。公式ドキュメントでは、応答が少しずつ表示されない、画像の送信などに制限がある、と注意書きがあります。
- OpenAI Codex:「Sign in with OpenAI」で ChatGPT のアカウントでログインし、そのプランの範囲でモデルを使えます。
- ローカルモデル:Ollama や LM Studio で自分のパソコンの中でモデルを動かせば、1回ごとの料金はかかりません。ただし、公式ドキュメントでは小さなモデルでもメモリ 16〜32GB が目安とされています。
料金について知っておきたいこと
- エージェントは1つの作業の中で何度もモデルを呼び出し、ファイルの中身も読み込むため、チャットで質問するよりトークン(AI が文章を数える単位)を多く使います。
- 使うモデルによって単価が大きく変わります。最新の料金は各社の公式料金ページで確認してください。
- 会話が長くなるほど、1回ごとに読み込む量が増えます。区切りのよいところで新しいタスクにしましょう(後の章で説明します)。
会社で使う場合:Enterprise プラン
Cline 自体の有料プランとしては、会社向けの Enterprise があります。公式の料金ページでは、JetBrains 拡張機能、SSO(会社のアカウントでの一括ログイン)、権限管理、請求の一元化などが含まれると書かれており、料金は個別見積もりです。個人で使う場合は、無料の「Open Source」の範囲で VS Code 拡張機能と CLI を使えます。
インストールと初期設定
VS Code に入れる
- VS Code を開き、Ctrl+Shift+X(Mac は Cmd+Shift+X)で拡張機能の画面を開きます。
- 検索欄に「Cline」と入力します。
- 発行元が「Cline」の拡張機能を選び、Install をクリックします。
- 左側のアクティビティバーに出る Cline のアイコンをクリックして、パネルを開きます。
Marketplace のページは こちら です。拡張機能の ID が saoudrizwan.claude-dev になっているのは、Cline がもともと「Claude Dev」という名前だった名残です。Cursor・Windsurf・VSCodium でも同じ手順で入れられます(Windsurf と VSCodium は Open VSX という別の配布所から入ります)。
Cline のパネルは最初、左側のファイル一覧と同じ場所に開きます。公式ドキュメントでは、アイコンを右側のサイドバーにドラッグして移し、ファイル一覧を見ながら使う方法がすすめられています。
プロバイダーとモデルを選ぶ
- Cline のパネルの右上にある歯車アイコンで設定を開きます。
- API Provider の一覧から、使うプロバイダーを選びます。
- Cline や ClinePass なら Sign In を押してログインします。自分のキーを使う場合は、API Key の欄に貼り付けます。
- Model の一覧から、使うモデルを選びます。
API キーは、他人に知られると勝手に使われて料金が発生します。チャットの本文やプロジェクトのファイルに貼り付けないようにしましょう。
ターミナルで使う(CLI)
CLI 版を使う場合は、Node.js 20 以上(22 を推奨)を入れてから、次のコマンドを実行します。
npm install -g cline
cline auth
cline
cline auth でプロバイダーを設定し、cline で対話を始めます。cline "やりたいこと" のように、最初の依頼を付けて起動することもできます。
CLI の注意:公式の CLI リファレンスでは、
--auto-approveの既定値はtrue(すべてのツールを自動承認)で、依頼を付けて起動すると Act モードで始まると書かれています。慣れるまでは、Plan モードで始める-pと、自動承認を切る--auto-approve falseを付けると安心です。
cline -p --auto-approve false "このプロジェクトの構成を説明して"
基本の使い方:Plan モードと Act モード
Cline の使い方でいちばん大事なのが、Plan(計画)と Act(実行)の2つのモードです。パネルの下にある「Plan」「Act」の切り替えボタンで選びます。
- Plan:コードを読んで調べ、方針を相談します。ファイルの変更やコマンドの実行はしません。初めて触るプロジェクトや、原因が分からない不具合、影響が広い変更に向いています。
- Act:計画に沿ってファイルを書き換え、コマンドを実行します。方針が決まった作業や、小さな修正に向いています。
Plan で話した内容は、Act に切り替えても引き継がれます。同じ説明を繰り返す必要はありません。公式ドキュメントでは、中くらいの作業は「Plan → Act」の順で進めることがすすめられています。
最初の作業を頼んでみる
- VS Code で、空のフォルダを開きます(フォルダを開かないと、Cline はファイルを作る場所が分かりません)。
- Cline のパネルで Plan を選び、やりたいことを入力します。
- Cline が示す方針を読み、気になる点を質問したり、直してほしい点を伝えたりします。
- 納得したら Act に切り替えます。
- ファイルの変更が提案されるので、内容を確認して Approve(承認)を押します。
たとえば、次のように頼みます。
1つのHTMLファイルで動くToDoアプリを作って。
- タスクを追加する入力欄
- 完了にするチェックボックス(完了したら取り消し線)
- タスクを削除するボタン
- CSSとJavaScriptは同じファイルに書く
まず作り方の方針を説明して
便利なコマンド
チャット欄で / を入力すると、次のようなコマンドを使えます。
/deep-planning:コードを詳しく調べ、質問してから、実装計画のファイルを作ります。大きな作業向けです。/newtask:ここまでの要点をまとめて、新しいタスクとして始め直します。/smol(/compactでも同じ):これまでの会話を要約して、容量を空けます。/newrule:対話しながらルールのファイルを作ります。
ファイル名の前に @ を付けると、そのファイルを指定して話ができます。会話が長くなると精度が落ち、使用量も増えます。/newtask や /smol を使う理由は コーディングエージェントのコンテキスト管理入門 で詳しく解説しています。
Plan モードと Act モードで、別々のモデルを使う設定もできます(設定の「Use different models for Plan and Act」)。計画は考える力が強いモデル、実装は速くて安いモデル、と分けると料金を抑えられます。
安全に使うための承認設定とチェックポイント
Cline は、ファイルの読み書きやコマンドの実行のたびに承認を求めます。毎回押すのが面倒な操作は、Auto Approve(自動承認)で、種類ごとに承認なしで進めるよう設定できます。
| 設定 | 許可される操作 |
|---|---|
| Read project files | プロジェクト内のファイルを読む・探す |
| Read all files | プロジェクトの外のファイルも読む |
| Edit project files | プロジェクト内のファイルを作る・書き換える |
| Edit all files | プロジェクトの外のファイルも書き換える |
| Execute safe commands | 安全と判断されたコマンドを実行する |
| Execute all commands | 承認が必要と判断されたコマンドも実行する |
| Use the browser | ブラウザで Web ページを取得・検索する |
| Use MCP servers | MCP サーバーのツールを使う |
公式ドキュメントのおすすめは、最初は「Read project files」だけをオンにして、ほかはオフのままにすることです。VS Code 拡張機能では、v4.0 からコマンドの自動承認が最初からオフになっています(CLI は既定で自動承認がオンなので、前の章の注意を参照してください)。
注意したい点が2つあります。
- 「安全なコマンド」かどうかは、決まった一覧ではなく AI モデルがその都度判断しています。
npm testなどは安全、rm -rf(削除)やnpm installなどは承認が必要と判断されることが多い、という目安にとどまります。 - 「Use MCP servers」をオンにすると、すべての MCP ツールが自動承認されます(v4.1.15 以降。ツールごとの設定は廃止されました)。
YOLO モードは使い捨ての環境だけで
設定の Features にある YOLO Mode をオンにすると、ファイル操作・コマンド・ブラウザ・MCP・Plan から Act への切り替えまで、すべてを承認なしで進めます。公式ドキュメントでも「危険」と明記され、大事なファイルの削除や Git への push まで起こりうると説明されています。試すなら、捨ててもよいプロジェクトや隔離した環境だけにしましょう。
チェックポイントで巻き戻す
Cline は、ファイルを変えたりコマンドを実行したりするたびに、プロジェクトの状態を チェックポイントとして保存します(最初からオン)。自分の Git の履歴とは別の場所に保存されるので、履歴は汚れません。
会話の中に出るチェックポイントの Compare で差分を確認し、Restore で戻せます。戻し方は3種類あります。
- Restore Files:ファイルだけその時点に戻す(会話は残す)
- Restore Task Only:会話だけその時点に戻す(ファイルはそのまま)
- Restore Files & Task:ファイルも会話もその時点に戻す
チェックポイントがあっても、大事な変更の前には Git でコミットしておくのが安心です。v4.1.17 からは、チェックポイントより後に Git のコミットがある場合、ファイルの復元は実行されないようになりました。
.clineignore は近く廃止予定
旧記事のころは、.clineignore で「読ませたくないファイル」を指定する方法がありました。しかし公式は、これは ファイルへのアクセスを防ぐ仕組みではない(コマンド経由で読めてしまう)として、近く廃止すると告知しています。パスワードなどの秘密情報は、そもそも Cline が扱うフォルダに置かないようにしましょう。
ルール機能:毎回伝えたいことを書いておく
「TypeScript で書く」「コメントは日本語」など、毎回伝えたい約束ごとは Rules(ルール)に書いておきます。ルールは Markdown のファイルで、Cline がすべての会話で自動的に読み込みます。
- プロジェクト用:プロジェクトの
.clinerules/フォルダ(または.cline/rules/)。Git で共有すればチーム全員に効きます。 - 自分用(全プロジェクト):
~/Documents/Cline/Rules(Windows はDocuments\Cline\Rules)。 - 他のツール用のルール:
AGENTS.md・.cursorrules・.windsurfrulesも自動で読み込まれます。
パネルの下、モデル選択の左にある天びんのアイコンから、新しいルールを作ったり、ルールごとにオン・オフを切り替えたりできます。たとえば、.clinerules/coding.md に次のように書きます。
# コーディングのルール
- 新しいファイルは TypeScript で書く
- コメントと説明は日本語で書く
- エラー処理は /src/utils/errors.ts のやり方に合わせる
- /legacy フォルダのファイルは変更しない(近く削除する予定のため)
公式ドキュメントでは、「具体的に書く」「理由も書く」「1つのファイルには1つのテーマ」がコツとされています。ルールは毎回読み込まれて容量を使うので、長い説明を貼り付けすぎないようにしましょう。
ファイルの先頭に paths を書くと、特定のファイルを扱うときだけ効く 条件付きルールにもできます。
---
paths:
- "src/components/**"
---
# React コンポーネントのルール
- 関数コンポーネントとフックを使う
MCP とスキルで機能を広げる
MCP:外部のツールやサービスとつなぐ
MCP(Model Context Protocol)は、AI に外部のツールやデータをつなぐための共通の仕組みです。Cline は MCP に対応していて、GitHub・データベース・ブラウザ操作などのツールを追加できます。
VS Code では、パネル上部の MCP Servers アイコンから追加します。マーケットプレイスから選んで入れる方法、URL を入力してリモートのサーバーにつなぐ方法、設定の JSON ファイルに直接書く方法があります。CLI では cline mcp コマンドで設定できます。手元でプログラムを動かす形のサーバーは、次のような形で書きます。
{
"mcpServers": {
"local-server": {
"command": "node",
"args": ["/path/to/server.js"],
"env": {
"API_KEY": "your_api_key"
},
"disabled": false
}
}
}
公式ドキュメントでは、信頼できるサーバーだけを入れること、秘密の値は環境変数に置くことが注意点として挙げられています。MCP の考え方は MCP で Claude に「外の道具」をつなぐ実践ガイド でも解説しています。
スキルとプラグイン
スキルは、決まった作業の手順を SKILL.md というファイルにまとめたものです。ルールと違い、関係する依頼が来たときだけ読み込まれるので、ふだんの容量を使いません。チャット欄で /スキル名 と入力して、明示的に呼び出すこともできます。Claude Code のスキルと同じ考え方なので、Claude Code のスキル入門 も参考になります。
v4.0 からは プラグインも加わりました。独自のツールや手順、MCP をまとめて入れられる拡張パックです。スキル・MCP・プラグインは、拡張機能の「Customize」画面から探して入れたり、オン・オフを切り替えたりできます。
Claude Code・Cursor との違い
同じ「AI にコードの作業を任せる」ツールとして、Anthropic の Claude Code や、AI エディタの Cursor がよく比べられます。
| Cline | Claude Code | Cursor | |
|---|---|---|---|
| 形 | エディタの拡張機能(CLI・アプリもあり) | ターミナルが中心(エディタ拡張・アプリもあり) | AI が組み込まれたエディタ |
| ソースコード | 公開(Apache 2.0) | 非公開 | 非公開 |
| 使えるモデル | 多くの会社のモデルから自由に選べる。ローカルモデルも可 | Claude のモデル | 自社モデル+Claude・GPT など |
| 料金 | Cline 自体は無料。モデルの利用料がかかる(ClinePass は月9.99ドル) | Claude の有料プラン(Pro は月20ドル)か API | 無料の Hobby あり。Pro は月20ドル |
| 向いている人 | 今のエディタのまま、モデルを選んで使いたい人 | Claude で大きな作業をまとめて任せたい人 | エディタごと AI 向けに乗り換えたい人 |
料金は2026年9月24日時点のもので、変わることがあります。Claude Code と Cursor の詳しい内容と最新の料金は、それぞれ Claude Code 徹底入門 と Cursor 入門 で解説しています。
Cline のいちばんの特徴は、モデルを選ぶ自由です。安いオープンなモデル、手元のローカルモデル、Claude や GPT などを、作業に合わせて切り替えられます。一方で、どのモデルを選ぶかで結果の質と料金が大きく変わるため、自分で判断する部分が増えます。
どれか1つに決める必要はありません。Cline は Cursor の中にも入れられますし、プロバイダーに Claude Code を選べば、Claude のサブスクリプションの枠で Cline の画面から使うこともできます。
よくあるつまずき
| 困りごと | 確認すること |
|---|---|
| Cline のアイコンが見つからない | コマンドパレット(Cmd/Ctrl+Shift+P)で「Cline: Open In New Tab」を実行する |
| ファイルが作られない | VS Code でフォルダを開いているか。Plan モードのままになっていないか |
| 「Unauthorized: Please sign in」と出る | ログインの有効期限切れ。Sign In を押してログインし直す |
| 料金が思ったより高い | モデルの単価を確認する。長い会話は /newtask で区切る。Plan と Act で別のモデルを使う |
| ローカルモデルがうまく動かない | Ollama などが起動しているか確認し、設定の Features で「Use Compact Prompt」をオンにする |
まとめ
- Cline は VS Code などで動くオープンソースの AI コーディングエージェントで、操作のたびに承認を求めるのが基本です。
- Cline 自体は無料で、料金は使う AI モデルの側で発生します。つなぎ方は Cline のクレジット、月9.99ドルの ClinePass、自分の API キーの3つが基本です。
- Plan モードで方針を相談してから Act モードで実行すると、やり直しが減ります。
- 自動承認は「Read project files」だけから始め、YOLO モードは使い捨ての環境だけにしましょう。失敗はチェックポイントで戻せます。
- 毎回の約束ごとは
.clinerules/のルールに書き、必要に応じて MCP・スキル・プラグインで機能を足します。

