Cline · OSS
Cline ベストプラクティス
IDE 拡張・デスクトップアプリ・CLI で使える、モデルを自由に選べるオープンソースのコーディングエージェントです。ルール、Plan / Act、チェックポイント、自動承認、MCP、Skills の使い方を整理しています。
2026-11-02 に公式ドキュメントのソース(github.com/cline/cline の docs/)と照合済み
最新アップデート
ニュースに収録済みの直近3件です。全件はニュースから確認できます。
2026-10-26Cline v4.1.26・Desktop v0.0.49・CLI v3.0.74 — Cloud タスク用のモデルを別設定に、多数のプロバイダーで既定モデルが変更
Cloud sessions を有効にしている場合、Cloud タスクで使うモデルをローカルとは別に設定できるように。Desktop に変更ファイルの一覧・差分ペイン・ファイルツリー・統合ターミナルを追加。
挙動変更: モデルカタログの刷新で、56のプロバイダーの既定モデルが変わりました。モデルを固定していない場合は確認してください。ニュースを読む
2026-10-17Cline v4.1.25 — ホスト型サンドボックスでタスクを実行する Cline Cloud sessions を段階展開
選んだ GitHub リポジトリ・ブランチのタスクを、ホスト型のサンドボックスで実行できるように(エディタを閉じても継続)。
挙動変更: SDK v0.0.94・CLI v3.0.72 でプラグインの in_process モードを削除し、worker thread かサブプロセスのサンドボックスでだけ実行するように。ニュースを読む
2026-10-13Cline v4.1.24 — .claude/skills のスキルを検出、symlink のルールファイルを読み込み
Claude Code 向けに書かれた .claude/skills のスキルを Cline が検出するように。symlink のルールファイルも読み込まれるように。CLI v3.0.71 では、失敗したプラグインの状態を cline hub plugins で確認できるように。ニュースを読む
特徴
- オープンソース(Apache 2.0)。モデルのプロバイダーを自由に選べる
- IDE 拡張(VS Code・Cursor・Windsurf・VSCodium・Antigravity・JetBrains)、デスクトップアプリ、CLI、Kanban、SDK で使える。ACP に対応したエディタ(Zed・Neovim など)からも使える
- Plan / Act の2つのモードで、計画と実行を分ける
- チェックポイントで、ファイルの変更を会話を残したまま元に戻せる
- MCP・Skills・Hooks・プラグインで拡張できる
Claude Code との違い
- 主な使い方は IDE 拡張とデスクトップアプリ(CLI もある)
- Anthropic 以外のモデルやローカルモデルにも切り替えられる
- 自分の API キーを使えば、モデル料金を直接確認できる。Cline Provider(従量課金)や ClinePass(月額)も選べる
- ルールファイルは
.clinerules/(CLAUDE.md にあたる)。AGENTS.mdや.cursorrulesも読み込む
インストールと設定の保存場所
01IDE 拡張・デスクトップアプリ
- VS Code など: 拡張機能(
Ctrl/Cmd + Shift + X)で「Cline」を検索してインストール。Windsurf と VSCodium は Open VSX から - JetBrains: Settings → Plugins → Marketplace で「Cline」を検索
- デスクトップアプリ: cline.bot/desktop からダウンロード(macOS・Windows、Windows はベータ)。セッションの並列実行、定期実行、他のエージェントからのセッション取り込みに対応
インストール後、Cline の設定画面でプロバイダーとモデルを選びます。
02CLI
# Node.js 20 以上(22 推奨)
npm install -g cline
# プロバイダーとモデルを設定
cline auth
# 対話モード / タスクを1つ実行
cline
cline "refactor this module to use async/await"
# Plan モードで始める
cline -p "design migration plan"
# スクリプト向け(JSON で出力)
cline --json "list TODO comments"
--auto-approve は既定で true です。プロンプトを渡して実行すると、ツールが確認なしで実行されます。確認を挟みたい場合は --auto-approve false を付けてください(ACP モードでは既定が false)。無人で動かすときは、クリーンなブランチで実行して結果を確認します。| コマンド・フラグ | 内容 |
|---|---|
cline mcp | MCP サーバーの管理 |
cline schedule | 定期実行タスクの管理 |
cline history | タスク履歴の表示・管理 |
cline doctor | 設定の問題の診断・修正 |
cline connect | Slack・Telegram・Discord などからエージェントを使うための接続設定(CLI のみ) |
-m, --model / -P, --provider | この実行だけモデル・プロバイダーを変える |
--thinking <level> | 推論の深さ(none / low / medium / high / xhigh) |
-c, --cwd | 作業ディレクトリを指定 |
標準入力にパイプしたとき(例: git diff | cline "review these changes")や出力をリダイレクトしたときも、自動的にヘッドレス(非対話)で動きます。
03設定ファイルの保存場所
cline.apiProvider・cline.alwaysAllowWrite などを書く例を載せていましたが、公式ドキュメントにそのような設定キーはありませんでした。プロバイダーや自動承認は Cline の設定画面(CLI は cline auth)で設定します。~/.cline/ # 全体の設定(IDE・CLI・SDK 共通)
data/settings/
providers.json # API キーとプロバイダー設定
global-settings.json # 全体の設定
cline_mcp_settings.json # MCP 設定(CLI)
rules/ workflows/ hooks/ skills/ agents/ plugins/
.cline/ # プロジェクトの設定
rules/ workflows/ skills/ hooks/ agents/ plugins/
出典: Installing Cline · CLI Overview · CLI Reference · Configuration
ルール(.clinerules/)
毎回のタスクで読み込まれる指示ファイルです。Claude Code の CLAUDE.md、Codex の AGENTS.md にあたります。
01置き場所と読み込まれるファイル
| 種類 | 場所 |
|---|---|
| プロジェクトのルール | .clinerules/ または .cline/rules/ の中の Markdown ファイル |
| 全体のルール | ~/Documents/Cline/Rules(Windows は Documents\Cline\Rules)、~/.cline/rules など |
| 他ツールのルール | AGENTS.md・~/.agents/AGENTS.md・.cursorrules・.windsurfrules |
- ディレクトリ内のファイルは1つのルールセットとしてまとめて読み込まれます(ファイルごとに有効・無効を切り替え可能)。プロジェクトと全体のルールが矛盾した場合はプロジェクト側が優先です
- ルールごとに有効・無効を切り替えられます。
/newruleで Cline に対話しながらルールを作らせることもできます - ルールはコンテキストを消費するので、簡潔に書き、長い資料はリンクにします
your-project/
├── .clinerules/
│ ├── coding.md # コーディング規約
│ ├── testing.md # テストの決まり
│ └── architecture.md # 構成の方針
└── src/
02特定のファイルだけに効くルール(paths)
ルールファイルの先頭に paths を書くと、作業中のファイルが一致したときだけそのルールが有効になります。
# .clinerules/api.md
---
paths:
- "src/api/**"
---
# API のルール
- すべての API レスポンスを zod スキーマで検証する
- fetch は apiClient() ラッパー経由でだけ使う
- エラーレスポンスは { error: string, code: string } の形にする
公式ドキュメントに記載があるのは、プロジェクト直下の置き場所と、この paths による絞り込みです。特定のディレクトリだけに効かせたいルールは paths で指定します。
03Memory Bank(作業の記憶をファイルに残す)
プロジェクトの概要や現在の作業状況を Markdown ファイルにまとめておき、タスクの最初に読ませる方法です。公式ドキュメントのベストプラクティスとして紹介されています。
memory-bank/
projectbrief.md # プロジェクトの土台となる要件・目標
productContext.md # なぜ作るのか・解決する課題
activeContext.md # 今取り組んでいる作業・直近の変更
systemPatterns.md # 構成・設計の方針
techContext.md # 技術スタック・制約
progress.md # 完了したこと・残っていること
公式が配布している指示文を .clinerules/memory-bank.md に貼り、Cline に「initialize memory bank」と頼むと、これらのファイルが作られます。
出典: Rules · Memory Bank
モデルの選び方
Anthropic・OpenAI・Google・Amazon Bedrock・Vertex AI・OpenRouter・OpenAI 互換 API・ローカルモデル(Ollama・LM Studio)など、多くのプロバイダーに接続できます。
01使い分けの考え方
- 普段のコーディングは中位〜上位のモデル、名前の変更やコメントの追加など単純な作業は安いモデルに切り替える
- 機密性の高いコードは、ローカルモデルや自社契約のクラウド(Bedrock・Vertex AI)経由で扱う
- モデルを指定していないと、カタログの更新で既定モデルが変わることがある(2026-10-26 に56プロバイダーで変更)。使うモデルは明示的に選んでおく
- 料金はプロバイダーとモデルによって変わるため、各プロバイダーの最新の価格表で確認する
Plan / Act とチェックポイント
01Plan モード → Act モード
- Plan モード: コードを読んだり検索したりして方針を話し合う。ファイルの変更やコマンドの実行はしない
- 計画を確認: 方向がずれていればここで直す
- Act モードに切り替え: Plan モードの会話を引き継いだまま、ファイルの変更やコマンドを実行する
影響範囲がわからない大きな作業は、Plan モードから始めます。
02チェックポイント(変更を元に戻す)
Cline はツールを使うたびに、プロジェクトとは別の「影の Git リポジトリ」にファイルの状態を保存します。自分の Git 履歴は変わりません。Git で管理していないファイルも保存されます。既定で有効です。
| 復元の種類 | 内容 |
|---|---|
| Restore Files | ファイルだけをその時点に戻す(会話は残る) |
| Restore Task Only | その後のメッセージだけを消す(ファイルはそのまま) |
| Restore Files & Task | ファイルと会話の両方をその時点に戻す |
大きなリポジトリでは保存に容量と時間がかかるので、遅いと感じたら設定の「Enable Checkpoints」でオフにできます。
03複数のタスクを並行して進める
- デスクトップアプリでは、複数のセッションを並行して実行できます
- Cline Cloud sessions を使うと、GitHub のリポジトリ・ブランチを指定して、ホスト型のサンドボックスでタスクを実行できます(段階展開中)
出典: Plan & Act · Checkpoints · Cline Desktop
自動承認(Auto Approve)
どの操作を確認なしで実行させるかを、種類ごとに決めます(IDE 拡張の設定)。
01設定項目とおすすめの初期設定
| 項目 | 許可される操作 |
|---|---|
| Read project files / Read all files | ワークスペース内 / 外のファイルの読み取り |
| Edit project files / Edit all files | ワークスペース内 / 外のファイルの作成・編集 |
| Execute safe commands / Execute all commands | 安全とされたコマンド / 承認が必要なコマンドも含めて実行 |
| Use the browser | ブラウザツールでの取得・検索 |
| Use MCP servers | MCP のツールとリソース |
| Enable notifications | 承認が必要なときや、自動承認したコマンドが長く動いているときに OS の通知を出す |
- コマンドが安全かどうかは固定の許可リストではなく、モデルがコマンドごとに判断します(
npm install・rm -rf・sed -iなどは通常承認が必要) - 公式のおすすめは「Read project files だけ有効にし、編集・コマンド・ブラウザ・MCP は理由ができるまでオフ」
- 編集を自動承認にするなら、チェックポイントですぐ戻せるようにしておく
- すべての操作を確認なしで実行する YOLO モードもありますが、ファイルの削除やコマンドの実行まで止まらなくなるため、使い捨ての環境以外では避けます
出典: Auto Approve
MCP
01MCP サーバーの追加
- IDE 拡張: Cline パネルの MCP Servers アイコン → Configure → Configure MCP Servers で設定の JSON を開く。リモートのサーバーは Remote Servers タブで URL を入力(Streamable HTTP 推奨)
- CLI:
cline mcpのウィザードで追加・編集・有効化・OAuth 認証。設定ファイルは~/.cline/data/settings/cline_mcp_settings.json(環境変数CLINE_MCP_SETTINGS_PATHで変更可)
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
},
"remote-example": {
"type": "streamableHttp",
"url": "https://example.com/mcp"
}
}
}
リモートのサーバーで type を省略すると、互換性のため旧来の SSE 方式で接続されます。推奨の Streamable HTTP を使うには "type": "streamableHttp" を明示します。トークンなどの秘密情報は設定ファイルに直接書かず、環境変数で渡します。
出典: MCP Overview
Skills
SKILL.md を含むディレクトリです。起動時には名前と説明だけが読み込まれ、依頼が説明に合うと本文が読み込まれます。
01置き場所と書き方
- プロジェクト:
.cline/skills/(推奨)・.clinerules/skills/・.claude/skills/(v4.1.24 から)・.agents/skills/。全体:~/.cline/skills/・~/.agents/skills/ - 同じ名前の Skill がある場合は、ルールとは逆に全体(global)側が優先されます
- フロントマターの
nameとdescriptionがいつ使うかの判断に使われるので、説明は具体的に書く - 本文はよく使う内容を先に書き、見出しで区切る
出典: Skills
ベストプラクティス
ルール
- 抽象的に書かず、命名規則やファイルパスなど具体的に書く
- ルールが奇妙に見えるときは理由も書く(例: 「/legacy は来期削除予定なので変更しない」)
- 見本になる既存のコードを指し示す
- 1ファイル1テーマに分け、
pathsで必要なときだけ読ませる - チームで使うルールは Git で管理してレビューする
安全とコスト
- 自動承認は読み取りだけから始める。CLI は既定で自動承認なので、必要なら
--auto-approve false - 大きな作業は Plan モードで方針を固めてから Act に切り替える(やり直しが減り、コストも下がる)
- 使うモデルを明示的に選び、単純な作業は安いモデルに切り替える
.clineignoreは廃止予定で、アクセスを防ぐ仕組みではない。代わりに公式は「Block Ignored File Access」プラグインを案内しているが、これもシェルコマンドは防げない。秘密情報はリポジトリに置かない
出典: Rules · Deprecations
更新ログ
in_processモードを削除しworker thread/サブプロセスsandboxのみに。OpenAI CompatibleのベースURLを入力どおりに使用。GPT-6系がOpenAI/Azure互換エンドポイントで拒否される問題を修正。詳細はニュース参照。.claude/skillsのスキルを検出、symlinkのルールファイルを読み込み。reasoningオフが全プロバイダーで動作、画像によるトークン推定の過大計上を修正。CLIはcline hub pluginsでプラグイン状態を確認可能に。詳細はニュース参照。.clinerulesのコミット規約に準拠。モデルカタログにClaude Haiku 5.5を追加、GPT-6 Astra等へ未対応のreasoningパラメータを送らないよう修正。詳細はニュース参照。/compactを追加。v0.0.43で既存ユーザー向けConnectors紹介オンボーディングダイアログを追加。詳細はニュース参照。js-yamlの最低バージョンを4.3.2に引き上げ(🔒)。日本発のオープンウェイトモデルプロバイダー「ai&」を追加。DesktopがLinux(.deb/.rpm)に対応し、プラグインのスラッシュコマンド・音声入力もデスクトップアプリで利用可能に。詳細はニュース参照。rg.exe・git.exe・powershell.exeという名前のファイルがあると、裸のプログラム名がPATHより先にワークスペースディレクトリから解決され、本物の代わりに実行されてしまう脆弱性を修正(🔒)。v4.1.19はWindowsのNoDefaultCurrentDirectoryInExePathを起動時に設定して対処(コマンドプロンプトでカレントディレクトリのプログラム実行には.\指定が必要に)。Desktop v0.0.30も同じ脆弱性を修正し、Windows Restart Manager API採用でインストーラー更新失敗も解消。モデルが読み取れない画像を黙って破棄せず警告表示するように変更。詳細はニュース参照。~/.agents/plugins)を共有Hubが検出・plugin.jsonを検証した上で自動実行するように対応。Agent SkillsやMCPサーバーが自動で使えるように。Settings→CustomizeでAgent Pluginsを独自形式のCline Pluginsとは別枠表示。「Hub更新」ダイアログが毎起動で表示される不具合を解消。詳細はニュース参照。SessionImportServiceを追加。既定モデルがAnthropicでClaude Fable 5.1に。ClinePassのカバレッジをアカウントページ等に表示。macOS向け音声入力・新規セッションでWeb検索が既定オンに。Windows向けAzure Trusted Signing対応。Desktop v0.0.23-beta.1(9/3)で画像生成機能をベータ提供。詳細はニュース参照。cline hub drain・cline hub upgradeを追加しHubの安全な再起動に対応。詳細はニュース参照。meta/muse-spark-1.2-contributorモデル追加。詳細はニュース参照。/undoの回帰を修正。チェックポイント復元はワークスペース全体を巻き戻す形に統一。Desktopに会話途中のメッセージ編集(その時点からセッションをフォークして再実行)機能を追加。WindowsのPowerShellがUTF-8 stdinに対応し文字化けを解消。詳細はニュース参照。