Roo Code (VS Code) - API易文档中心

概述

Roo Code 是一款強大的 VS Code AI 程式設計助手外掛，為您提供一個完整的 AI 開發團隊。它最大的特色是多模式配置，允許針對不同的開發任務使用不同的 AI 模型，實現最佳的開發效率。

核心優勢

🎯 多模式配置：為架構、編碼、除錯等不同任務分配專門的模型
🤖 Agent 智慧體：自動規劃和執行復雜的開發任務
🔄 多檔案操作：理解專案結構，智慧修改多個檔案
💰 完全免費：開源免費，只需支付 AI 模型使用費用
🌐 廣泛相容：支援 400+ 主流 AI 模型
🔌 MCP 支援：通過 Model Context Protocol 連線外部工具

Roo Code vs ClineRoo Code 是 Cline 的一個分支專案，保留了 Cline 的核心功能，同時添加了獨特的多模式配置系統。如果您需要為不同開發階段使用不同模型，Roo Code 是更好的選擇。

維護狀態與 Responses 端點支援

官方已停止更新（2026 年）

Roo Code 團隊已釋出最後一個版本，宣佈重心轉向 Roomote（其雲端智慧體平臺）：擴充套件會繼續無限期工作，但不再有錯誤修復、新功能和模型更新。官方建議想繼續使用擴充套件形態的使用者關注社群維護的 fork ZooCode，或回到其起源專案 Cline。

Roo Code 最後一個版本公告：擴充套件繼續無限期工作但不再有錯誤修復、新功能或模型更新，官方推薦 ZooCode 與 Cline

停更的直接影響：「OpenAI」provider 的預置模型列表止步 gpt-5.4，gpt-5.5 / gpt-5.6 系列等後續新模型無法在下拉中選到。存量功能不受影響。

為數不多支援 /v1/responses 的 IDE 外掛（實測可用）

Roo Code 的「OpenAI」provider 走 /v1/responses 端點（注意與「OpenAI Compatible」provider 區分，後者走 /v1/chat/completions），並支援自定義 Base URL。這讓它成為目前少數能在 IDE 裡跑通 GPT-5.4「推理 + 工具呼叫」 的外掛——GPT-5.4 及之後的模型在 chat/completions 上已被 OpenAI 禁止工具與推理同用（詳見 Responses 原生呼叫指南），而走 responses 不受此限。配置方式：API Provider 選 OpenAI（不是 OpenAI Compatible），Base URL 填 https://api.apiyi.com/v1，模型選 gpt-5.4。

在 Trae 等 VS Code 系 IDE 中安裝使用

Trae 等基於 VS Code 的 IDE 同樣可以安裝 Roo Code 外掛。實測在 Trae 內安裝 Roo Code、按上述方式配置 OpenAI provider 後，Responses 端點的工具呼叫與任務執行均正常——相當於給自定義模型只支援 chat/completions 的 Trae 補上了一條 Responses 通道（模型上限同樣是 gpt-5.4）。

在 Trae IDE 中通過 Roo Code 外掛走 Responses 端點執行任務的實測截圖

快速安裝

方式一：VS Code 擴充套件商店（推薦）

開啟擴充套件商店

在 VS Code 中按 Ctrl+Shift+X (Windows/Linux) 或 Cmd+Shift+X (macOS)

搜尋安裝

搜尋 “Roo Code” 並點選安裝擴充套件 ID：RooVeterinaryInc.roo-cline

開啟外掛

安裝完成後，點選左側活動欄的 Roo Code 圖示

方式二：Open VSX Registry

訪問 Open VSX Registry 搜尋 Roo Code 進行安裝。

配置 API易

基礎配置

開啟設定

點選 Roo Code 側邊欄的齒輪圖示（設定按鈕）

選擇 API 提供商

在 API Provider 下拉選單中選擇 OpenAI Compatible

配置連線引數

