Installation Tutorial Summary
Creato il: 9 gennaio 2025
Creato il: 9 gennaio 2025
找到以下文本的安装教程,提取出来:
Skip to content
Navigation Menu
Product
Solutions
Resources
Open Source
Enterprise
Pricing
Search or jump to...
Sign in
Sign up
RooVetGit
/
Roo-Cline
Public
forked from cline/cline
Code
Issues
14
Pull requests
9
Discussions
Actions
Projects
Security
Insights
RooVetGit/Roo-Cline
Go to file
This branch is 515 commits ahead of, 116 commits behind cline/cline:main.
Folders and files
Name
Latest commit
mrubens
mrubens
Merge pull request #300 from RooVetGit/changeset-release/main
f12c342
·
13 hours ago
History
.changeset
changeset version bump
13 hours ago
.github
Fixes when pushing the changelog forced format
2 weeks ago
.husky
Updating husky hook and adding lint-staged
last month
.vscode
Chore: Prettier for consistant formatting (cline#794)
2 months ago
assets
Update metadata (#29)
2 months ago
audio
Play sound effects for notifications and events (#38)
last month
src
Add test
yesterday
webview-ui
Disable the API config dropdown in sync with the chat textarea
yesterday
.clinerules
Remove eslint-disable, forbid it in .clinerules
2 weeks ago
.eslintrc.json
Chore: Prettier for consistant formatting (cline#794)
2 months ago
.gitattributes
Add new demo
3 months ago
.gitignore
Set up vscode integration test
5 days ago
.npmrc
Adding basic npmrc file to avoid code artifact issues
last month
.nvmrc
Add .nvmrc, .prettierignore, icon; Remove vsc quickstart guide
6 months ago
.prettierignore
Chore: Prettier for consistant formatting (cline#794)
2 months ago
.prettierrc.json
Chore: Prettier for consistant formatting (cline#794)
2 months ago
.vscode-test.mjs
Set up vscode integration test
5 days ago
.vscodeignore
Refactor assets
3 months ago
CHANGELOG.md
Updating CHANGELOG.md format
13 hours ago
LICENSE
Update LICENSE
3 months ago
README.md
Release
yesterday
ellipsis.yaml
Updating readme and ellipsis yaml
last month
esbuild.js
Replace token estimation with using last API response token usage
5 months ago
jest.config.js
Use jest-simple-dot-reporter to cut down on test noise
yesterday
package-lock.json
changeset version bump
13 hours ago
package.json
changeset version bump
13 hours ago
tsconfig.json
GHA fixes
3 weeks ago
Repository files navigation
README
License
Roo-Cline
A fork of Cline, an autonomous coding agent, with some additional experimental features. It’s been mainly writing itself recently, with a light touch of human guidance here and there.
Experimental Features
Drag and drop images into chats
Delete messages from chats
@-mention Git commits to include their context in the chat
Save different API configurations to quickly switch between providers and settings
"Enhance prompt" button (OpenRouter models only for now)
Sound effects for feedback
Option to use browsers of different sizes and adjust screenshot quality
Quick prompt copying from history
OpenRouter compression support
Includes current time in the system prompt
Uses a file system watcher to more reliably watch for file system changes
Language selection for Cline's communication (English, Japanese, Spanish, French, German, and more)
Support for DeepSeek V3
Support for Amazon Nova and Meta 3, 3.1, and 3.2 models via AWS Bedrock
Support for Glama
Support for listing models from OpenAI-compatible providers
Support for adding OpenAI-compatible models with or without streaming
Per-tool MCP auto-approval
Enable/disable individual MCP servers
Enable/disable the MCP feature overall
Automatically retry failed API requests with a configurable delay
Configurable delay after auto-writes to allow diagnostics to detect potential problems
Control the number of terminal output lines to pass to the model when executing commands
Runs alongside the original Cline
Disclaimer
Please note that Roo Veterinary, Inc does not make any representations or warranties regarding any code, models, or other tools provided or made available in connection with Roo-Cline, any associated third-party tools, or any resulting outputs. You assume all risks associated with the use of any such tools or outputs; such tools are provided on an "AS IS" and "AS AVAILABLE" basis. Such risks may include, without limitation, intellectual property infringement, cyber vulnerabilities or attacks, bias, inaccuracies, errors, defects, viruses, downtime, property loss or damage, and/or personal injury. You are solely responsible for your use of any such tools or outputs (including, without limitation, the legality, appropriateness, and results thereof).
Demo
Here's an example of Roo-Cline autonomously creating a snake game with "Always approve write operations" and "Always approve browser actions" turned on:
Screen.Recording.2024-12-07.at.5.35.37.PM.mov
Contributing
To contribute to the project, start by exploring open issues or checking our feature request board. We'd also love to have you join our Discord to share ideas and connect with other contributors.
Local Setup
Publishing
Cline (prev. Claude Dev) – #1 on OpenRouter
Download on VS Marketplace Join the Discord Feature Requests We're Hiring!
Meet Cline, an AI assistant that can use your CLI aNd Editor.
Thanks to Claude 3.5 Sonnet's agentic coding capabilities, Cline can handle complex software development tasks step-by-step. With tools that let him create & edit files, explore large projects, use the browser, and execute terminal commands (after you grant permission), he can assist you in ways that go beyond code completion or tech support. Cline can even use the Model Context Protocol (MCP) to create new tools and extend his own capabilities. While autonomous AI scripts traditionally run in sandboxed environments, this extension provides a human-in-the-loop GUI to approve every file change and terminal command, providing a safe and accessible way to explore the potential of agentic AI.
Enter your task and add images to convert mockups into functional apps or fix bugs with screenshots.
Cline starts by analyzing your file structure & source code ASTs, running regex searches, and reading relevant files to get up to speed in existing projects. By carefully managing what information is added to context, Cline can provide valuable assistance even for large, complex projects without overwhelming the context window.
Once Cline has the information he needs, he can:
Create and edit files + monitor linter/compiler errors along the way, letting him proactively fix issues like missing imports and syntax errors on his own.
Execute commands directly in your terminal and monitor their output as he works, letting him e.g., react to dev server issues after editing a file.
For web development tasks, Cline can launch the site in a headless browser, click, type, scroll, and capture screenshots + console logs, allowing him to fix runtime errors and visual bugs.
When a task is completed, Cline will present the result to you with a terminal command like open -a "Google Chrome" index.html, which you run with a click of a button.
Tip
Use the CMD/CTRL + Shift + P shortcut to open the command palette and type "Cline: Open In New Tab" to open the extension as a tab in your editor. This lets you use Cline side-by-side with your file explorer, and see how he changes your workspace more clearly.
Use any API and Model
Cline supports API providers like OpenRouter, Anthropic, Glama, OpenAI, Google Gemini, AWS Bedrock, Azure, and GCP Vertex. You can also configure any OpenAI compatible API, or use a local model through LM Studio/Ollama. If you're using OpenRouter, the extension fetches their latest model list, allowing you to use the newest models as soon as they're available.
The extension also keeps track of total tokens and API usage cost for the entire task loop and individual requests, keeping you informed of spend every step of the way.
Run Commands in Terminal
Thanks to the new shell integration updates in VSCode v1.93, Cline can execute commands directly in your terminal and receive the output. This allows him to perform a wide range of tasks, from installing packages and running build scripts to deploying applications, managing databases, and executing tests, all while adapting to your dev environment & toolchain to get the job done right.
For long running processes like dev servers, use the "Proceed While Running" button to let Cline continue in the task while the command runs in the background. As Cline works he’ll be notified of any new terminal output along the way, letting him react to issues that may come up, such as compile-time errors when editing files.
Create and Edit Files
Cline can create and edit files directly in your editor, presenting you a diff view of the changes. You can edit or revert Cline's changes directly in the diff view editor, or provide feedback in chat until you're satisfied with the result. Cline also monitors linter/compiler errors (missing imports, syntax errors, etc.) so he can fix issues that come up along the way on his own.
All changes made by Cline are recorded in your file's Timeline, providing an easy way to track and revert modifications if needed.
Use the Browser
With Claude 3.5 Sonnet's new Computer Use capability, Cline can launch a browser, click elements, type text, and scroll, capturing screenshots and console logs at each step. This allows for interactive debugging, end-to-end testing, and even general web use! This gives him autonomy to fixing visual bugs and runtime issues without you needing to handhold and copy-pasting error logs yourself.
Try asking Cline to "test the app", and watch as he runs a command like npm run dev, launches your locally running dev server in a browser, and performs a series of tests to confirm that everything works. See a demo here.
"add a tool that..."
Thanks to the Model Context Protocol, Cline can extend his capabilities through custom tools. While you can use community-made servers, Cline can instead create and install tools tailored to your specific workflow. Just ask Cline to "add a tool" and he will handle everything, from creating a new MCP server to installing it into the extension. These custom tools then become part of Cline's toolkit, ready to use in future tasks.
"add a tool that fetches Jira tickets": Retrieve ticket ACs and put Cline to work
"add a tool that manages AWS EC2s": Check server metrics and scale instances up or down
"add a tool that pulls the latest PagerDuty incidents": Fetch details and ask Cline to fix bugs
Add Context
@url: Paste in a URL for the extension to fetch and convert to markdown, useful when you want to give Cline the latest docs
@problems: Add workspace errors and warnings ('Problems' panel) for Cline to fix
@file: Adds a file's contents so you don't have to waste API requests approving read file (+ type to search files)
@folder: Adds folder's files all at once to speed up your workflow even more
Contributing
To contribute to the project, start by exploring open issues or checking our feature request board. We'd also love to have you join our Discord to share ideas and connect with other contributors. If you're interested in joining the team, check out our careers page!
Local Development Instructions
License
Apache 2.0 © 2024 Cline Bot Inc.
About
Autonomous coding agent right in your IDE, capable of creating/editing files, executing commands, using the browser, and more with your permission every step of the way.
marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline
Resources
Readme
License
Apache-2.0 license
Activity
Custom properties
Stars
2.2k stars
Watchers
36 watching
Forks
166 forks
Report repository
Releases
No releases published
Packages
No packages published
Languages
TypeScript
98.0%
JavaScript
1.5%
Other
0.5%
Footer
© 2025 GitHub, Inc.
Footer navigation
Terms
Privacy
Security
Status
Docs
Contact
Manage cookies
Do not share my personal information
以下是原文中与安装教程最相关、可视为“安装步骤”或“使用前准备”的部分内容节选和说明。由于文档中并没有以「Installation」或「Install」为标题的分步式教程,所以以下内容主要是从「Local Setup」「Publishing」「Download on VS Marketplace」等章节或提示中整理出的“安装/使用”指引。
原文中提到:
Cline (prev. Claude Dev) – #1 on OpenRouter
Download on VS Marketplace Join the Discord Feature Requests We're Hiring!
从上述提示可以推断,最简单的方式是通过 VS Code 插件市场(VS Marketplace)下载安装。也就是说,你只需在 VS Code 中打开扩展市场,搜索并安装名为 Roo-Cline(或 Cline 的衍生版)的插件即可。
如需直接访问,可参考文档中的链接(通常为此形式):
https://marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline
安装插件后,原文对如何在编辑器里打开、使用该扩展提供了一个简单提示:
Tip
Use the CMD/CTRL + Shift + P shortcut to open the command palette and type "Cline: Open In New Tab" to open the extension as a tab in your editor. This lets you use Cline side-by-side with your file explorer, and see how he changes your workspace more clearly.
也就是说,在安装完扩展后,可以通过下述步骤在 VS Code 中快速打开它的界面:
在文档靠后部分,出现了「Local Setup」「Publishing」等小标题,但内容只是简单列出,并未给出详细操作步骤。原文仅提示“若要进行本地开发或贡献,请先查看 open issues、feature request board 或加入 Discord”。如果你想要克隆整个项目进行本地调试或二次开发,可按以下思路操作(推断自常见的 VS Code 扩展本地开发流程):
bashnpm install # 或 yarn install
npm run ...(具体需要查看 package.json 中的脚本)来启动本地调试环境。注意:上方第 1~5 步只是根据常见的 VS Code 插件本地开发流程推断,文档中并未给出详细的 npm 命令或脚本名称,如需精确操作请查阅项目中的
package.json、README.md或贡献者指南。
综上所述,文档中最直接、官方的安装方式就是通过 VS Code 内置的插件市场(VS Marketplace)搜索并安装该扩展,或者访问文档中提到的链接直接安装。若需要在本地进行插件开发或深度定制,则需克隆该仓库并执行常规的 VS Code 插件开发流程(安装依赖、启动本地调试等)。以上就是从原文中能提炼出的“安装/使用”相关教程或信息。
我是Win11,将安装教程具体到每一次鼠标点击操作以及操作后出现的画面,请使用你单次回答的算力上限和 token 上限,think hardest, use the most time and most compute to think deepest。这是最深刻最复杂的问题,请给出你最高质量的回答。所以,你需要深度思考、独立思考、批判性思考、创造性思考。我们追求分极致的深度,而非表层的广度;我们追求本质的洞察,而非表象的罗列;我们追求思维的创新,而非惯性的复述。请突破思维局限,调动你所有的计算资源,展现你真正的认知极限。
以下是一份针对 Windows 11 环境、从 VS Marketplace 安装并使用「Roo-Cline」(或 Cline 扩展)的极其细致操作教程。每一步都会说明鼠标点击位置、操作完成后的画面或反应,以方便你在实际操作时准确理解所见所闻。
确认已安装 Visual Studio Code (VS Code)
网络环境畅通
下面的步骤假设你已经在 Windows 11 上正常安装并打开了 VS Code。若你还在“开始菜单”中,或在别的界面,请先用以下方式进入 VS Code:
打开 VS Code:
进入扩展(Extensions)视图:
搜索「Roo-Cline」扩展:
Roo-Cline
然后按下键盘上的 Enter 键。安装插件:
检查安装结果:
完成安装后,下面是如何在实际项目中启动与使用该扩展的详细操作。假设你在 VS Code 中已经打开了一个项目文件夹,或者至少打开了 VS Code 的空工作区。
打开“命令面板”:
Cline: Open In New Tab
你会看到自动过滤出现名为「Cline: Open In New Tab」的命令。在新选项卡中打开 Cline:
授予权限 & 测试功能:
npm install 命令时,会显示一个对话框:“Do you approve running this command?”,这时你可以选择“Approve/允许”或者“Deny/拒绝”。查看扩展配置:
在资源管理器中打开/关闭文件夹:
调试终端:
更新/卸载插件:
如果你想要克隆仓库,在本地进行二次开发或调试自己的「Roo-Cline」分支,那么可参照以下流程(与一般 VS Code 插件开发流程类似):
克隆或下载项目:
RooVetGit/Roo-Cline 仓库。git clone 命令克隆到本地。安装依赖:
bashnpm install # 或者 yarn install
进入扩展调试模式:
查看调试日志与测试功能:
“Reload Required”(需要重新加载)弹窗:
安装扩展后如果出现此提示,点「Reload」后 VS Code 将会自动重新启动以生效。
“Approve / Deny”对话框:
当 Cline 请求执行命令或修改文件时,你会看到一个交互式弹窗,保证你对 Cline 的动作有完全的掌控。
“Installing…”状态栏信息:
在安装扩展期间,VS Code 的状态栏(默认在最下方)可能会显示「Installing…」并带有一个进度加载动画。
“Cannot find extension”等错误
如果插件无法找到或下载,请检查网络连接或重启 VS Code 再试。也可尝试在 VS Code 的「View -> Output」选择「Log (Extension Host)」查看详细日志。
通过上述操作,你就能在 Windows 11 上将「Roo-Cline」扩展安装到 VS Code,并使用其强大的自主编程协助和工具整合能力。在此过程中,每一次鼠标点击以及各个弹窗都可帮助你明确地知道当前系统或 VS Code 的反馈。
如果你在安装、使用或本地开发时遇到更深入或独特的需求,欢迎在其官方社区或 Discord 进行反馈,也可以在 GitHub 提 issue、查看已有的开源文档来获取更多帮助。祝你开发顺利、玩得开心!
输入Cline: Open In New Tab后,出现的Tab内容如下:
Hi, I'm Cline
I can do all kinds of tasks thanks to the latest breakthroughs in agentic coding capabilities and access to tools that let me create & edit files, explore complex projects, use the browser, and execute terminal commands (with your permission, of course). I can even use MCP to create new tools and extend my own capabilities.
To get started, this extension needs an API provider.
API Provider
Get OpenRouter API Key
This key is stored locally and only used to make API requests from this extension.
Model
anthropic/claude-3.5-sonnet:beta
The new Claude 3.5 Sonnet delivers better-than-Opus capabilities, faster-than-Sonnet speeds, at the same Sonnet prices. Sonnet is particularly good at:
Coding: New Sonnet scores ~49% on SWE-Bench Verified, higher than the last best score, and without any fancy prompt scaffolding
Data science: Augments human data science expertise; navigates unstructured data while using multiple tools for insights
Visual processing: excelling at interpreting charts, graphs, and images, accurately transcribing text to derive insights beyond just the text alone
Agentic tasks: exceptional tool use, making it great at agentic tasks (i.e. complex, multi-step problem solving tasks that require engaging with other systems)
#multimodal
This is a faster endpoint, made available in collaboration with Anthropic, that is self-moderated: response moderation happens on the provider's side instead of OpenRouter's. For requests that pass moderation, it's identical to the Standard variant.
See more
Supports images
Supports computer use
Supports prompt caching
Max output: 8,192 tokens
Input price: 3.75/million tokens
Cache reads price: 15.00/million tokens
Let's go!
接下来怎么操作,具体到每一次鼠标点击操作以及操作后出现的画面,请使用你单次回答的算力上限和 token 上限,think hardest, use the most time and most compute to think deepest。这是最深刻最复杂的问题,请给出你最高质量的回答。所以,你需要深度思考、独立思考、批判性思考、创造性思考。我们追求分极致的深度,而非表层的广度;我们追求本质的洞察,而非表象的罗列;我们追求思维的创新,而非惯性的复述。请突破思维局限,调动你所有的计算资源,展现你真正的认知极限。
以下是一份针对你在 Windows 11 中使用 VS Code 打开「Roo-Cline」扩展后,所见到的界面(包含「Hi, I’m Cline...」「API Provider」「Model」以及「Let’s go!」按钮等)时,下一步具体操作的极其详细说明。每个步骤都会说明你需要怎么点击、在何处点击,以及点击后画面将如何变化,帮助你准确无误地完成扩展初始化配置与后续操作。
当你输入 Cline: Open In New Tab 后,出现的选项卡(Tab)大致包含以下内容:
textHi, I'm Cline I can do all kinds of tasks thanks to ...
anthropic/claude-3.5-sonnet:beta此时 Cline 需要一个 API Key,才能正式调用后端模型 API。以下是更进一步的操作说明。
由于 Cline 是基于云端的模型(如 OpenRouter、Anthropic、OpenAI 等),所以你需要一个 API Key 来使用远程服务。下面的操作主要是指导你如何获得并填写这个 Key。
在“Cline: Open In New Tab”界面中,找到「API Provider」字段
"To get started, this extension needs an API provider. API Provider. Get OpenRouter API Key..."
单击“Get OpenRouter API Key”按钮(或链接)
在浏览器中注册/登录并获取 API Key
or-live-xxxxx... 之类的 Key。回到 VS Code 界面,粘贴 API Key
Ctrl + V)将你的 API Key 粘贴进去。当前模型信息
textanthropic/claude-3.5-sonnet:beta ...
切换到其他模型(若需要)
anthropic/claude-instant、openai/gpt-4 等),通常可以在此区域找到一个下拉菜单或 “Model” 按钮。提示:由于 Sonnet 可能是最新最强的模式(也许带有多模态能力),你可以直接保留默认选择,不做任何更改。
在完成了 API Key 配置(和可选的模型选择)后,你就可以正式开始使用 Cline 的能力。接下来执行:
单击「Let’s go!」按钮
等待初始化完成
当你看到一个聊天对话区域,类似以下内容时:
Cline: Hello! I'm all set. How can I help you today?
就表示 Cline 已正式就绪。你可以执行的常见操作包括:
输入命令/任务
授权文件修改
授权终端命令
npm install、git commit 等命令时,也会出现一个 Approval 弹窗。浏览器操作
“Missing API Key”
“Invalid Key”
“Approved” / “Denied”
“Reload Required”
anthropic/claude-3.5-sonnet:beta 具有多模态与更强的推理能力,是一个不错的起点。至此,你已经完成了从在 VS Code 中打开 Roo-Cline、获取并填写 API Key、选择模型、到正式启动所需的一系列步骤。祝你在使用 Cline 协助开发或其他创造性工作时一切顺利!
我输入APIKEY之后显示以下信息,是不是已经可以了:
🎉 New in Cline v2.2
Add custom tools to Cline using MCP!
The Model Context Protocol allows agents like Cline to plug and play custom tools, e.g. a web-search tool or GitHub tool.
You can add and configure MCP servers by clicking the new icon in the menu bar.
To take things a step further, Cline also has the ability to create custom tools for himself. Just say "add a tool that..." and watch as he builds and installs new capabilities specific to your workflow. For example:
"...fetches Jira tickets": Get ticket ACs and put Cline to work
"...manages AWS EC2s": Check server metrics and scale up or down
"...pulls PagerDuty incidents": Pulls details to help Cline fix bugs
Cline handles everything from creating the MCP server to installing it in the extension, ready to use in future tasks. The servers are saved to ~/Documents/Cline/MCP so you can easily share them with others too.
Try it yourself by asking Cline to "add a tool that gets the latest npm docs", or see a demo of MCP in action here.
Join discord.gg/cline for more updates!
What can I do for you?
Thanks to the latest breakthroughs in agentic coding capabilities, I can handle complex software development tasks step-by-step. With tools that let me create & edit files, explore complex projects, use the browser, and execute terminal commands (after you grant permission), I can assist you in ways that go beyond code completion or tech support. I can even use MCP to create new tools and extend my own capabilities.
下面是一份极其详细的说明,告诉你当你在「Cline: Open In New Tab」的界面中输入了 API Key,并看到了「New in Cline v2.2 …」的欢迎信息后,究竟意味着什么、是否说明已经完成安装、以及接下来可以做些什么。
成功获取并保存了 API Key
提示“New in Cline v2.2 Add custom tools to Cline using MCP!”
“What can I do for you?”
简言之:如果你能看到“New in Cline v2.2…”并且 Cline 在说“What can I do for you?”,那就代表——Cline 已经就绪。下一步,你可以开始让它为你执行各种编程或自动化任务了。
如果想进一步确认当前的配置是否完整、Cline 是否能够正常调用 API,可以留意以下几点:
查看顶部或界面上的 API 提示
查看扩展的设置
尝试简单请求
Hello Cline, can you tell me the current date?
现在你已经确认了 Cline 安装和配置完毕,下面是一些常见操作示例,帮助你进一步体验 Cline 的强大功能。
让 Cline 检测并修复项目中的问题
Could you scan my project for any obvious errors or improvements?
让 Cline 创建或编辑文件
Please create a new file named "hello.ts" with a simple TypeScript function to say hello.
hello.ts 并添加一些 TypeScript 代码;你可以在对话框中点 “Approve” 来确定文件的创建。执行终端命令
Please run "npm install" to install dependencies.
npm install 时,会弹出一个对话框,让你选择“Approve”或“Deny”。点击 “Approve” 后,VS Code 集成终端会显示实际安装过程。使用 MCP 来添加自定义工具
Add a tool that fetches Jira tickets.
在浏览器中进行自动化交互
npm run dev),再指令它“在浏览器中打开本地地址并点击某个按钮”,Cline 会弹出对话框请求你同意使用浏览器自动化。“What can I do for you?”
“Awaiting user approval for file write/terminal command/browser usage”
Diff 视图
“Add a tool that...”
错误提示
借助这些步骤与说明,你可以放心地展开对 Cline 各种功能的探索,享受这款agentic coding利器为你的开发和创意工作带来的高效与惊喜。祝你使用愉快,若有任何疑问或进阶需求,也可随时在官方社区或 Discord 获得更多帮助。