wbmeet

如何在 VS Code 安装并使用 Roo Code：扩展、接模型、第一个任务

安装 Roo Code 扩展、接入供应商模型，再在自己的仓库落地第一个可审查的代理改动。

第一次用 Roo Code，卡住的通常不是提示词，而是扩展有没有装对、有没有接入模型，以及仓库里第一件能审查的事。从市场装官方发布者的扩展，在设置里接好密钥，再改一行你自己能回滚的代码。

检索词是 如何在 VS Code 安装并使用 Roo Code。下文对照归档安装与供应商说明：docs.roocode.com、roocodeinc.github.io/Roo-Code、市场项 rooveterinaryinc.roo-cline。这是 VS Code 里的代理扩展，不是本站会议产品。要约短会对齐 diff，用 wbmeet 建房即可，步骤见 如何创建与加入房间。

安装扩展接入模型第一个代理任务

先核对你装的是什么

Roo Code 是 VS Code 扩展里的编程代理：读文件、改代码、跑终端、按需用 MCP。扩展本身开源免费；推理走你自己的供应商密钥（OpenRouter、Anthropic、OpenAI、Gemini、DeepSeek 等）或本机 Ollama / LM Studio。官方要求 VS Code 1.84.0 及以上。发布者是 RooVeterinaryInc，扩展 id 为 rooveterinaryinc.roo-cline。

VS Code
扩展装进现有编辑器
1 key
供应商 API 密钥或本机模型
4 modes
Code / Architect / Ask / Debug

第一次：安装、接模型、改一行能审查的代码

  1. 1

    从市场安装扩展

    打开 VS Code，Cmd+Shift+X（macOS）或 Ctrl+Shift+X（Windows/Linux）。搜 Roo Code，选发布者 RooVeterinaryInc，安装。提示时重载。找不到市场时用 Open VSX，或从 GitHub RooCodeInc/Roo-Code Releases 下 .vsix，扩展视图「…」→ Install from VSIX。不要从不明镜像装。

  2. 2

    在设置里接入一个模型

    活动栏打开 Roo 面板，点齿轮。API Provider 选一家（常见：OpenRouter、Anthropic、OpenAI、Google Gemini、DeepSeek）。把密钥贴进对应字段，再选模型。本机模型选 Ollama 或 LM Studio。密钥存在 VS Code Secret Storage。没有密钥时聊天发不出去。

  3. 3

    打开自己的仓库

    File → Open Folder，选你拥有、能回滚的项目。不要对生产密钥目录做第一次实验。

  4. 4

    开聊天并给可审查任务

    输入框上方选 Code 模式（规划用 Architect，只问用 Ask，排错用 Debug，也可用 / 切换）。先问「这个项目做什么、入口在哪」，再：「给一个没测试的辅助函数补单测，或给对外函数加输入校验。先出示 diff，等我批准。」用 @ 点名文件。每一步工具调用先批准。不要把密钥写进提示，不要盲目开自动批准命令。

# First hour · Roo Code in VS Code · as of 2026-09
# 1. Extensions → search Roo Code (publisher RooVeterinaryInc)
#    id: rooveterinaryinc.roo-cline   VS Code 1.84.0+
# 2. Activity Bar → Roo panel → gear → API Provider
#    Paste a key (OpenRouter / Anthropic / OpenAI / Gemini / …)
#    or Ollama / LM Studio for a local model
# 3. Open a repo you own. Code mode. Chat:
#    "Add a unit test for one untested helper; show the diff and wait."
# Approve each tool use. Do not paste secrets.

安装、供应商、常见坑

路径官方怎么写第一次注意
市场安装RooVeterinaryInc / Marketplace 或 Open VSX核对发布者，不要装错扩展
VSIXGitHub Releases 的 .vsix市场下架时用归档包
接模型齿轮 → API Provider + 密钥扩展免费，推理按供应商计费
模式Code / Architect / Ask / Debug改代码先确认 Code
工具调用读改文件、跑命令需批准自动批准命令要极谨慎
01

面板没反应

多半是密钥错了、过期，或供应商宕机。核对密钥与网络，看 View → Output 里的 Roo Code，再重开 VS Code。

02

市场搜不到

官方扩展已停更。用 Open VSX、最后一版 VSIX，或改用 ZooCode / Cline。VS Code 需 1.84.0+。

03

第一任务停在闲聊

问「项目做什么」只是热身。要有一条可审查改动，并在批准前看 diff。

归档安装说明：市场搜 Roo Code（RooVeterinaryInc），重载后在活动栏打开面板。供应商页：齿轮里选 API Provider、贴密钥、选模型。命令与额度以供应商当下文档为准。

扩展免费 ≠ 模型免费
扩展开源。Anthropic / OpenAI / OpenRouter 等按 token 收费。本机 Ollama / LM Studio 可不走云端账单。
批准每一步
代理会读文件、改文件、跑终端。默认先问你。自动批准命令风险高。
教程页不是会议说明书
只讲 Roo Code 第一次。短会白板见 wbmeet 与 对照笔记。

还想核对的问题

一定要付费才能跑代理吗？

扩展免费。云端模型通常要供应商账号与密钥，按用量计费。本机 Ollama / LM Studio 可离线试，能力取决于你拉下来的模型。

官方扩展停了还能装吗？

能装最后一版（市场若仍列出，或 GitHub Releases 的 VSIX）。不会再有官方更新。新功能看 ZooCode 或 Cline，并以它们的文档为准。

密钥贴到哪里？

Roo 面板齿轮 → API Provider。选 OpenRouter、Anthropic、OpenAI、Gemini 等，贴进对应密钥框再选模型。密钥进 Secret Storage，不要写进仓库。

第一个任务必须改生产代码吗？

不必。先问项目做什么，再做可回滚的小事（单测或校验），并先看 diff。拒绝不想要的工具调用。

免费开始开会