Cline完全ガイド【2026年6月最新版・v3.88.0】完全自律型AIコーディングエージェントをVSCodeで使い倒す決定版

Cline完全ガイド 2026年6月最新版 v3.88.0 チュートリアル

Clineは、VS CodeやJetBrains、CursorといったIDEに組み込んで使う「完全自律型のAIコーディングエージェント」です。GitHub Copilotのような補完中心のアシスタントとは違い、Clineはタスクを与えると自分でファイルを読み、コードを書き、ターミナルでコマンドを実行し、エラーが出れば自己修正しながら、機能の実装からデプロイまで一気通貫で進めます。本記事の執筆時点(2026年6月時点)の最新版はv3.88.0(2026年6月5日リリース)で、Apache 2.0ライセンスの完全なオープンソース、対応LLMプロバイダーは30種類以上にのぼり、ClaudeやGPT、Geminiといった商用APIから、OllamaやLM Studio経由のローカルLLMまで自由に切り替えられます。

本記事では、Clineをまったく触ったことがない方が、ゼロからインストールして実用的な自律エージェントとして使いこなせるようになるまでを徹底解説します。Windows/macOS/Linuxすべてのインストール手順、Plan/Actモードの使い分け、ローカルLLM(Ollama)との接続、.clinerulesによるプロジェクト規約の設定、MCP(Model Context Protocol)による外部ツール連携、よくあるエラーへの対処まで網羅します。CursorやGitHub Copilotのサブスクリプション料金が気になっている方、自宅PCのローカルLLMで完結する開発環境を作りたい方、自律型エージェントが何をどこまでできるのか見極めたい方に向けた決定版です。

  1. Clineとは何か
    1. 開発元・ライセンス・配布形態
    2. Clineができること
  2. 最新リリース情報(2026年6月時点)
    1. 2026年に入ってからの大きな変化
  3. 他ツールとの比較
    1. 使い分けの指針
  4. メリット・デメリット
    1. メリット
    2. デメリット
  5. 動作要件
    1. IDE拡張本体の要件
    2. CLI版の要件
    3. ローカルLLM利用時の追加要件
  6. インストール手順
    1. Windows(VS Code版・推奨)
    2. macOS(VS Code版)
    3. Linux(Ubuntu / Debian系)
    4. JetBrains IDE(IntelliJ/PyCharm/WebStorm等)
    5. CLI版(macOS/Linux)
    6. Kanbanモード(プレビュー)
  7. 初期設定
    1. パネルを開いてAPIプロバイダーを選ぶ
    2. 商用APIで始める(最速・最も安定)
    3. ローカルLLM(Ollama)で始める
    4. LM Studio経由で始める
  8. 基本的な使い方
    1. Plan/Actモードの違いを理解する
    2. 最初の対話の流れ
    3. 承認とAuto-Approve
  9. 実践的な使い方
    1. ユースケース1:既存コードのバグ修正
    2. ユースケース2:新機能の実装(マルチファイル)
    3. ユースケース3:レガシーコードの理解と整理
  10. 応用・カスタマイズ
    1. .clinerules でプロジェクト固有のルールを定義する
    2. 条件付きルール(YAML frontmatter)
    3. MCP(Model Context Protocol)で外部システム連携
    4. カスタムシステムプロンプト
    5. SDKでアプリケーションに組み込む
  11. パフォーマンス最適化
    1. コンテキスト爆発を防ぐ
    2. .clineignore の例
    3. ローカルLLMの推論速度を上げる
  12. よくあるエラーとトラブルシューティング
    1. 1. 「API request failed」が頻発する
    2. 2. Token countが異常な値を示す
    3. 3. Windowsで「Resume task」ボタンが完了済みタスクに表示される
    4. 4. CLI版でAWS Bedrock認証が失敗する
    5. 5. チェックポイント復元後にスクリーンショットが残る
    6. 6. Ollama接続で「connection refused」
    7. 7. ターミナルコマンドがハングする
  13. おすすめの組み合わせ・連携
    1. Cline + Ollama(完全ローカル運用)
    2. Cline + Claude Sonnet 4.6 + プロンプトキャッシュ
    3. Cline + GitHub MCP
    4. Cline + PostgreSQL MCP
    5. Cline + Continue.dev併用
  14. 推奨PCスペック
    1. 入門:商用API主体での利用
    2. 標準:ローカルLLM併用
    3. 本気運用:完全ローカル自律エージェント
  15. まとめ
  16. 📦 この記事で紹介した商品

Clineとは何か

Clineは、cline/clineリポジトリでCline Bot Inc.が開発・公開している、自律型AIコーディングエージェントです。元々は「Claude Dev」という名前で2024年中盤にリリースされ、その後Clineへとリネーム、現在ではVS Codeマーケットプレイスで500万インストール、GitHubで6.1万スターを超える人気プロジェクトに成長しています。

Clineの本質は、「人間がチャットで指示を出すと、AIが計画を立て、必要なファイルを読み、コードを書き換え、テストを走らせ、エラーがあれば自分で直す」というワンサイクルを、IDE内で完結させる点にあります。GitHub Copilotがコードを書く手元を補助する「ペアプログラマー」だとすれば、Clineは仕事を投げると一人で完成させて持ってくる「自律エージェント」です。

