無料入門ガイド

Cline入門:VS Codeで自律AIに開発を任せる

·16 min read·Nexeed Lab
ClineVS CodeAIエージェント入門

オープンソースのVS Code拡張Clineで、Plan/Actモードを使い分けてAIに自律的にコーディングを任せる手順を初心者向けに解説します。

「コード補完だけじゃ物足りない」「もっとAIに丸ごと任せてみたい」と感じたことはありませんか。 GitHub CopilotやCursorのインライン補完は便利ですが、複数ファイルにまたがる変更や、ターミナル操作までは自分でやる必要があります。 そんなときに試したいのが、オープンソースのVS Code拡張Cline です。 ClineはAIに目的を伝えるだけで、ファイル編集・ターミナルコマンドの実行までを自律的にこなしてくれるエージェント型のツールです。 本記事ではClineの基本概念から、インストール・APIキー設定・Plan/Actモードの使い分け・最初に試すべき小タスクまでを、初心者向けに丁寧に解説します。

Clineとは:補完ではなく「自律実行」するAIエージェント

Clineは、VS Code上で動くオープンソースのAIコーディングエージェントです。 GitHub上で開発されており、誰でも無料でインストールできます。 最大の特徴は、いわゆる「コード補完」ではなく「タスク自律実行」に振り切っている点です。

たとえば「このNext.jsプロジェクトに認証ページを追加して」と指示すると、Clineは次のような一連の作業を自分で計画して進めます。 プロジェクト構造を読むためにファイルを開き、必要な依存関係を確認します。 新しいページコンポーネントを作成し、ルーティング設定を更新します。 必要であればnpm installのようなコマンドをターミナルから実行します。 最後にビルドや型チェックを走らせて、エラーがあれば自分で修正に挑みます。

ポイントは、これらの操作が「ユーザーの承認を挟みながら」進む点です。 AIが暴走してファイルを壊したり、危険なコマンドを勝手に叩いたりしないように、デフォルトではすべての操作にあなたの承認が必要な作りになっています。 だからこそ、初心者でも安心して試せるツールに仕上がっています。

インストール手順:VS Code Marketplaceから入れる

ClineはVS Code Marketplaceから検索してインストールするのが最も簡単です。 以下の手順で進めてください。

  1. VS Codeを開き、左側のサイドバーから拡張機能ビュー(四角いブロックのアイコン)を開く
  2. 検索欄に「Cline」と入力する
  3. 開発元が「Cline」または「saoudrizwan」となっている拡張をインストールする
  4. インストール後、サイドバーにロボットのようなClineアイコンが追加されるのでクリックする

初回起動時には、APIプロバイダの選択画面が表示されます。 ここでAnthropic、OpenAI、OpenRouter、ローカルLLM(OllamaやLM Studio等)といった選択肢から、使いたい言語モデルの提供元を選びます。 最初の動作確認だけなら、無料枠のあるOpenRouterや自前のローカルLLMでも構いません。 本格運用するなら、Claudeシリーズが扱えるAnthropic API またはOpenRouter 経由が定番の選択肢です。

設定画面はVS Codeの設定にも反映されます。 settings.jsonをエディタで開いた場合、Cline関連のキーは次のような形で確認できます。

{
  "cline.apiProvider": "anthropic",
  "cline.anthropicModelId": "claude-sonnet-4-6",
  "cline.maxRequestsPerTask": 20,
  "cline.alwaysAllowReadOnlyOperations": true,
  "cline.customInstructions": "コミットメッセージは日本語で、テスト失敗時は必ず詳細を報告すること。"
}

alwaysAllowReadOnlyOperationstrueにすると、ファイル読み取りなど安全な操作はワンクリック承認をスキップでき、体感速度がかなり上がります。 逆に書き込みやコマンド実行については、最初のうちは必ず一件ずつ承認することをおすすめします。 慣れるまでは、自動承認の範囲を欲張らないのが安全です。

APIキーの取得とコスト感の掴み方

Clineの動作には外部の大規模言語モデルが必要なので、APIキーの取得が初回設定のキモになります。 ここでは代表的な2パターンを紹介します。

Anthropic APIを使う場合

Anthropic APIを直接使う構成は、Claudeシリーズの最新モデルをそのまま叩けるシンプルな選択肢です。 公式コンソールにサインアップしてAPIキーを発行し、Clineの設定画面に貼り付けるだけで使い始められます。 Claudeのコーディング性能は業界でも高く評価されており、品質を重視するなら第一候補になります。 請求の細かな単価やレートリミットは公式ドキュメントを確認しながら設定するのが確実です。

OpenRouterを使う場合

OpenRouterは、複数のLLMを1本のAPIキーでまとめて切り替えられるルーターサービスです。 ClaudeとGPT、さらに各種オープンソースモデルを横断的に試したい場合は、こちらが便利です。 モデルごとの料金単価がダッシュボード上で横並びに見えるので、コスト感も掴みやすいです。

コストの目安としては、1回の指示でファイルを数本書き換える程度なら、入力+出力で数万トークンを消費するケースが一般的です。 安価なモデルを選べば、1タスクあたり数十円程度のコストに収まるシーンが多いでしょう。 逆に最上位モデルでファイル数十本を一気に書き換えると、1タスクで数百円〜数千円かかることもあります。 未経験者がいきなり高価なモデルを長時間回すと、思わぬ額面の請求が来ることがあります。 最初は必ず月額の上限(Spending Limit)を低めに設定し、コストを確認しながら徐々に上げていくのが安全です。