Base URL: https://api.apiyi.com/v1API Key: 您的 API易金鑰（格式：sk-***）Model Name: 輸入您要使用的模型名稱

儲存配置

點選儲存，Roo Code 會自動驗證連線

Base URL 配置要求：

必須使用 https://api.apiyi.com/v1（包含 /v1 路徑）
不要使用 https://api.apiyi.com（缺少 /v1 會導致連線失敗）

獲取 API易金鑰

訪問 API易後臺

登入 api.apiyi.com

建立 API Key

進入「令牌管理」頁面（api.apiyi.com/token），點選「建立新令牌」

複製金鑰

複製生成的 API Key（格式：sk-***），並貼上到 Roo Code 配置中

多模式配置（核心特性）

Roo Code 的獨特之處在於可以為不同的開發模式分配不同的 AI 模型，實現專業化分工。

五大開發模式

Architect Mode
Code Mode
Ask Mode
Debug Mode
Orchestrator Mode

架構模式 - 用於系統設計和架構規劃適合模型：

Claude Sonnet（推理能力強，擅長架構設計）
GPT-4o（全面的技術知識）
DeepSeek V3（深度思考，價效比高）

典型任務：

設計一個微服務架構的電商系統：
- 使用者服務
- 商品服務
- 訂單服務
- 支付服務
使用 Docker + Kubernetes 部署

編碼模式 - 用於實際程式碼生成和編寫適合模型：

Claude Sonnet（程式碼品質高）
DeepSeek Coder（專業程式設計模型）
Qwen Coder（中文註釋友好）

典型任務：

實現使用者認證模組：
- JWT token 生成和驗證
- 密碼加密（bcrypt）
- 登入/註冊介面
- 權限中介軟體

問答模式 - 用於技術諮詢和實現規劃適合模型：

GPT-4o-mini（快速響應，成本低）
Gemini Flash（速度快）
DeepSeek Chat（價效比高）

典型任務：

問：如何最佳化 React 元件的渲染效能？
問：Redux 和 Zustand 的區別是什麼？
問：如何處理 Node.js 中的記憶體洩漏？

除錯模式 - 用於錯誤排查和問題修復適合模型：

GPT-4o（理解複雜錯誤）
Claude Sonnet（程式碼分析能力強）
DeepSeek V3（深度分析）

典型任務：

除錯這個錯誤：
TypeError: Cannot read property 'map' of undefined

幫我找出以下程式碼中的記憶體洩漏問題
分析為什麼這個非同步函式沒有正確執行

編排模式 - 用於複雜任務的分解和協調適合模型：

Claude Opus（處理複雜任務）
GPT-4o（全域性規劃能力強）
DeepSeek V3（邏輯推理）

典型任務：

將整個專案從 JavaScript 遷移到 TypeScript：
分析現有程式碼結構
建立型別定義檔案
逐步轉換各模組
更新配置檔案
執行測試驗證

配置多模式

開啟模式設定

在 Roo Code 設定中找到 Mode Configuration 區域

為每個模式選擇模型

可以為每個模式單獨配置：

API Provider
Model Name
Temperature（創造性引數）
Max Tokens

切換使用模式

在 Roo Code 介面中，通過模式選擇器切換當前使用的模式

推薦配置策略：

Architect/Orchestrator → 使用高品質模型（Claude Sonnet, GPT-4o）
Code → 使用專業程式設計模型（DeepSeek Coder, Claude Sonnet）
Ask → 使用快速經濟模型（GPT-4o-mini, Gemini Flash）
Debug → 使用分析能力強的模型（Claude Sonnet, GPT-4o）

檢視程式設計開發模型推薦

檢視最新的程式設計模型推薦、效能對比和使用建議。包括頂級效能模型、高性價比模型、推理增強模型等詳細分類。

為什麼不在此列出具體模型？AI 模型更新迭代速度非常快，為了確保您獲取最準確的模型推薦資訊，我們統一在模型推薦頁面維護最新的模型列表、效能資料和使用建議。