同じくAIコーディングツールとして人気のAiderについてはAider完全ガイドで詳しく解説しています。

開発元・ライセンス・配布形態

  • 開発元:Cline Bot Inc.(米国法人、コミュニティ主導の開発体制)
  • ライセンス:Apache 2.0(商用利用可、改変・再配布可、特許条項あり)
  • 初回リリース:2024年中盤(旧名Claude Dev)
  • 最新版:v3.88.0(2026年6月5日リリース)
  • 配布形態:VS Code拡張、JetBrainsプラグイン、CLIツール、SDK(@cline/sdk)、Kanban(プレビュー)の5系統

Clineができること

  • マルチファイル編集:プロジェクト構造を読んだうえで複数ファイルにまたがる変更を実行。すべての変更はdiff形式で表示され、ユーザーが承認するまでファイルには書き込まれません
  • ターミナル実行:Bash/PowerShell/zshのコマンドをリアルタイム出力監視で実行。npm installpytestdocker buildなどの実行と結果のフィードバックを自動化
  • ブラウザ操作:ローカル開発サーバーをChromeで開いて挙動を確認し、スクリーンショットを撮ってビジュアル回帰を検知
  • Plan/Actモード:実行前に計画を立てるPlanモードと、実際にコードを書き換えるActモードを明示的に切り替え可能
  • MCP(Model Context Protocol)対応:GitHub、Linear、Notion、PostgreSQL、Slackなどの外部システムを、エージェントが直接操作できるツールとして接続
  • 30以上のLLMプロバイダー対応:Anthropic、OpenAI、Google Gemini、AWS Bedrock、Azure、Vertex、OpenRouter、Ollama、LM Studio、OpenAI互換エンドポイントなどを切り替え可能
  • チェックポイント機能:エージェントが何かを書き換えるたびにGit内部スナップショットを取り、任意のタイミングに戻せる

最新リリース情報(2026年6月時点)

Clineは月単位どころか週単位でリリースが続いている活発なプロジェクトです。直近1ヶ月の主要アップデートを時系列で整理します。最新の公式リリースノートもあわせて確認してください。

バージョン リリース日 主な変更内容
v3.88.0 2026-06-05 Fireworks AI最新モデル追加、MCP設定パネルのバグ修正、モデルメタデータ更新
v3.87.0 2026-06-03 MiniMax M3モデルサポート追加、依存パッケージのセキュリティ更新(複数CVE対応)
v3.86.2 2026-06-01 VS Code 1.122以降のAPI変更に対応したファイルメンション機能修正
v3.86.1 2026-06-01 Remote SSH/Devcontainer環境でのファイル検索互換性向上
CLI v3.0.17 2026-06-04 セッション管理リグレッション修正、Telegram認証オプション追加
CLI v3.0.16 2026-06-03 公式プラグイン管理機能、Slackソケットモード対応
CLI v3.0.15 2026-05-29 Cline Hubウェブアプリ追加、Discord統合改善、モデルカタログ刷新