Plan / Actモードの使い分け

Clineの操作画面では、入力欄の近くにPlanAct という2つのモードを切り替えるトグルがあります。 この2モードを正しく使い分けると、AIを暴走させずに大きなタスクを任せられるようになります。

Plan は、AIが「これから何をやるか」だけを考えて、人間にレビューしてもらうモードです。 ファイル変更やコマンド実行は一切行わず、計画と質問だけを返してきます。 たとえば「リファクタリングしたい」とだけ伝えると、対象ファイルを読み込んだ上で「どの関数を分割する案がいいか」「テストはどう書くか」などを提示してくれます。

Act は、計画に基づいて実際にファイルを編集したりコマンドを実行したりするモードです。 通常はPlanで方向性を固めてからActに切り替え、AIに作業を進めてもらいます。

実際の流れはおおよそ次のようなイメージです。

  1. Plan モードで「やりたいこと」を自然言語で伝える
  2. AIから返ってきた計画・質問を確認し、不足があれば追加情報を渡す
  3. 合意できたらAct モードに切り替えて実行を開始
  4. ファイル差分・コマンド出力をAIが一件ずつ提示するので、承認・却下を判断する
  5. 期待と違う変更が出たら、その場で自然言語で修正方針を伝える

承認フローでは、差分がdiff形式で表示され、何が変わるかを把握しやすくなっています。 危険なコマンド(例:rm -rfに近いもの)が含まれる場合は警告色で表示されるので、迷ったら一旦却下して内容を読み直すのが安全です。

承認操作の例として、ターミナル実行時には次のようなコマンドが提示されます。

# Clineが実行しようとするコマンド例
npm install zod
npm run lint
npm test -- --watchAll=false
git add src/lib/validation.ts
git commit -m "feat: add zod-based input validation"

このとき「実行を許可」「このプロジェクトでは常に許可」「却下」を選べます。 プロジェクト固有でよく走らせるコマンドは常時許可にしておくと、テストやLintのループが一気にスムーズになります。 ただしrm系やgit push系は常時許可にせず、毎回手で承認する運用を強くおすすめします。

GitHub CopilotやCursorとの違い

ここまで読んで「GitHub CopilotやCursorと何が違うの」と感じる方も多いはずです。 ざっくり言うと、Clineは自律実行、Copilotは補完中心、Cursorは対話編集中心という棲み分けです。

  • GitHub Copilot:エディタでコードを書いている間に補完候補をリアルタイム提示。短い関数の中で力を発揮
  • Cursor:チャット欄からファイルを横断的に編集できる対話型エディタ。AIと会話しながら段階的に直していく用途に強い
  • Cline:目的だけ伝えれば計画・編集・コマンド実行までエージェントが進める。長めのタスクをまるごと任せたい時に便利

実務的には、これらは競合というより併用前提のツールです。 細かい関数はCopilot、ファイル横断のリファクタリングはCursor、雑多な一連の作業はClineに、というように使い分けるとそれぞれの強みを引き出せます。 複数のAIエディタを横断する場合は、コミット粒度を細かく保ち、いつでも戻れるようにしておくのが現実的な運用のコツです。

最初に試すべき小タスク例

Clineに慣れる最短ルートは、いきなり大きな機能開発に投げず、小さな一筆書きタスクから始めることです。 初日に試してほしいタスクの例を挙げます。

  • READMEの自動生成(package.jsonを読み、スクリプト一覧・ライセンスを反映した雛形を作る)
  • ESLint+Prettierの初期セットアップ(.eslintrc.prettierrcを作り、package.jsonにlintスクリプトを追加)
  • 既存ユーティリティ関数にJSDocコメントとユニットテストを一括追加
  • 簡単なAPIルートの追加(Next.jsプロジェクトに/api/healthエンドポイントを追加して動作確認)
  • 古いnpmパッケージを最新化し、breaking changeに合わせてコードを修正

どれも数分〜十数分で完了し、Clineの「計画→実行→確認」サイクルを体感するのに最適です。 慣れてきたら、複数ファイルにまたがる機能追加や、テスト追加→リファクタ→PR作成までを一気通貫で任せてみるのがおすすめです。

まとめ:補完の先にある「お任せ開発」を体験しよう

Clineは、AIコーディングの世界を「補完」から「自律実行」へ一段進めてくれるツールです。 オープンソースかつVS Code拡張という気軽さで、自分のAPIキーを使って手元から試せるのが大きな魅力と言えるでしょう。

導入の手順をおさらいすると、次の流れになります。 まずVS Code Marketplaceから拡張をインストールし、AnthropicまたはOpenRouterのAPIキーを設定します。 小さなタスクをPlanモードで計画させ、レビュー後にActモードへ切り替えて承認しながら進めます。 慣れてきたら常時許可設定をうまく活用して操作速度を上げ、Copilot/Cursorと役割を分担して使い分けます。

次のアクションとして、まずは普段の開発環境のVS CodeにClineをインストールし、READMEの自動生成のような小さな一筆タスクで「AIに任せる感覚」を体感してみてください。 公式リポジトリにはサンプルプロンプトやベストプラクティスも公開されているので、合わせて目を通すと立ち上がりがさらにスムーズになります。 うまく使いこなせれば、開発時間そのものを別の創造的な作業に振り向ける余裕が生まれます。

参考資料

この記事をシェア

XFacebookはてブ
Cline入門:VS Codeで自律AIに開発を任せる | AI活用ラボ