核心功能

Agent 智慧體模式

Roo Code 最強大的功能是 Agent 模式，AI 可以自主規劃和執行復雜任務：

任務：建立一個完整的使用者認證系統

Roo Code 會自動：
分析需求，制定實現計劃
建立必要的檔案和目錄結構
編寫後端 API 程式碼
建立前端登入/註冊頁面
新增錯誤處理和驗證
生成單元測試
更新相關文件

多檔案智慧編輯

理解專案結構，自動修改多個相關檔案：

"將所有 API 呼叫從 axios 改為 fetch，並更新錯誤處理邏輯"

Roo Code 會：
- 找到所有使用 axios 的檔案
- 轉換為 fetch API
- 統一錯誤處理模式
- 更新型別定義（如果使用 TypeScript）

程式碼生成

# 輸入描述
"""
建立一個 FastAPI 端點，實現使用者註冊功能：
- 接收 email 和 password
- 驗證郵箱格式
- 密碼加密儲存
- 返回 JWT token
"""

# Roo Code 自動生成完整實現
from fastapi import APIRouter, HTTPException
from passlib.hash import bcrypt
import jwt
# ... 完整的程式碼實現

// 輸入需求
// 建立一個 React Hook 用於管理表單狀態
// 支援驗證、錯誤提示、提交處理

// Roo Code 生成
import { useState, useCallback } from 'react';

export function useForm(initialValues, validationRules) {
  // ... 完整的 Hook 實現
}

// 需求：實現一個併發安全的快取
// 支援 Set、Get、Delete、清理過期資料

// Roo Code 生成完整的 Go 程式碼
package cache

import (
    "sync"
    "time"
)

type Cache struct {
    // ... 完整實現
}

程式碼審查和最佳化

審查這個 PR，關注：
- 程式碼規範
- 效能問題
- 安全漏洞
- 潛在 bug
- 可讀性改進

Roo Code 會提供詳細的審查報告和改進建議。

智慧重構

重構這個函式，要求：
- 提高可讀性
- 最佳化效能
- 新增錯誤處理
- 改進型別安全

測試生成

為 UserService 類生成完整的單元測試，包括：
- 正常流程測試
- 邊界條件測試
- 錯誤處理測試
- Mock 外部依賴

常用命令

Roo Code 提供了豐富的命令面板命令：

命令	快捷鍵	功能
Roo Code: New Task	`Ctrl+Shift+L`	開始新任務
Roo Code: Continue	`Enter`	繼續當前任務
Roo Code: Approve	`Ctrl+Enter`	批准 AI 的更改
Roo Code: Reject	`Ctrl+Backspace`	拒絕更改
Roo Code: Clear History	-	清除對話歷史
Roo Code: Switch Mode	-	切換開發模式

快捷鍵提示：可以在 VS Code 的鍵盤快捷方式設定中自定義 Roo Code 的快捷鍵。

高階功能

API Configuration Profiles

為不同專案或團隊建立不同的 API 配置檔案：

{
  "roocode.apiProfiles": {
    "production": {
      "provider": "OpenAI Compatible",
      "baseUrl": "https://api.apiyi.com/v1",
      "apiKey": "sk-prod-key",
      "defaultModel": "claude-sonnet-4"
    },
    "development": {
      "provider": "OpenAI Compatible",
      "baseUrl": "https://api.apiyi.com/v1",
      "apiKey": "sk-dev-key",
      "defaultModel": "deepseek-chat"
    }
  }
}

Codebase Indexing

Roo Code 會自動索引您的程式碼庫，理解專案結構：

自動發現檔案關係
理解程式碼依賴
智慧上下文感知
跨檔案引用追蹤

MCP 整合

通過 Model Context Protocol 連線外部工具：

資料庫查詢
API 呼叫
檔案系統操作
Git 操作
自定義工具整合

自定義提示詞模板

在設定中配置常用的提示詞模板：

