从零跑通 Roo CodeAI 编程助手本地部署与配置完整指南【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code装完一个 AI 编程插件你多半遇到过这几个瞬间命令跑完不知道有没有成功、面板里找不到入口、想改行为却不知道改哪里。Roo Code 是把一整支 AI Agent 团队编码、架构、调试、问答多种模式塞进 VS Code 的开源扩展本地部署后你可以完全掌控它的运行方式和配置。跟着这份指南你会拉取源码、一键构建 VSIX 包、把扩展装进 VS Code并学会两处最实用的自定义配置——全程大约 15 分钟不需要专业开发背景。部署前置检查清单动手前花一分钟核对下面的清单能避开 90% 的装不上问题项目要求说明操作系统Windows 10/11、macOS 12、LinuxUbuntu 20.04三大平台均可硬件建议 8GB 内存、5GB 可用磁盘依赖体积较大Node.js20.19.2项目锁定此版本用.nvmrc声明pnpm10.xpnpm10.8.1项目指定的包管理器Git任意近期版本用于克隆源码VS Code≥ 1.84.0扩展声明的最低版本不满足怎么办Node 和 pnpm 都有跨平台安装脚本版本管理器如 nvm一条命令就能切到 20.19.2磁盘不足 5GB 时建议先清理依赖安装 构建产物大约占用几个 GB。快速上手五个动作跑通部署拉取代码打开终端执行下面这条把源码克隆到本地git clone https://gitcode.com/GitHub_Trending/ro/Roo-Code cd Roo-Code这一步只获取代码不做任何安装。完成后你应该看到本地多了一个Roo-Code目录里面有src/、webview-ui/、pnpm-workspace.yaml等文件。安装依赖进入项目目录后用 pnpm 安装全部依赖这是项目里体积最大的一步pnpm install它会按 monorepo 结构安装根目录、src、webview-ui等所有子包的依赖首次运行需要几分钟。完成后你应该看到node_modules目录出现且终端没有报错退出。装依赖偏慢时可以先换镜像源再装pnpm config set registry https://registry.npmmirror.com。构建并安装 VSIX 扩展包项目内置了构建 安装一条龙脚本这是推荐方式适合所有新手pnpm install:vsix这条命令会依次执行锁定版本装依赖 → 清理旧产物 → 构建 VSIX 包 → 调用 scripts/install-vsix.js 先卸载旧版本再安装新包。中途它会问你用哪个编辑器命令code/cursor/code-insiders直接回车用默认的code即可只想跳过确认时可以加-y参数一把梭。完成后你应该看到终端输出✅ Successfully installed extension并提示需要重启 VS Code。如果你想要更多控制比如只构建、自己决定何时装用手动方式适合想排查构建环节的人pnpm vsix构建成功后bin/目录下会出现roo-cline-3.53.0.vix之类的 VSIX 文件版本号以实际构建为准然后用编辑器命令手动安装code --install-extension bin/roo-cline-3.53.0.vsix装完重启 VS Code你应该能在侧边栏活动栏看到 Roo Code 的袋鼠图标。调试模式开发者才需要的加餐如果你是改代码、而不是装来用项目已配好调试配置.vscode/launch.json 里的 Run Extension用 VS Code 打开 Roo-Code 目录按F5启动调试会新开一个扩展开发主机窗口加载本地源码。Webview 的改动会热更新生效还能打断点、在调试控制台看日志。验证安装是否成功完全重启 VS Code这步不能省按CtrlShiftPmacOS 是CmdShiftP打开命令面板运行Roo Code: Show Welcome或者点击侧边栏的袋鼠图标直接打开面板看到欢迎界面和聊天输入框说明部署完成。随后在设置里填入你的 API 提供商和密钥发第一条消息时 Roo Code 就开始干活了——它能读文件、改代码、跑命令、管理待办具体工具面板长这样配置与调优两个最实用的自定义Roo Code 的行为有两类入口编辑器内的设置界面API 提供商、自动批准、主题等以及项目根目录下的两个配置文件。后者对团队项目特别有用因为它们可以提交进 Git让所有人共享同一套行为。示例一用.rooignore控制哪些文件进上下文这是 gitignore 语法的文件Roo Code 在索引和搜索时会跳过匹配的文件。例如在项目根目录的.rooignore里加两行dist/ *.log改完后AI 检索代码时就不会再被构建产物和日志干扰回答更聚焦。示例二用 .roomodes 自定义工作模式这个 YAML 文件定义项目级自定义模式每个模式有自己的角色设定和可用工具组。最小可用的自定义模式长这样customModes: - slug: reviewer name: Reviewer roleDefinition: 你是严格的代码评审员只关注正确性与可读性不直接改代码。 whenToUse: 需要评审一段改动时 description: 代码评审模式 groups: - read source: projectgroups里放read表示该模式只读不写source: project表示它只作用于当前项目。保存后重新打开面板就能在下拉框里切到 Reviewer 模式。更细的行为逻辑模式、自动批准、提示词组装都实现在 src/core/config/ 和 src/core/ 目录下想深挖可以顺着源码走。高频故障排错速查提示pnpm: command not found原因系统还没装 pnpm装依赖那步就断了。 解决npm install -g pnpm或corepack enable再重新执行pnpm install。安装依赖时报 Node 版本相关错误原因项目锁定 Node 20.19.2你本地的版本不匹配。 解决用版本管理器对齐nvm install 20.19.2 nvm use 20.19.2再重装依赖。终端提示❌ VSIX file not foundbin/里没有 vsix 文件原因构建环节失败——通常是依赖没装全网络中断、子包报错导致产物没生成。 解决回到终端检查pnpm install与pnpm vsix的最后几行报错修复后执行pnpm clean pnpm vsix重新构建再跑一次node scripts/install-vsix.js完成安装。扩展装上去了但侧边栏没有图标、面板打不开原因VS Code 版本低于 1.84或安装后没有真正重启。 解决通过Help Check for Updates升级 VS Code完全关闭再打开仍不行就打开View Output选择 Roo Code 频道看启动日志这里会输出扩展的完整运行信息收尾接下来去哪到这里Roo Code 已经在你本地的 VS Code 里跑起来了——看到欢迎面板和能正常回复的对话框就宣告部署成功。想继续深入三个入口值得收藏安装文档源文件 覆盖了更多编辑器Cursor、VSCodium 等的场景整个文档站在 apps/docs/ 下想参与贡献的话先看 AGENTS.md 了解项目约定版本迭代节奏可以看 CHANGELOG.md项目保持高频发布pnpm install:vsix随时能把本地构建升到最新源码。【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 从零跑通 Roo Code：AI 编程助手本地部署与配置完整指南
从零跑通 Roo CodeAI 编程助手本地部署与配置完整指南【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code装完一个 AI 编程插件你多半遇到过这几个瞬间命令跑完不知道有没有成功、面板里找不到入口、想改行为却不知道改哪里。Roo Code 是把一整支 AI Agent 团队编码、架构、调试、问答多种模式塞进 VS Code 的开源扩展本地部署后你可以完全掌控它的运行方式和配置。跟着这份指南你会拉取源码、一键构建 VSIX 包、把扩展装进 VS Code并学会两处最实用的自定义配置——全程大约 15 分钟不需要专业开发背景。部署前置检查清单动手前花一分钟核对下面的清单能避开 90% 的装不上问题项目要求说明操作系统Windows 10/11、macOS 12、LinuxUbuntu 20.04三大平台均可硬件建议 8GB 内存、5GB 可用磁盘依赖体积较大Node.js20.19.2项目锁定此版本用.nvmrc声明pnpm10.xpnpm10.8.1项目指定的包管理器Git任意近期版本用于克隆源码VS Code≥ 1.84.0扩展声明的最低版本不满足怎么办Node 和 pnpm 都有跨平台安装脚本版本管理器如 nvm一条命令就能切到 20.19.2磁盘不足 5GB 时建议先清理依赖安装 构建产物大约占用几个 GB。快速上手五个动作跑通部署拉取代码打开终端执行下面这条把源码克隆到本地git clone https://gitcode.com/GitHub_Trending/ro/Roo-Code cd Roo-Code这一步只获取代码不做任何安装。完成后你应该看到本地多了一个Roo-Code目录里面有src/、webview-ui/、pnpm-workspace.yaml等文件。安装依赖进入项目目录后用 pnpm 安装全部依赖这是项目里体积最大的一步pnpm install它会按 monorepo 结构安装根目录、src、webview-ui等所有子包的依赖首次运行需要几分钟。完成后你应该看到node_modules目录出现且终端没有报错退出。装依赖偏慢时可以先换镜像源再装pnpm config set registry https://registry.npmmirror.com。构建并安装 VSIX 扩展包项目内置了构建 安装一条龙脚本这是推荐方式适合所有新手pnpm install:vsix这条命令会依次执行锁定版本装依赖 → 清理旧产物 → 构建 VSIX 包 → 调用 scripts/install-vsix.js 先卸载旧版本再安装新包。中途它会问你用哪个编辑器命令code/cursor/code-insiders直接回车用默认的code即可只想跳过确认时可以加-y参数一把梭。完成后你应该看到终端输出✅ Successfully installed extension并提示需要重启 VS Code。如果你想要更多控制比如只构建、自己决定何时装用手动方式适合想排查构建环节的人pnpm vsix构建成功后bin/目录下会出现roo-cline-3.53.0.vix之类的 VSIX 文件版本号以实际构建为准然后用编辑器命令手动安装code --install-extension bin/roo-cline-3.53.0.vsix装完重启 VS Code你应该能在侧边栏活动栏看到 Roo Code 的袋鼠图标。调试模式开发者才需要的加餐如果你是改代码、而不是装来用项目已配好调试配置.vscode/launch.json 里的 Run Extension用 VS Code 打开 Roo-Code 目录按F5启动调试会新开一个扩展开发主机窗口加载本地源码。Webview 的改动会热更新生效还能打断点、在调试控制台看日志。验证安装是否成功完全重启 VS Code这步不能省按CtrlShiftPmacOS 是CmdShiftP打开命令面板运行Roo Code: Show Welcome或者点击侧边栏的袋鼠图标直接打开面板看到欢迎界面和聊天输入框说明部署完成。随后在设置里填入你的 API 提供商和密钥发第一条消息时 Roo Code 就开始干活了——它能读文件、改代码、跑命令、管理待办具体工具面板长这样配置与调优两个最实用的自定义Roo Code 的行为有两类入口编辑器内的设置界面API 提供商、自动批准、主题等以及项目根目录下的两个配置文件。后者对团队项目特别有用因为它们可以提交进 Git让所有人共享同一套行为。示例一用.rooignore控制哪些文件进上下文这是 gitignore 语法的文件Roo Code 在索引和搜索时会跳过匹配的文件。例如在项目根目录的.rooignore里加两行dist/ *.log改完后AI 检索代码时就不会再被构建产物和日志干扰回答更聚焦。示例二用 .roomodes 自定义工作模式这个 YAML 文件定义项目级自定义模式每个模式有自己的角色设定和可用工具组。最小可用的自定义模式长这样customModes: - slug: reviewer name: Reviewer roleDefinition: 你是严格的代码评审员只关注正确性与可读性不直接改代码。 whenToUse: 需要评审一段改动时 description: 代码评审模式 groups: - read source: projectgroups里放read表示该模式只读不写source: project表示它只作用于当前项目。保存后重新打开面板就能在下拉框里切到 Reviewer 模式。更细的行为逻辑模式、自动批准、提示词组装都实现在 src/core/config/ 和 src/core/ 目录下想深挖可以顺着源码走。高频故障排错速查提示pnpm: command not found原因系统还没装 pnpm装依赖那步就断了。 解决npm install -g pnpm或corepack enable再重新执行pnpm install。安装依赖时报 Node 版本相关错误原因项目锁定 Node 20.19.2你本地的版本不匹配。 解决用版本管理器对齐nvm install 20.19.2 nvm use 20.19.2再重装依赖。终端提示❌ VSIX file not foundbin/里没有 vsix 文件原因构建环节失败——通常是依赖没装全网络中断、子包报错导致产物没生成。 解决回到终端检查pnpm install与pnpm vsix的最后几行报错修复后执行pnpm clean pnpm vsix重新构建再跑一次node scripts/install-vsix.js完成安装。扩展装上去了但侧边栏没有图标、面板打不开原因VS Code 版本低于 1.84或安装后没有真正重启。 解决通过Help Check for Updates升级 VS Code完全关闭再打开仍不行就打开View Output选择 Roo Code 频道看启动日志这里会输出扩展的完整运行信息收尾接下来去哪到这里Roo Code 已经在你本地的 VS Code 里跑起来了——看到欢迎面板和能正常回复的对话框就宣告部署成功。想继续深入三个入口值得收藏安装文档源文件 覆盖了更多编辑器Cursor、VSCodium 等的场景整个文档站在 apps/docs/ 下想参与贡献的话先看 AGENTS.md 了解项目约定版本迭代节奏可以看 CHANGELOG.md项目保持高频发布pnpm install:vsix随时能把本地构建升到最新源码。【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考