2026年に入ってからの大きな変化

  • 対応IDEの大幅拡大:従来のVS Code中心から、JetBrains、Cursor、Windsurf(現Devin Desktop)、Zed、Neovim、VSCodiumへと展開。同じClineアカウントで複数IDEを横断利用可能に
  • CLIプレビューの公開:macOS/Linux向けのCLI(コマンドライン版)が正式リリースされ、Server内CI/CDからの呼び出しやリモート開発が現実的に
  • Kanbanモードの追加:複数の自律エージェントをカンバンボード上で並列管理できるプレビュー機能が登場(Node.js 18以上でnpx kanban
  • SDKの正式公開@cline/sdkとして独自アプリケーションへ自律エージェントを組み込める
  • MCPマーケットプレイス:Cline内蔵のMCPサーバーカタログから、データベース、Slack、Notion等のMCPサーバーをワンクリック導入可能に

他ツールとの比較

Clineと比較されることが多い主要な競合・代替ツールを整理します。各ツールの最新バージョンは2026年6月時点で実際に確認した値です(記憶に頼らず、各公式リリースページで都度確認しています)。

項目 Cline v3.88.0 Cursor (Composer 2.5) GitHub Copilot Roo Code v3.54.0 Continue.dev v1.3.38 Aider v0.86.0
形態 IDE拡張+CLI+SDK 独自IDE(VS Codeフォーク) IDE拡張 IDE拡張 IDE拡張 CLIツール
ライセンス Apache 2.0(OSS) 商用クローズド 商用クローズド Apache 2.0(OSS、リポジトリはアーカイブ) Apache 2.0(OSS) Apache 2.0(OSS)
自律エージェント性 非常に高い(計画+実行+自己修正) 高い(Composer 2.5で長期タスク対応) 中程度(Agentモード追加) 非常に高い(Clineフォーク) 標準(Agentモード提供) 高い(CLIで完結)
料金 無料(API代のみ実費) 月20ドル~ 月10ドル~100ドル(Copilot Max) 無料 無料 無料(API代のみ実費)
対応LLMプロバイダー 30以上 主要モデル(Anthropic、OpenAI、Google等) 主にOpenAI、Anthropic、Gemini 30以上(Cline準拠) 20以上 主要モデル+ローカル
ローカルLLM対応 Ollama/LM Studio/互換API サポートあり(β) 限定的 Cline準拠 Ollama/LM Studio/TabbyAPI等 Ollama/llama-cpp対応
MCP対応 マーケットプレイス含め完全対応 対応 限定対応 Cline準拠 対応 非対応
変更承認 diff表示+手動承認 diff表示+手動承認 diff表示+手動承認 diff表示+手動承認 diff表示+手動承認 diff表示+手動承認
VSCode統合 サイドバー型ネイティブ 独自IDEに置換 サイドバー型ネイティブ サイドバー型 サイドバー型 外部CLI連携
CLI版 あり(v3.0.17) なし GitHub CLI拡張 あり(v0.1.17) あり(実験的) 本体がCLI
開発活発度 週単位の更新 月単位の更新 月単位の更新 2026-05でリポジトリアーカイブ(事実上停止) 定期更新 月単位の更新

使い分けの指針

  • Cline:自宅PCのローカルLLMで自律エージェントを動かしたい、IDEはVS Codeのまま使いたい、Apache 2.0で透明性が欲しい、というケースの第一候補
  • Cursor:商用APIに月20ドル程度を出すなら最も統合度が高く、IDE自体の補完速度も最速。ただしVS Codeのフォークなのでビルド済み拡張の動作差が稀に発生
  • GitHub Copilot:会社支給アカウントですでに導入されているなら追加コストゼロ。エンタープライズ統制が必要な現場はこれ一択
  • Roo Code(旧Roo Cline):Clineのフォークだったが、2026年5月15日にリポジトリがアーカイブされ事実上の開発停止。新規導入は非推奨
  • Continue.dev:Clineより前から続くオープンソース系。エージェント性能はClineに及ばないが、補完/チャット中心の用途では軽快
  • Aider:完全CLIで完結したい、Git連携を最重視したい場合の選択肢。エディタ統合は弱い

メリット・デメリット

メリット

  • 完全オープンソース(Apache 2.0):ソースコードを読めば「自分のコードがどのプロバイダーにどう送られているか」を完全に確認できる。情報漏洩リスクの管理が容易
  • vendor lock-in がない:30以上のLLMプロバイダーに対応するため、ClaudeのAPI料金が上がれば即GPTやGeminiに切り替えられる。ローカルLLMにも逃げられる
  • 本体料金が無料:Cursorの月20ドル、Copilotの月10~100ドルといったサブスクが不要。Anthropic/OpenAI/GoogleなどのAPI実費のみで運用可能
  • ローカルLLM完全対応:OllamaやLM Studio経由でLlama 3/Qwen3/DeepSeek/Codestralを使えば、API料金ゼロで完結可能
  • 強力な自律性:「ログイン機能を作って」「このバグを直して」レベルの指示で、複数ファイルの編集とテスト実行まで自走
  • diff必須承認:エージェントが暴走しても、すべての変更はユーザーの承認が必要なため、想定外の書き換えで本番が壊れる事故が起きにくい
  • チェックポイント機能:エージェントの介入前のスナップショットに即座に戻せる。Gitとは独立した安全網
  • MCPで外部システム連携:データベース、Slack、Linear、Notionといった外部システムを、エージェントが直接読み書きできる

デメリット

  • 商用API利用時のコスト管理が必須:Claude Sonnet 4.6(入力3ドル/出力15ドル/100万トークン)クラスを連発すると、月数十ドル~百ドル単位で消費する。アクティブな開発者は月100ドル超も普通
  • ローカルLLMだとモデル品質が落ちる:7B~14Bクラスのローカルモデルでは、Claude Sonnetの完成度は出ない。13B以下では明確に劣る
  • 暴走時のレスポンス消費:エージェントがループに入った場合のトークン浪費は、Plan/Actモードの切替を意識しないと痛い
  • VRAM要求:ローカルLLMで実用品質を出すなら24GB以上のVRAMが現実的(RTX 4090/5090クラス)
  • セットアップ時の選択肢の多さ:プロバイダー、モデル、コンテキスト長などの選択肢が多すぎて初心者は迷う
  • ブラウザ操作機能のクセ:ChromeDevToolsプロトコル経由のため、起動権限まわりでハマることがある

動作要件

Cline本体の動作要件は軽量です。ただし、利用するLLMによって必要スペックが大きく変わります。

IDE拡張本体の要件

項目 最小 推奨
OS Windows 10 22H2 / macOS 12 / Ubuntu 20.04 Windows 11 23H2以降 / macOS 14以降 / Ubuntu 24.04
VS Code 1.84以降 1.122以降(最新版機能対応)
JetBrains IDE 2024.2以降 2025.1以降
RAM 8GB 16GB
ストレージ 1GB 5GB(チェックポイント用)
ネットワーク 常時接続必須(クラウドLLM利用時) 有線推奨

CLI版の要件

項目 要件
OS macOS 13以降/Ubuntu 22.04以降(Windowsは2026年6月時点でプレビュー扱い)
Node.js 20以上(推奨:22 LTS)
npm 10以上
シェル bash/zsh/fish

ローカルLLM利用時の追加要件

用途 GPU/VRAM システムRAM 使えるモデル例
お試し(補助用途) VRAM 8GB(RTX 3060 12GB等) 16GB Qwen2.5-Coder 7B、Llama 3 8B
実用(自律タスク) VRAM 16GB(RTX 4060 Ti 16GB等) 32GB Qwen2.5-Coder 14B、Codestral 22B(Q4_K_M量子化)
本気運用 VRAM 24GB以上(RTX 4090/5090/A6000) 64GB Qwen2.5-Coder 32B、DeepSeek-Coder-V2 16B、Llama 3.3 70B(Q4量子化)

インストール手順

Windows(VS Code版・推奨)

最も簡単で安定するパターンです。VS Codeとnpmが既にあれば3分で完了します。

winget install --id Microsoft.VisualStudioCode -e
code --install-extension saoudrizwan.claude-dev

winget未導入の場合はVS Code公式サイトから直接インストールします。コマンドを使わずVS Codeを開き、左サイドバーの拡張機能(Ctrl+Shift+X)から「Cline」(発行者 saoudrizwan)を検索してインストールでも構いません。

インストール後はVS Codeを再起動し、左のアクティビティバーにロボットのアイコンが現れていれば成功です。クリックすると右側にClineのパネルが開きます。

macOS(VS Code版)

brew install --cask visual-studio-code
code --install-extension saoudrizwan.claude-dev

Homebrewが未導入の場合は公式サイトのインストールコマンドを実行して先に入れます。

Linux(Ubuntu / Debian系)

VS Code本体のインストールは公式ドキュメントの手順に従うのが最も確実です。Microsoftが公式aptリポジトリを提供しているため、Snap版でもdeb版でも好みで構いません。Cline拡張のインストールは以下のコマンド1行です。

code --install-extension saoudrizwan.claude-dev

JetBrains IDE(IntelliJ/PyCharm/WebStorm等)

  1. IDEを起動して Settings → Plugins → Marketplace を開きます
  2. 検索ボックスに「Cline」と入力し、Cline Bot Inc.発行のプラグインを選んで Install をクリックします
  3. IDE再起動後、View → Tool Windows → Clineからパネルを開きます

CLI版(macOS/Linux)

ターミナルから自律エージェントを呼び出したい場合のインストール手順です。リモートSSH越しの開発やCI/CDからの利用に向きます。

node --version
npm --version

npm install -g cline

cline auth

cline authを実行するとブラウザが開き、Cline Hubのアカウント認証フローが走ります。Cline Hubは利用料を支払うクラウド統合管理ウェブUIで、認証後はAPIキーがローカルに保存されます。自前のAPIキーを使いたい場合はcline auth --provider anthropicなどプロバイダーを指定してAPIキーを直接入力します。

Kanbanモード(プレビュー)

複数エージェントを並列で動かしてカンバンUIで管理したい場合のオプションです。Node.js 18以上であれば即起動できます。

npx kanban

起動後にブラウザでKanbanのUIにアクセスし、各カードに「ログイン機能の実装」「テストの追加」のようなタスクを書くと、それぞれが独立したClineエージェントとして動きます。

初期設定

Cline本体のインストールが終わったら、次に行うのが「どのLLMプロバイダーで動かすか」の設定です。ここを最初に決めないとエージェントは1ステップも動けません。

パネルを開いてAPIプロバイダーを選ぶ

VS CodeのClineアイコンをクリックしてパネルを開くと、初回のみ「Set up your API」というウィザードが表示されます。プロバイダー一覧から使うものを選びます。代表的な選択肢は以下のとおりです。

プロバイダー 必要なもの 料金目安 備考
Anthropic API APIキー(console.anthropic.com) Sonnet 4.6: 3ドル/15ドル(入力/出力、100万トークン) 最もエージェント性能が安定。Cline開発の主軸モデル
OpenAI APIキー(platform.openai.com) GPT-5.5: 中価格帯 GPT-5以降はエージェント能力が大幅向上
OpenRouter OpenRouterアカウント+APIキー 各モデルの実費+手数料 1つのAPIキーで全モデルを統一管理可能
Google Gemini Google AI Studio APIキー 無料枠あり、Geminiは比較的安価 無料枠が大きく、お試しに最適
AWS Bedrock AWSアカウント+IAMキー 各モデルの実費 エンタープライズ統制が必要な現場向け
Ollama ローカルOllama実行中 無料(電気代のみ) 完全ローカル、プライバシー最優先
LM Studio ローカルLM Studio実行中 無料(電気代のみ) OpenAI互換APIサーバーモード
Cline Provider Cline Hubアカウント クラウド従量課金 クレジット制で最初の数ドル分が無料

商用APIで始める(最速・最も安定)

最も簡単なのはAnthropic APIです。Anthropic Consoleでアカウント作成、5ドル程度のクレジットを購入してAPIキーを発行、Clineパネルで貼り付けるだけです。デフォルトのモデルはclaude-sonnet-4-6を選んでおきます。

ローカルLLM(Ollama)で始める

API料金を払いたくない、自宅PCに高性能GPUがある、コードを外部に出したくない、という場合のセットアップです。前提としてOllamaがインストール済みであることが必要です。

ollama pull qwen2.5-coder:32b
ollama serve

Ollamaが起動するとhttp://localhost:11434でAPIサーバーが立ち上がります。Clineのパネルで Provider を Ollama に切り替え、Base URLはhttp://localhost:11434、Modelはqwen2.5-coder:32bを選択します。VRAMが足りない場合はqwen2.5-coder:14bqwen2.5-coder:7bに下げます。

同じPC上で実行するなら速度面の心配はありませんが、自律エージェントとしての性能は商用APIに比べると落ちるため、まずは小さなタスクで挙動を確かめてください。

LM Studio経由で始める

UI付きでモデルを管理したい場合はLM Studioが手軽です。LM Studio公式サイトから最新版をインストールします。LM Studioは2026年に入ってからUIが大幅刷新されており、現行は4系(メジャー版)です(過去に「LM Studio 3系」と書いた記事も多いですが、現時点での最新は4系である点に注意してください)。

LM Studio起動後、Developerタブから「Start Server」でローカルAPIサーバーを起動、Clineの Provider を LM Studio(または OpenAI Compatible)に切り替え、Base URLにhttp://localhost:1234/v1、APIキーはダミー値(lm-studio等)を入力します。

基本的な使い方

Plan/Actモードの違いを理解する

Clineには「Planモード」と「Actモード」という2つのモードがあります。これがCline独特の設計で、初心者がまずつまづくポイントなのでしっかり押さえます。

モード 挙動 使うタイミング
Plan コードは編集しない。仕様の整理、設計案の提示、関連ファイルの読み込みのみ 仕様が曖昧な時、変更範囲が広い時、レビュー的な対話をしたい時
Act 実際にファイルを書き換える、コマンドを実行する 計画が固まり、あとは実装するだけの段階

パネル下部にあるトグルでPlan/Actを切り替えます。最初の指示は必ずPlanモードで投げるのがコツです。「ログイン機能を実装して」のような曖昧な指示をいきなりActモードで投げると、エージェントは想定と違うファイルを作り始め、トークンを大量消費したうえで後戻りが必要になります。

最初の対話の流れ

  1. プロジェクトフォルダをVS Codeで開くFile → Open Folder
  2. Clineパネルを開いてPlanモードに切り替える
  3. 「このプロジェクトの構造を教えて」と入力。Clineがls -lacat README.mdなどを実行する許可を求めてくるので承認
  4. 構造把握が完了したら、具体的な指示(例:「src/auth/配下にJWT認証ミドルウェアを追加して、tests/auth/にユニットテストを書いて」)を入力
  5. Clineが計画案を提示するので、内容に納得したらActモードに切り替えてもう一度「進めて」と指示
  6. Clineが各ファイルの編集・コマンド実行ごとに承認を求めてくるので確認しながら承認

承認とAuto-Approve

毎回承認を求められるのが面倒な場合、Auto-Approveの設定で「ファイル読み込みは自動承認」「特定ディレクトリのファイル書き込みは自動承認」「特定コマンドは自動承認」を細かく指定できます。設定パネルから操作します。

ただし、本番環境のシークレットが入ったリポジトリ、データベース接続情報を含むファイル、絶対に消されたくないファイルがあるディレクトリでは、Auto-Approveをオフにして毎回手動承認にしてください。エージェントの暴走で本番DBが書き換わったといった事故は、Auto-Approveの濫用が主な原因です。

実践的な使い方

ユースケース1:既存コードのバグ修正

「テストは通っているが本番でエラーが出る」「ログを見ても原因がよくわからない」というよくある状況での使い方です。

  1. Planモードで「logs/error.logを読んで、最新のエラーの原因を推測して」と指示
  2. Clineがログを読み込み、関連するソースファイルを特定して原因仮説を提示
  3. 仮説に対して「再現テストを書いて」と指示し、Actモードへ切替
  4. Clineが再現テストを書いて実行し、確かに失敗することを確認
  5. 「テストが通るように修正して」と続け、Clineが修正コードを提案 → diff確認後に承認
  6. テストが通り、コミットメッセージまで提案してくれる

ユースケース2:新機能の実装(マルチファイル)

「ユーザー認証にOAuth2を追加して、Googleログインを使えるようにしたい」のような複数ファイルにまたがる新機能実装です。

  1. Planモードで「OAuth2でGoogleログインを追加したい。今のプロジェクト構造に合わせた最小実装を計画して」と指示
  2. Clineが既存の認証コード(例:src/auth/配下)を全部読み、その流儀に合わせた実装計画を提示。必要な依存パッケージ、新規ファイル、変更が必要な既存ファイルがリストアップされる
  3. 計画レビュー後、Actモードで「進めて」と指示
  4. Clineが順次npm install、新規ファイル作成、既存ファイル修正、テスト追加、テスト実行までこなす
  5. 各ステップでdiffが表示されるので、不要な変更があれば「この変更はやめて」と指示して取り消す

ユースケース3:レガシーコードの理解と整理

新しく参加したプロジェクトで「コードの全体像が掴めない」というケースに最も効きます。

  1. Planモードで「このリポジトリの全体構造をアーキテクチャ図的に説明して」と指示
  2. ClineがREADME、設定ファイル、主要モジュールを順次読み、Markdownで構造を説明してくれる
  3. 気になる箇所を指して「src/payment/配下が複雑すぎる。リファクタリングの方針を3つ提案して」
  4. 提案ベースで方針を1つ選び、Actモードで段階的にリファクタリング
  5. 各段階でテスト実行を強制してリグレッションを防ぐ

応用・カスタマイズ

.clinerules でプロジェクト固有のルールを定義する

チーム開発でClineを使う場合、絶対にやっておきたいのが.clinerulesの設定です。これはエージェントに対する「このプロジェクトでは必ず守ってほしい規約」を渡す仕組みです。

プロジェクトのルートに.clinerules/ディレクトリを作り、その中に複数の.mdファイルを置きます。Clineは起動時にディレクトリ内のすべてのMarkdownを読み込みます。

mkdir .clinerules
touch .clinerules/coding-style.md
touch .clinerules/testing.md
touch .clinerules/security.md

例えば.clinerules/coding-style.mdに以下のように書きます。

# Coding Style Rules

- すべてのTypeScriptファイルはstrict modeに準拠すること
- any型の使用は禁止。unknown型を使い、必要に応じて型ガードでナローイング
- 関数のpublicインターフェースには必ずJSDocを書くこと
- 1関数あたり50行を超える場合は分割を検討すること
- 副作用のある関数名は動詞始まり、純関数は名詞始まりとすること

これだけで、Clineが生成するすべてのTypeScriptコードがこの規約に従うようになります。チームで共有する場合はリポジトリにコミットしておけば、メンバー全員のCline環境で同じ規約が効きます。

条件付きルール(YAML frontmatter)

「フロントエンド側のファイルだけに適用するルール」「テストファイルだけに適用するルール」のように、ファイルパスで条件を絞ることもできます。Markdownの先頭にYAML frontmatterを書きます。

---
paths:
  - "src/frontend/**"
  - "src/components/**"
---

# Frontend Rules

- スタイリングはTailwind CSSのみ使用、CSS-in-JSは禁止
- 状態管理はZustandを使い、ReduxやMobXは導入しない
- コンポーネントは関数コンポーネント+hooksで統一

ルールファイルが大きくなりすぎると、エージェントが守りきれなくなる傾向があります。1ファイル150行以下を目安に、トピック別に分割するのがCline公式の推奨です。

MCP(Model Context Protocol)で外部システム連携

MCPは、AIエージェントが外部のツール/データに統一的にアクセスするためのオープンな規格です。ClineはMCPサーバーを「ツール」として認識し、エージェントがそれらを直接呼び出せます。代表的な使い方は以下のとおりです。

  • GitHub MCP:Issuesの取得、PRのコメント追加、コミット履歴の確認をエージェントが直接実施
  • PostgreSQL MCP:エージェントがSQLを実行しスキーマ確認やマイグレーション案を作成
  • Linear MCP:チケットの自動起票、進捗更新
  • Slack MCP:チャンネルへの通知、過去ログ検索
  • Notion MCP:仕様書ページの読み取り、生成ドキュメントの追記

MCPサーバーの追加は、Clineの設定画面に組み込まれているMCPマーケットプレイスからワンクリックで可能です。手動でcline_mcp_settings.jsonに書き加えることもできます。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_TOKEN_HERE"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://YOUR_USER:YOUR_PASSWORD@localhost/dbname"]
    }
  }
}

