如何使用 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,步骤见 如何创建与加入房间。

装扩展APICode 模式 · 首任务

模式各解决什么

Code 模式

日常改文件、跑终端、多步任务;适合首个可批准 diff 的编码作业。

Architect / Ask / Debug

Architect 偏规划与迁移;Ask 快速问答;Debug 追日志与根因。还可建 Custom Modes 约束团队流程。

BYOK自带 API 密钥
ModesCode · Architect · Ask
MCP可接 MCP 服务器
目标入口第一次怎么验收
连上模型活动栏 Roo Code → 欢迎页 Provider选 OpenRouter 或 Anthropic → 粘贴密钥 → 选 Sonnet 类模型
只读摸底Ask 模式 + @ 文件问「这个模块做什么」— 先不要改代码
首个改动Code 模式补一行 README 或 docstring → 逐条 Approve
规划大改Architect 模式列出步骤后再切 Code 执行

安装、Provider、第一个 Code 任务

  1. 01
    安装 VS Code 扩展

    扩展视图 Cmd+Shift+X 搜索 Roo Code,选发布者 RooVeterinaryInc → Install。Quick Open:ext install RooVeterinaryInc.roo-cline。Reload 后活动栏应出现 Roo Code 图标。

  2. 02
    连接 API Provider

    打开 Roo Code 面板 → 欢迎屏选 Provider(文档推荐 OpenRouter 或 Anthropic)→ 粘贴 API 密钥 → 选推理模型(如文档示例 claude-sonnet-4-5 或 OpenRouter 上的等价 ID)。勿把密钥提交进 git。

  3. 03
    打开文件夹并 Ask 摸底

    File → Open Folder 打开完整仓库(非单文件)。切 Ask,用 @file 问只读问题,确认上下文正常。

  4. 04
    Code 模式完成首任务

    切 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 整个仓库。

开始画