{
  "roocode.customTemplates": {
    "codeReview": "詳細審查程式碼，關注效能、安全、可維護性",
    "optimize": "最佳化程式碼效能和可讀性，新增必要的註釋",
    "test": "生成全面的單元測試，覆蓋邊界情況",
    "refactor": "重構程式碼，遵循 SOLID 原則和設計模式"
  }
}

使用技巧

1. 提供清晰的上下文

❌ 模糊描述

“最佳化這個函式”

✅ 清晰描述

“最佳化這個函式的效能，重點關注迴圈效率和記憶體使用，新增適當的註釋說明最佳化思路”

2. 分步驟執行復雜任務

對於複雜任務，建議分解為多個步驟：

第一步：架構設計

使用 Architect Mode 設計整體架構

第二步：模組實現

切換到 Code Mode 實現各個模組

第三步：除錯最佳化

使用 Debug Mode 排查問題

第四步：整合測試

使用 Orchestrator Mode 協調整合

3. 利用模式切換

針對不同任務型別切換最合適的模式：

需要設計架構？→ Architect Mode
寫程式碼實現？→ Code Mode
快速諮詢？→ Ask Mode
遇到 Bug？→ Debug Mode
複雜重構？→ Orchestrator Mode

4. 審查和批准更改

重要習慣：

始終審查 AI 生成的程式碼再批准
理解每個更改的目的
測試修改後的功能
保持程式碼庫的一致性

常見問題

Roo Code 和 Cline 有什麼區別？

主要區別：

多模式配置：Roo Code 的核心特性，Cline 不支援
程式碼庫：Roo Code 是 Cline 的 Fork，但在獨立開發
更新頻率：Roo Code 更新更頻繁，功能迭代快
社群：兩者都有活躍的社群，但側重點不同

如何選擇：

需要多模式？→ Roo Code
需要穩定性？→ Cline
都可以免費試用，選擇最適合自己的

為什麼連線失敗或無法使用模型？

常見原因和解決方案：

Base URL 錯誤：
- ✅ 正確：https://api.apiyi.com/v1
- ❌ 錯誤：https://api.apiyi.com
API Key 無效：
- 檢查 Key 是否正確複製（注意首尾空格）
- 確認賬戶餘額充足
- 驗證 Key 狀態為「啟用」
模型名稱錯誤：
- 確保使用正確的模型名稱
- 參考模型列表
網路問題：
- 檢查網路連線
- 嘗試重啟 VS Code

如何為不同模式配置不同的模型？

配置步驟：

開啟 Roo Code 設定（齒輪圖示）
找到 Mode Configuration 區域
為每個模式單獨設定：
- Architect Mode → claude-sonnet-4
- Code Mode → deepseek-coder
- Ask Mode → gpt-4o-mini
- Debug Mode → claude-sonnet-4
- Orchestrator Mode → gpt-4o
儲存配置

在使用時，通過模式選擇器切換即可。

Roo Code 會自動修改我的程式碼嗎？

不會自動修改，需要您的批准：

Roo Code 會先展示建議的更改
您可以：
- 檢視 Diff（差異對比）
- 批准（Apply）更改
- 拒絕（Reject）更改
- 修改後再批准
所有更改都在您的控制之下

建議啟用版本控制（Git），這樣可以隨時回退不滿意的更改。

如何節省 API 使用成本？

省錢策略：

智慧選擇模型：
- 簡單任務用便宜的模型（GPT-4o-mini, DeepSeek）
- 複雜任務才用高階模型（Claude Opus, GPT-4o）
利用多模式配置：
- Ask Mode → 用最便宜的模型
- Code/Debug Mode → 用中等價位的專業模型
- Architect Mode → 僅在需要時用高階模型
充值優惠：
- API易提供充值加贈（10%-22%）
- 檢視充值活動
控制上下文長度：
- 清除不必要的對話歷史
- 專注當前任務，減少無關上下文