カスタムシステムプロンプト

Clineの設定でSystem Prompt欄を編集すると、すべての会話に共通する追加指示を渡せます。「日本語で回答」「コミットメッセージは英語」「絵文字は使わない」といった全体方針を入れるのに便利です。

SDKでアプリケーションに組み込む

Clineの自律エージェント機能を自前のアプリに組み込みたい場合、@cline/sdkを使います。Webアプリのバックエンドからエージェントを起動し、結果をフロントに返すといった用途に向きます。

npm install @cline/sdk
import { ClineAgent } from "@cline/sdk";

const agent = new ClineAgent({
  provider: "anthropic",
  apiKey: process.env.ANTHROPIC_API_KEY,
  model: "claude-sonnet-4-6",
  workspace: "/tmp/workspace",
});

const result = await agent.run("READMEに従って依存パッケージをインストールし、テストを実行して。");
console.log(result.summary);

パフォーマンス最適化

コンテキスト爆発を防ぐ

Clineで最も多い失敗が、長時間動かしているうちにコンテキスト消費が膨れ上がり、トークン上限に達して中断するパターンです。次の手を打ちます。

  • 1タスクは1セッションに収める:別の機能の話に移るときは新しいセッションを開始する
  • 不要なファイル読み込みを止める.clineignorenode_modules/dist/.next/、巨大なログファイルなどを追加
  • Plan/Actを切り替える:計画はPlan、実装はActと分けることでActモードのトークン消費を抑制
  • プロンプトキャッシュ対応モデルを使う:Claude Sonnet 4.6はプロンプトキャッシュで90%のコスト削減が可能。同じシステムプロンプト+.clinerulesで繰り返し動かすケースで効果絶大

