如何使用 Roo Code 在 VS Code:安装扩展、配置 API Provider 与首个编码任务
安装 Roo Code、配置 API Provider,Ask 只读摸底后在 Code 模式批准第一个 docstring 或 README 级改动。
要在 VS Code 里用 Roo Code 跑第一个编码任务,先完成四步:Marketplace 安装 Roo Code 扩展、在欢迎页连接 LLM Provider 并填 API 密钥、用 Code 模式打开文件夹工作区,再批准首个可审查的小改动。
对照 docs.roocode.com/getting-started/installing 与 docs.roocode.com/getting-started/connecting-api-provider,以及 Marketplace 项 Roo Code(RooVeterinaryInc.roo-cline)。检索词 Roo Code VS Code 安装、Roo Code API Provider 配置。2026-05-15 起官方已停止维护扩展(最终版仍可能可用);长期方案见 Cline。这是 Roo Code 产品,不是本站会议工具。短会见 sitdraw,步骤见 如何创建与加入房间。
模式各解决什么
Code 模式
日常改文件、跑终端、多步任务;适合首个可批准 diff 的编码作业。
Architect / Ask / Debug
Architect 偏规划与迁移;Ask 快速问答;Debug 追日志与根因。还可建 Custom Modes 约束团队流程。
| 目标 | 入口 | 第一次怎么验收 |
|---|---|---|
| 连上模型 | 活动栏 Roo Code → 欢迎页 Provider | 选 OpenRouter 或 Anthropic → 粘贴密钥 → 选 Sonnet 类模型 |
| 只读摸底 | Ask 模式 + @ 文件 | 问「这个模块做什么」— 先不要改代码 |
| 首个改动 | Code 模式 | 补一行 README 或 docstring → 逐条 Approve |
| 规划大改 | Architect 模式 | 列出步骤后再切 Code 执行 |
安装、Provider、第一个 Code 任务
- 01安装 VS Code 扩展
扩展视图
Cmd+Shift+X搜索Roo Code,选发布者 RooVeterinaryInc → Install。Quick Open:ext install RooVeterinaryInc.roo-cline。Reload 后活动栏应出现 Roo Code 图标。 - 02连接 API Provider
打开 Roo Code 面板 → 欢迎屏选 Provider(文档推荐 OpenRouter 或 Anthropic)→ 粘贴 API 密钥 → 选推理模型(如文档示例
claude-sonnet-4-5或 OpenRouter 上的等价 ID)。勿把密钥提交进 git。 - 03打开文件夹并 Ask 摸底
File → Open Folder 打开完整仓库(非单文件)。切 Ask,用
@file问只读问题,确认上下文正常。 - 04Code 模式完成首任务
切 Code,描述小任务(例如「给这个函数补 docstring,不改行为」)。审阅 proposed diff 与终端命令,逐条 Approve,最后
git diff核对。
# First hour · Roo Code · VS Code · 2026-10-15
# 1. ext install RooVeterinaryInc.roo-cline
# 2. Roo panel → Provider + API key + model
# 3. Open Folder → Ask @file read-only question
# 4. Code mode → small docstring → Approve diffs
# Docs: docs.roocode.com/getting-started/installing
# Marketplace: marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline- 和 Cline 什么关系?
- Roo Code 源自 Cline 分支;维护状态以官方公告为准。对照本站 Cline 教程。
- Provider 报错或 401?
- 检查密钥未过期、模型 ID 拼写、公司代理是否拦截 API。Reload Window;Remote SSH 需出站 HTTPS。
- Roo Code Router 还能用吗?
- 官方已随扩展停更而结束 Router;请改用 Anthropic、OpenRouter、OpenAI 等 BYOK Provider。
- 装完能当架构白板吗?
- 不能。要对齐服务边界图时开 sitdraw 或看 临时会议工具对照。
先 Provider,再 Code 任务
多数空回复是未配置 API 或未 Open Folder 整个仓库。