CLI 需全局安装 Node 包,SDK 是另一个包名 @cline/sdk,别混用;JetBrains 插件目前未开源,只能从 Marketplace 安装;使用前需自行配置模型提供商或本地模型服务,README 未给出默认模型。
npm i -g cline
npm install @cline/sdkREADME 未说明硬件要求;支持 Ollama / LM Studio 本地模型,也可接入 Anthropic、OpenAI、Gemini、Bedrock 等云端 API。
开源编码智能体,可在 IDE、终端和桌面运行,自主读写代码并执行命令
把自主编码智能体做成 SDK、IDE 插件和命令行助手三种形态,让开发者能在编辑器或终端里直接调用 AI 完成写代码、改代码等任务。
核心能力
- 读取项目结构并跨文件协调修改,自动修复 lint 与编译错误
- 直接执行 Bash 命令并实时监控输出,后台跟踪长驻进程
- Plan/Act 双模式切换,每次编辑与命令可人工审批或自动放行
- 用 .clinerules 定义项目规则,CLI 与各 IDE 插件自动加载
- 支持 MCP 服务器与 SDK 插件注册自定义工具和生命周期钩子
容易踩的坑
- v4.1.26最新正式版2026-10-26 · 2026-10-26 09:06 UTC
Added
- Cloud tasks: Settings > API Configuration has a Local | Cloud toggle when cloud sessions are on. Cloud picks the Cline model new cloud tasks run on, saved separately from your local models. Clicking the model label in a cloud session's composer opens it there.
- Starting or resuming a cloud sandbox shows a progress card with the repo, branch and steps (start sandbox, clone repository, start agent). It collapses once the agent starts.
Changed
- Cloud sessions hide the Plan/Act toggle and the auto-approve bar instead of showing them disabled.
- With no model chosen, the Cline provider uses Claude Sonnet 5.5 again, which is back at the top of Cline's recommended list.
- Model requests retry at most 3 times instead of 5.
- Kimi K3 now gets
maxreasoning for Extra High and Max, instead of anxhighsetting it rejects. - Refreshed the model catalog. Adds the CommandCode, Reflection, Liquid Inference and Munito AI providers and drops CrofAI, iFlow and Llama. The Cline free list adds Reflection Beam, Nemotron 3.5 Lightning and Laguna S 2.1 and drops Mimo V2.6 Flash and Muse Spark 1.3 Contributor. ClinePass now defaults to Kimi K3.1 Pro and adds MiniMax M3.1 Flash and DeepSeek V4.1 Flash 1017. Default models change for most other providers, mostly to Kimi K3.1 Pro, MiniMax M3.1 Flash or DeepSeek V4.1 Flash 1017. If you use a provider without pinning a model, expect a different default.
Fixed
- GPT-6 models (such as
gpt-6-solandgpt-6.1-sol) work on OpenAI and Azure OpenAI-compatible endpoints, and SAP AI Core no longer rejects requests with "Unsupported parameter: 'max_tokens'". Both now getmax_completion_tokens. - Gemini API keys (the
geminiprovider) no longer send native Google Search. Free-tier keys failed every turn with a 429 quota error on Gemini 3+, and on Gemini 2.x every Cline tool was dropped. - Toggling Plan/Act while a task is starting no longer drops your first prompt, and the session no longer keeps running with the other mode's tools.
- Disabled rules stay disabled.
- Starting a command no longer moves keyboard focus into the terminal, so text you're typing in the chat no longer lands in the shell.
- Cancelling a task or opening another one while Cline is asking a question no longer lets your next message get taken as the answer to the old question.
- A turn whose connection drops after the model has streamed only reasoning is now retried instead of ending the task.
- Auto-compaction no longer runs for models with an unknown context limit, and it no longer runs again every few tool calls after the first compaction.
ask_question: the model keeps going after you pick an option, and empty answers are rejected.run_commandswith an empty command list now returns an error instead of a silent success. On PowerShell, the tool tells the model how quote escaping works and to confirm recursive deletes first.- Task header badges wrap instead of hiding the close button, the GitHub connection check no longer flashes a loading indicator, and the Local/Cloud toggle's padding is fixed.
Full Changelog: https://github.com/cline/cline/compare/v4.1.25...v4.1.26
- desktop-v0.0.49Desktop v0.0.492026-10-26 · 2026-10-26 04:49 UTC
查看更新说明
- A new Changes button in the session header shows the session's line counts and opens a pane listing the files changed in the last turn or across the whole session, with a diff of each. When a turn finishes, a summary under it lists the files it changed; click it to open the pane on that turn
- A project files panel (folder button in the session header) shows a file tree beside the conversation, with a read-only tabbed viewer, git status letters, and a marker on files the session changed. Files the agent edited get a File/Diff toggle. Works on local and SSH environments
- An integrated terminal panel opens at the bottom of the window (toggle with Ctrl+backtick)
- Pull request status moved from the bar above the composer into a header button. Its menu shows the PR title, merge status and checks (failing checks first), and lets you open the PR on GitHub, create a PR, copy the branch name, or refresh
- A new Local Models settings page manages Ollama and LM Studio models: setup guidance, model details and storage, and a composer chip showing how much memory the loaded model uses
- Keybindings are configurable in Settings (also reachable from the app and Help menus). Quit can require holding the shortcut, 1 second by default on macOS, so it's harder to quit by accident
- Slash commands and
@filementions show as chips in the composer and in sent messages - If the Hub fails to start, the app now shows a startup screen with Retry and Export diagnostics, instead of failing every action with "desktop backend endpoint not ready"
- General settings shows the Hub's status and has a Restart Hub button
- Opening a task that's already running in another Cline app now attaches to that run instead of starting a second one that couldn't be stopped. Requests that were waiting on an app that closed mid-task now fail with a clear message instead of hanging
- Sessions with a very large transcript (over about 8 MB) can be resumed again. Before, the transcript was sent to the Hub twice, which went over its message size limit
- Long lines in the file and diff viewers wrap, and rows always span the full width when scrolled
- New Cloud chats start on your local Cline or ClinePass model. If Cloud doesn't offer that model, ClinePass subscribers get a ClinePass model and everyone else gets Claude Sonnet 5.5
- A pasted Cline API key now replaces an old browser sign-in instead of being ignored. Provider settings fields stack properly in the narrow side panel
- The Sessions/Projects sort choice in the sidebar is remembered across restarts
- On Linux desktops without a tray (stock GNOME on Fedora or Debian), closing the window quits the app instead of leaving it running with no way to quit
- Internal messages meant only for the model no longer show in the transcript, and live session titles no longer show the raw
user_inputwrapper - Schedule status stays current and failed runs show the full error
- Checking for changes no longer spawns thousands of git processes in workspaces with many untracked files
- SSH environments behind a ProxyJump alias now connect
- The update toast's Restart button sits under the message text
- A turn whose connection drops after the model has streamed only reasoning is now retried instead of ending the run
- Model requests retry at most 3 times instead of 5
- Kimi K3 now gets
maxreasoning for Extra High and Max, instead of anxhighsetting it rejects - Gemini API keys (the
geminiprovider) no longer send native Google Search. Free-tier keys failed every turn with a 429 quota error on Gemini 3+, and on Gemini 2.x every Cline tool was dropped - Auto-compaction no longer runs for models with an unknown context limit, and it no longer runs again every few tool calls after the first compaction
ask_question: the model keeps going after you pick an option, empty answers are rejected, and an answer with only an attachment countsrun_commandswith an empty command list now returns an error instead o
- cli-v3.0.74CLI v3.0.742026-10-26 · 2026-10-26 04:03 UTC
查看更新说明
- Opening a task that's already running in another Cline app now attaches to that run instead of starting a second one that couldn't be stopped. If an app closes mid-task, requests waiting on it now fail with a clear message instead of hanging
cline hub statusandcline doctorno longer hang on a Hub that has frozen. Its health check now times out after 3s and the Hub is reported as not running- A turn whose connection drops after the model has streamed only reasoning (for example, "The socket connection was closed unexpectedly") is now retried instead of ending the run
- Model requests retry at most 3 times instead of 5
- Kimi K3 now gets
maxreasoning for Extra High and Max, instead of anxhighsetting it rejects - Gemini API keys (the
geminiprovider) no longer send native Google Search. Free-tier keys failed every turn with a 429 quota error on Gemini 3+, and on Gemini 2.x every Cline tool was dropped - Auto-compaction no longer runs for models with an unknown context limit, and it no longer runs again every few tool calls after the first compaction
ask_question: the model keeps going after you pick an option, empty answers are rejected, and an answer with only an attachment countsrun_commandswith an empty command list now returns an error instead of a silent success. On PowerShell, the tool tells the model how quote escaping works and to confirm recursive deletes first- Plugin slash commands run in the active session
- Compiled CLI binaries load plugins and serve the dashboard from resources embedded in the binary
- ACP: the provider and account options now appear under the right config categories
- The skills tool call label no longer shows
nullarguments - Refreshed the model catalog. Adds the Liquid Inference and Munito AI providers and drops CrofAI, iFlow and Llama. The Cline free list adds Reflection Beam, Nemotron 3.5 Lightning and Laguna S 2.1 and drops Mimo V2.6 Flash and Muse Spark 1.3 Contributor. ClinePass now defaults to Kimi K3.1 Pro and adds MiniMax M3.1 Flash and DeepSeek V4.1 Flash 1017. Default models change for 56 other providers, mostly to Kimi K3.1 Pro, MiniMax M3.1 Flash or DeepSeek V4.1 Flash 1017
Full Changelog: https://github.com/cline/cline/compare/cli-v3.0.73...cli-v3.0.74
- sdk/sdk/v0.2.0SDK v0.2.02026-10-26 · 2026-10-26 03:34 UTC
查看更新说明
- Starting a session that already has a run in progress now reattaches to the live session instead of replacing its runtime. Before, the original run kept going but couldn't be reached, and its transcript writes landed on a stale snapshot. A start that includes a prompt while a run is in progress is rejected
- The hub records every client that registered a capability for a session, including clients that join a task that's already running, and sends each request to the first one still connected. If none is left, the request fails quickly with a message the user can act on, instead of waiting forever
- A turn whose connection drops after the model has streamed only reasoning is now retried, and the partial reasoning is discarded. Turns with text, media or tool calls are still never retried
- Model requests retry at most 3 times after the first attempt (down from 5). Failed attempts are recorded in Langfuse traces, and cancelled requests are no longer reported as Langfuse errors
- AI SDK updated to
ai7.0.136 /@ai-sdk/provider-utils5.0.58.maxreasoning now reaches the provider: the gateway no longer turns it intoxhigh, and Kimi K3 getsmaxfor Extra High and Max. Empty Anthropic turns are still retried despite the newanthropic.*custom stream parts - The
geminiprovider no longer sends native Google Search. On Gemini 3+, free-tier keys failed every turn with a 429 quota error, and on Gemini 2.x it dropped every Cline tool. Vertex keeps native search - Auto-compaction no longer runs when the model's input limit is unknown. Manual and overflow-recovery compaction still work
- After the first compaction, the size estimate now uses the messages as they are actually sent, with tool results truncated. Before, it overestimated about 7x and compaction ran again every few tool calls
- Checkpoint diffs read file contents with a single
git cat-file --batchprocess instead of up to twogit showprocesses per file. Workspaces with many untracked files used to spawn thousands of git processes - SSH remotes work behind a ProxyJump alias. The connect budget goes from 10s to 30s, the per-command limit to 60s, and tunnel readiness to 40s. When ssh exits mid-upload, its real error is reported instead of
EPIPE, and aLocalForwardon the alias no longer collides with the tunnel ask_questionanswers are framed so the model keeps going after a bare choice. Empty answers are rejected, and an answer with only an attachment counts as answeredrun_commandsrejects an emptycommandslist with a tool error, and its schema now advertisesminItems: 1- On PowerShell, the
run_commandsdescription explains backtick escaping, single-quoting literal paths, preferring cmdlets overcmd /c, and confirming recursive deletes first - Plugin commands run in the active session runtime and the hub. Plugin watches start working again when discovery directories appear
- Compiled binaries load embedded plugin and dashboard resources straight from the binary, and every declared SDK runtime export is packaged
- A configured
CLINE_PLUGIN_RUNTIME_DIRis resolved to an absolute path - When OpenRouter has no match for a Cline recommended model, its capabilities are filled in from the Vercel catalog
- Desktop cloud session orchestration moved into the hub.
session.listreportsactiveCloudCommands, and the hub isn't replaced while cloud commands are still running - Core adds conversation summaries and cloud continuation support
- Run stall telemetry:
agent.run-finishedandagent.run-failedcarry stall signals from a newRunHealthObserver @cline/uinow ships with the SDK packages on the shared version. It adds aKbdcomponent and token chips for slash commands and file mentions inAgentComposer- Refreshed the model catalog (7,041 → 6,457 models). Adds the Liquid Inference, Munito AI and Munito AI (EU) providers and drops CrofAI, iFlow and Llama. The Cline free list adds Reflection Beam, Nemotron 3.5 Lightning and Laguna
- sdk/sdk/v0.0.95SDK v0.0.952026-10-17 · 2026-10-17 03:00 UTC
查看更新说明
- OpenAI-compatible requests for GPT-6 models (
gpt-6-sol,gpt-6.1-sol,gpt-6-1-sol, and later gpt-5 through gpt-9 ids) sendmax_completion_tokensinstead ofmax_tokens, so OpenAI and Azure no longer reject them. Azure'sgpt-35-turbokeepsmax_tokens - The hub daemon records which client started it (
CLINE_HUB_LAUNCHER_CLIENT,CLINE_HUB_LAUNCHER_VERSION,CLINE_HUB_LAUNCHER_TRANSPORT) and publishes that as OTel resource attributes. SSH remote hubs report the local client with transportssh.@cline/sharedaddswithHubLauncherIdentity,claimHubLauncherIdentityandreadHubLauncherIdentity - The telemetry self-check report includes
traces_exporter - Refreshed the model catalog (6,952 → 7,041 models). Adds the CommandCode and Reflection providers. The Cline recommended list leads with Claude Sonnet 5.5 again, so the
clineprovider's bundled default goes back to Claude Sonnet 5.5 from Gemini 4 Argon. Default models change for 302.AI (Gemini 4 Argon), Eden AI and Prime Inference (Muse Spark Open), CoreWeave (Reflection Beam 1.0), NanoGPT, Pioneer (Nemotron 3.5 Super VL), and Scaleway (DeepSeek V4.1 Flash). OpenCode Go keeps itshttps://opencode.ai/inference/go/v1base URL, now pinned, because models.dev moved its provider-level URL to an OpenAI-only path
Full Changelog: https://github.com/cline/cline/compare/sdk/sdk/v0.0.94...sdk/sdk/v0.0.95
- OpenAI-compatible requests for GPT-6 models (
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
CLI
Run Cline in your terminal. Interactive chat or fully headless for CI/CD and scripting.
npm i -g cline
Learn more
Desktop App
Cline as a native app for macOS and Windows. Run agent sessions in any folder, schedule routines, and manage models, plugins, and MCP servers.
Download for macOS and Windows
VS Code Extension
AI coding assistant in your editor. Create files, run commands, browse the web, and use tools with human-in-the-loop approval.
Install from VS Marketplace
JetBrains Plugin
The same Cline experience in IntelliJ IDEA, PyCharm, WebStorm, GoLand, and the rest of the JetBrains family.
Install from JetBrains Marketplace
SDK
Build your own AI agents and integrations powered by the same engine that runs the CLI, desktop app, VS Code extension, and JetBrains plugin. Custom tools, multi-agent teams, connectors, scheduled automations, and more.
npm install @cline/sdk
Documentation
Index
| Product | Description | Location | CHANGELOG |
|---|---|---|---|
| SDK | Node.js programmatic agent API and extension exports. | sdk/ | CHANGELOG.md |
| CLI | Terminal UI, headless mode, shell commands, and CLI-specific flows. | apps/cli/ | CHANGELOG.md |
| VS Code Extension | The Marketplace extension and extension host integration. | apps/vscode/ | CHANGELOG.md |
| Desktop App | Native macOS and Windows app (Tauri shell, Bun sidecar, Next.js UI). | apps/examples/desktop-app/ | CHANGELOG.md |
| JetBrains Plugin | JetBrains-hosted client that talks to the shared agent core. | Currently we are not open-sourcing JetBrains plugins | - |
| Docs site | Public documentation pages. | docs/ | - |
Edits Code Across Your Project
Cline reads your project structure, understands the relationships between files, and makes coordinated changes across your codebase. It monitors linter and compiler errors as it works, fixing issues like missing imports, type mismatches, and syntax errors before you even see them. In VS Code and JetBrains, every edit shows up as a diff you can review, modify, or revert. All changes are tracked with checkpoints, so you can easily undo the agent's work.
Runs Bash Commands
Cline executes commands directly in your terminal and watches the output in real time. Install packages, run build scripts, execute tests, deploy applications, manage databases. For long-running processes like dev servers, Cline continues working in the background and reacts to new output as it appears, catching compile errors, test failures, and server crashes as they happen.
Plan and Act
Toggle between Plan mode and Act mode. In Plan mode, Cline explores your codebase, asks clarifying questions, and lays out a strategy. Once you're aligned, switch to Act mode and Cline executes the plan. Every file edit and terminal command requires your approval, so you stay in control of what actually changes. Or toggle auto-approve and let Cline run autonomously.
Rules and Skills
Define project-specific rules in .clinerules files that guide how Cline works in your codebase: coding standards, architecture conventions, deployment procedures, testing requirements. Rules are picked up automatically by the CLI, VS Code extension, and JetBrains plugin. Use skills to let the model load specific rules when needed.
Works With Every Model
Cline is not locked to a single AI provider. Use whichever model fits your workflow:
| Provider | Models |
|---|---|
| Anthropic | Claude Opus, Sonnet, Haiku |
| OpenAI | GPT series models |
| Gemini series models | |
| OpenRouter | 200+ models from any provider |
| Vercel AI Gateway | Route to many providers through one gateway |
| AWS Bedrock | Claude, Llama, and more |
| Azure / GCP Vertex | All hosted models |
| Cerebras / Groq | Fast inference models |
| Ollama / LM Studio | Run local models on your machine |
| Any OpenAI-compatible API | Self-hosted or third-party endpoints |
Extend With Plugins or MCP Servers
Extend Cline's capabilities with plugins. Using the SDK, register tools and lifecycle hooks programmatically through the plugin system for logging, auditing, policy enforcement, or adding domain-specific capabilities. Simple plugin example below.
import { Agent, createTool } from "@cline/sdk"
const deployTool = createTool({
name: "deploy",
description: "Deploy the current branch to staging.",
inputSchema: { type: "object", properties: { env: { type: "string" } }, required: ["env"] },
execute: async (input) => {
// your deployment logic
},
})
const agent = new Agent({ tools: [deployTool], /* ... */ })
...or use MCPs to connect to databases, query APIs, manage cloud infrastructure, and interact with external systems. Use community-built servers or ask Cline to create custom tools on the fly. In the CLI, manage servers with cline mcp.
Multi-Agent Teams
Coordinate multiple agents working together on complex tasks. A coordinator agent breaks the work into subtasks and delegates to specialist agents, each with their own tools and context. Team state persists across sessions so you can pick up where you left off.
cline --team-name auth-sprint "Plan and implement user authentication with tests"
Scheduled Agents
Run agents on cron schedules for recurring automations. Daily PR summaries, weekly dependency checks, codebase health reports. Schedules persist across restarts and run independently of any terminal session.
cline schedule create "PR summary" \
--cron "0 9 * * MON-FRI" \
--prompt "List all open PRs and their review status" \
--workspace /path/to/repo
Connect to Slack, Telegram, Discord, and More
Chat with your agent from any messaging platform: Telegram, Slack, Discord, Google Chat, WhatsApp, and Linear. Each conversation thread maps to an agent session with full context. Set up access control to restrict who can interact with your agent.
# Connect to Telegram
cline connect telegram -k $BOT_TOKEN
# Connect to Slack through webhook
cline connect slack --bot-token $SLACK_TOKEN --signing-secret $SECRET --base-url $URL
# Connect to Slack using socket mode
cline connect slack --bot-token $SLACK_TOKEN --app-token $SLACK_APP_TOKEN
Headless CLI for CI/CD
Run Cline with zero interaction for scripting and automation. Pipe input, get JSON output, chain commands, integrate into CI/CD pipelines.
cline "Run tests and fix any failures"
git diff origin/main | cline "Review these changes for issues"
cline --json "List all TODO comments" | jq -r 'select(.type == "agent_event" and .event.text) | .event.text'
Contributing
Start with the Contributing Guide. Join our Discord and head to the #contributors channel to connect with other contributors. Check our careers page for full-time roles.