.clineignore の例

# Cline用の無視リスト(Gitignoreと同じ書式)
node_modules/
dist/
build/
.next/
.cache/
coverage/
*.log
*.lock
package-lock.json
yarn.lock
pnpm-lock.yaml
.git/
.DS_Store

ローカルLLMの推論速度を上げる

Ollama/LM Studio経由でローカルLLMを使う場合の高速化テクニックです。

  • 量子化レベルを下げる:Q4_K_MからQ5_K_Mに上げると精度は上がるがVRAM消費と速度がトレードオフ。Q4_K_M推奨
  • コンテキスト長を絞る:Ollamaのモデル設定でnum_ctxを16384など必要最小限に抑える
  • Flash Attention有効化:Ollama 0.5以降はOLLAMA_FLASH_ATTENTION=1環境変数で大幅高速化
  • 専用GPUを与える:ComfyUIや他のAIアプリと同じGPUで取り合うと両方遅くなる。コーディング専用にRTX 4060 Ti 16GBクラスをもう1枚積むのも有効

よくあるエラーとトラブルシューティング

実際にClineのGitHub Issuesで多く報告されている問題と、その対処法を紹介します。

1. 「API request failed」が頻発する

症状:商用APIで動かしているとリクエストエラーで途中停止

原因と対処

  • APIキーが失効している → Anthropic/OpenAIコンソールで再発行して貼り直す
  • レート制限に到達 → Cline設定でRate limit delayを増やす(5秒以上推奨)
  • クレジット残高がゼロ → APIプロバイダーの請求ダッシュボードで残高を確認
  • 長いretry-afterヘッダがエージェント内でリトライされる既知バグ(Issue #10139)→ v3.88.0以降では改善傾向、それでも頻発するならRate limit delayを15秒以上に

2. Token countが異常な値を示す

症状:コンテキストウィンドウのトークン使用量が現実的でない値(数億トークンなど)に表示される

原因と対処

  • 既知のトークンカウントバグ(Issue #10148)→ セッションを新規作成して回避
  • 非常に大きなファイル(数MB以上のログなど)を読み込んだ場合に発生しやすい → .clineignoreで除外

3. Windowsで「Resume task」ボタンが完了済みタスクに表示される

症状:完了済みタスクを再オープンしたときに「Resume task」ボタンが誤って表示される

原因と対処

  • Windows固有の既知バグ(Issue #10379)。Hooks機能を有効にしている時に発生
  • VS Codeを再起動する。または該当タスクを履歴から削除して新規開始する

4. CLI版でAWS Bedrock認証が失敗する

症状:CLI版でcredential_processを使ったAWS認証が機能しない(Issue #10930)

原因と対処

  • 2026年6月時点でcredential_process未対応
  • 当面の回避策:AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEYを環境変数で直接渡すか、~/.aws/credentialsに直書きする

5. チェックポイント復元後にスクリーンショットが残る

症状:チェックポイントに戻したのに、添付したスクリーンショットが入力欄に残ってタスク継続を阻害する(Issue #9906)

原因と対処

  • UIバグとして報告中。入力欄のスクリーンショットを手動でクリックして削除する
  • VS Codeのコマンドパレットで「Cline: New Task」を実行して回避

6. Ollama接続で「connection refused」

症状:Ollama設定にしたら「connection refused」が出てモデルが応答しない

原因と対処

  • Ollamaが起動していない → ターミナルでollama serveを実行
  • Base URLの記述ミス → http://localhost:11434(末尾に/v1不要)が正しい
  • WSL2環境からWindows側Ollamaに接続したい → Windows側でOLLAMA_HOSTを環境変数として0.0.0.0:11434に設定し、WSL2側からはWindowsホストIP(WSL2のresolv.conf内のnameserver値、もしくは$(hostname).local)を指定

7. ターミナルコマンドがハングする

症状:エージェントが実行したコマンドが終わらない

原因と対処

  • 対話入力を求めるコマンド(git rebase -ivim等)はハングする → .clinerulesに「対話的コマンドは使わない」を明記
  • 長時間実行コマンドはバックグラウンド化する指示を出す
  • VS Code統合ターミナルとClineが取り合うことがある → Cline側のターミナルプロファイル設定を別シェルにする

おすすめの組み合わせ・連携

Cline + Ollama(完全ローカル運用)

API料金ゼロで完結させたい、コードを外部に出したくない、というユースケースの王道構成です。

  • OllamaにQwen2.5-Coder 32B(Q4_K_M)を入れる:コード生成の総合バランスが最良
  • RTX 4090/5090クラス推奨:32Bモデルを実用速度(20トークン/秒以上)で動かすにはVRAM 24GB必須
  • 32GB以上のシステムRAM:Ollamaがオフロードする際に必要
  • NVMe SSD 2TB以上:モデル本体が20GB前後、複数モデル運用なら必須

Cline + Claude Sonnet 4.6 + プロンプトキャッシュ

商用APIで品質最優先かつコストも意識したい場合の最適解です。

  • Anthropic APIのプロンプトキャッシュ機能で、システムプロンプトと.clinerulesの繰り返し送信コストを90%削減
  • 大規模リポジトリでも実質コストを抑えられる
  • Cline側のモデル設定でEnable Prompt Cachingをオン

Cline + GitHub MCP

「PRレビュー対応」「Issueトリアージ」を自動化したい場合の組み合わせです。Cline内でGitHubのIssue/PRを直接読み書きできるようになり、「未対応のIssueを優先度順に整理して」「このPRのレビューコメントに対応して」といった指示が通るようになります。

Cline + PostgreSQL MCP

データベーススキーマとアプリコードの両方を読みながら、整合性のあるマイグレーションを自動生成できます。「新しいフィールドを追加するためのマイグレーションを作って、関連するモデルクラスも更新して」のような指示が一気通貫で通ります。

Cline + Continue.dev併用

Clineは「自律的に動かしたい時」、Continue.dev(v1.3.38)は「コーディング中のリアルタイム補完/チャット」と役割分担して両方インストールしておく構成も実用的です。タブで切り替えながら使えます。

推奨PCスペック

Clineの使い方別に、入門~本気運用まで3段階の推奨構成を示します。商用API主体で使うなら入門スペックでも十分ですが、ローカルLLMで自律エージェントを快適に動かすには本気構成が必要です。

入門:商用API主体での利用

パーツ 推奨
CPU Ryzen 5 7600 / Core i5-14400
RAM 16GB DDR5
SSD 1TB NVMe SSD
GPU 内蔵GPUでOK(API主体なら不要)
OS Windows 11 / macOS 14 / Ubuntu 24.04
用途 Anthropic/OpenAI APIで日常的にエージェント運用

標準:ローカルLLM併用

パーツ 推奨
CPU Ryzen 7 7700X / Core i7-14700
RAM 32GB DDR5
SSD 2TB NVMe SSD
GPU RTX 4070 Ti SUPER 16GB
OS Windows 11 / Ubuntu 24.04
用途 14B~22B量子化モデルで日常の軽タスクをローカル化、難タスクは商用APIへフォールバック

本気運用:完全ローカル自律エージェント

パーツ 推奨
CPU Ryzen 9 7950X / Core i9-14900K
RAM 64GB DDR5
SSD 4TB NVMe SSD(Gen4以上)
GPU RTX 5090 32GB(または RTX 4090 24GB ×2)
OS Ubuntu 24.04(Windowsでも可だがLinuxの方が安定)
用途 Qwen2.5-Coder 32B、DeepSeek-Coder-V2、Llama 3.3 70B(Q4量子化)を実用速度で運用

本気構成では、ClineをActモードで放置していてもAPI料金を一切気にせず動かせます。電気代だけで考えると、フル稼働でも月数千円程度(500W ×24時間 ×30日 ×40円/kWh = 約14,400円)に収まります。Anthropic APIで月数百ドル使うアクティブ開発者にとっては、半年から1年で初期投資を回収できる計算です。

まとめ

Clineは「VS Codeに自律型コーディングエージェントを組み込みたい」という需要に対する、2026年6月時点での決定打です。Apache 2.0のオープンソースで本体料金は無料、30以上のLLMプロバイダーに対応し、ローカルLLMにも完全対応、Cursorに匹敵する自律性を持ちながら、Cursorの月20ドルやCopilotの月10~100ドルといった追加サブスクリプションが不要です。

Cursorは確かに統合度と速度で勝る面がありますが、独自IDEへの移行コスト、商用クローズドソースであることの透明性の問題、価格上昇リスクを考えると、Clineの方が長期的に安心できる選択肢になります。Roo Codeは2026年5月にリポジトリがアーカイブされ事実上開発停止、Continue.devは補完中心で自律性ではClineに及ばず、Aiderは強力だがエディタ統合が弱い、というのが2026年6月時点の比較状況です。

誰におすすめか整理すると、Cursor/Copilotの料金が気になっている開発者自宅PCのローカルLLMで完結する開発環境を作りたい個人開発者セキュリティ要件で外部APIにコードを出せない企業自律エージェントが何をどこまでできるか実地で確かめたいエンジニアのすべてに第一候補となります。一方、エンタープライズで会社支給のCopilotがすでに導入されているケースでは、追加コストゼロのCopilotを基本に、特定の自律タスク用途でClineを併用する形も合理的です。

今後の展望として、Cline開発チームは「IDE横断のエージェント体験」「MCPマーケットプレイスの拡充」「Kanban/SDKによるエージェント並列実行」を重点的に進めると公式ロードマップで示しています。週単位でリリースが続く活発さからして、2026年後半には商用クローズドソース勢を機能面でも完全に上回る可能性が高い段階です。まずは入門スペックで商用API+Cline、慣れたら標準スペックでローカルLLM併用、と段階的に運用を広げていくのが、コスト最適化と学習効率の両面で最適なアプローチになります。

📦 この記事で紹介した商品

※ 上記リンクはAmazonアソシエイトリンクです。購入いただくと当サイトに紹介料が入ります。

タイトルとURLをコピーしました