Roo Code 支援哪些程式語言？

幾乎所有主流程式語言，包括但不限於：

Web: JavaScript, TypeScript, HTML, CSS, React, Vue, Angular
後端: Python, Java, Go, Rust, C++, C#, PHP, Ruby
移動: Swift, Kotlin, Dart (Flutter), React Native
資料: SQL, R, Julia
其他: Shell, YAML, JSON, Markdown

效果取決於：

選擇的 AI 模型
模型的訓練資料
語言的流行程度

對比其他工具

特性	Roo Code	Cline	Cursor	GitHub Copilot
多模式配置	✅	❌	❌	❌
Agent 模式	✅	✅	❌	❌
多檔案編輯	✅	✅	部分	❌
自定義 API	✅	✅	✅	❌
免費開源	✅	✅	❌	❌
模型選擇	400+	400+	有限	GitHub 獨家
學習曲線	中等	中等	低	低

選擇建議：

需要多模式配置 → Roo Code
需要穩定成熟 → Cline
需要簡單易用 → Cursor
GitHub 深度整合 → GitHub Copilot

價格說明

Roo Code 外掛本身完全免費，您只需支付 AI 模型的使用費用。通過 API易使用 AI 模型的費用取決於您選擇的模型和使用量。

檢視詳細價格

檢視所有模型的詳細定價和價效比對比

API易提供充值優惠：充值越多，加贈比例越高（10%-22%）。首次充值還可獲得額外加贈。檢視充值活動詳情。

獲取幫助

企業微信客服

掃碼新增或點選聯絡客服配置問題、使用指導

郵件諮詢

客服郵箱：[email protected]商務合作：[email protected]

快速上手：按照本文的「快速安裝」和「配置 API易」章節，5 分鐘即可開始使用 Roo Code 進行 AI 輔助程式設計！

​概述

​維護狀態與 Responses 端點支援

​官方已停止更新（2026 年）

​為數不多支援 /v1/responses 的 IDE 外掛（實測可用）

​在 Trae 等 VS Code 系 IDE 中安裝使用

​快速安裝

​方式一：VS Code 擴充套件商店（推薦）

​方式二：Open VSX Registry

​配置 API易

​基礎配置

​獲取 API易 金鑰

​多模式配置（核心特性）

​五大開發模式

​配置多模式

​推薦模型

檢視程式設計開發模型推薦

​核心功能

​Agent 智慧體模式

​多檔案智慧編輯

​程式碼生成

​程式碼審查和最佳化

​智慧重構

​測試生成

​常用命令

​高階功能

​API Configuration Profiles

​Codebase Indexing

​MCP 整合

​自定義提示詞模板

​使用技巧

​1. 提供清晰的上下文

❌ 模糊描述

✅ 清晰描述

​2. 分步驟執行復雜任務

​3. 利用模式切換

​4. 審查和批准更改

​常見問題

​對比其他工具

​價格說明

檢視詳細價格

​相關資源

​獲取幫助

企業微信客服

郵件諮詢

概述

維護狀態與 Responses 端點支援

官方已停止更新（2026 年）

為數不多支援 /v1/responses 的 IDE 外掛（實測可用）

在 Trae 等 VS Code 系 IDE 中安裝使用

快速安裝

方式一：VS Code 擴充套件商店（推薦）

方式二：Open VSX Registry

配置 API易

基礎配置

獲取 API易金鑰

多模式配置（核心特性）

五大開發模式

配置多模式

推薦模型

核心功能

Agent 智慧體模式

多檔案智慧編輯

程式碼生成

程式碼審查和最佳化

智慧重構

測試生成

常用命令

高階功能

API Configuration Profiles

Codebase Indexing

MCP 整合

自定義提示詞模板

使用技巧

1. 提供清晰的上下文

2. 分步驟執行復雜任務

3. 利用模式切換

4. 審查和批准更改

常見問題

對比其他工具

價格說明

相關資源

獲取幫助