Roo Code 是什麼、怎麼安裝配置:Architect / Code / Ask 模式與接入官方 API 教學

不想放棄熟悉的原版 VS Code、也不想背每月固定編輯器月租怎麼用上多角色編程智能體?本文按 Roo Code(docs.roocode.com)官方文檔詳解擴展安裝、五大內置模式文件權限分工、多模型配置檔綁定及 .roo/rules 規則。

NNathaniel bigo··原創首發·AI 輔助撰寫
9 分鐘讀完
資料核對於 2026-11-19 · 依據官方文檔與公開資料整理 其他 帳號

結論先說

  1. Roo Code 是運行在 VS Code 側邊欄的開源多角色編程智能體(原 Roo Cline 演進而來):插件本身免費開源,不抽成、不強制綁月租,直接填你自己的各家官方 API Key 或連本機 Ollama 就能跑。
  2. 它和同類極簡插件最大的不同是「按角色硬鎖文件寫權限」:切到 Ask 絕對不改任何文件,切到 Architect 預設只准寫 .md 設計文檔不準動業務代碼,從機制上杜絕了「還沒聊明白就亂改源碼」。
  3. 支持建多套 API Configuration Profile 並與模式一一綁定:切到 Architect 自動調頂尖推理模型想方案,切回 Code 自動秒切高性價比模型落地代碼,不用每次手動改配置。
  4. 如果你每天全職重度寫碼幾小時、嫌按量 API 算 Token 心累:也可以搭配包月固定額度的獨立終端工具,詳見本站 Claude Code 訂閱服務 與 AI 會員充值總覽頁。

Roo Code 五大內置模式與文件權限

圖:本站根據 Roo Code 官方文檔 整理的五大內置模式權限與職責對比圖

本文根據 Roo Code 官方文檔(docs.roocode.com)與官方開源倉庫整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是軟件截圖。本站(bigolab.com)不是 Roo Code 官方網站。

適用於誰

  • 不想離開自己調教多年的原版 VS Code,想裝一個開源透明、不收軟件月租費的編程智能體插件的開發者;
  • 手頭已經有 DeepSeek、Gemini、OpenAI 或 Anthropic 官方 API Key,想「規劃用旗艦模型、寫代碼用便宜快模型」精細控成本的人;
  • 裝上插件後看到輸入框左下角有 Code、Architect、Ask、Debug、Orchestrator 五個模式,搞不清各自文件讀寫邊界的新手。

一、四步安裝並配好「多模型省錢配置檔」

安裝 Roo Code 並接入官方接口四步

圖:本站根據 Roo Code 快速入門 整理的四步安裝與配置流程示意圖

  1. 在 VS Code 擴展商店一鍵安裝:打開左側擴展欄搜尋 Roo Code(認準發佈者 RooVetGit、袋鼠小圖標),點擊安裝後左側活動欄就會出現袋鼠面板(若你想對比它的同源兄弟擴展,可一併看本站 Cline 安裝與 Plan/Act 配置教學)。
  2. 新建兩套以上的官方 API 配置檔(Profiles):點面板右上角齒輪進入設定,不要只配一把死鑰匙。點擊配置檔旁邊的 + 號 分別建好兩套檔案:
  1. 把配置檔釘死到對應模式上:切到 Architect 模式時在底部選一次 Arch-Brain,切到 Code 和 Ask 模式時選一次 Fast-Coder——Roo Code 會自動記住每個模式專屬綁定的模型檔,以後你切換模式時後台模型自動跟着無縫切換。
  2. 開啟合理的自動批准(Auto-Approve)邊界:建議只勾選自動批准 讀取文件(Read),而將 修改文件(Write) 與 執行終端命令(Execute) 保留為人工看一眼 Diff 再點同意,兼顧流暢度與安全。
AI 編程主力訂閱與多工具分流方案:日常寫代碼把行內補全交給 IDE,把跨十幾個文件的重度重構與單測閉環分流給固定月費的終端智能體,是目前最省預算的組合拳。本站支持支付寶、微信支付與 AlipayHK 免密自助開通 Claude Code 訂閱(含 Claude Max 5x)、ChatGPT Plus / Pro 與 SuperGrok 會員。

二、用 .roo/rules/ 管項目規範、用 .roomodes 造專屬崗位

除了現成的五個模式,Roo Code 的定製目錄也非常清晰(若團隊多人混用多款工具,也可同時配合 AGENTS.md 跨工具規範):

  • 項目級通用與分模式規則:在倉庫根目錄建 .roo/rules/ 文件夾放全局 Markdown 守則;更妙的是,你還可以建 .roo/rules-code/ 或 .roo/rules-architect/ 專屬文件夾——放在 rules-architect/ 裏的文檔模板只會在處於架構模式時注入,寫代碼時完全不佔上下文。
  • 通過 .roomodes 定義團隊自定義角色:比如你想造一個「只准改 tests/ 目錄下的測試文件、嚴禁觸碰 src/ 生產代碼」的單測專員模式,可以在根目錄 .roomodes 配置裏用正則限制其文件寫權限,徹底鎖死操作半徑。

常見問題

問:在 Architect 模式下聊完了方案,直接發「按這個改代碼」它為什麼不動手改 .ts 文件?

答:這不是卡住了,正是官方設計的安全鎖——Architect 模式預設只具備編輯 .md 文檔的權限。方案敲定後,點擊輸入框左下角把模式切到 Code(或者讓它發起模式切換請求你點批准),它就會立刻照着剛才寫好的方案開始改業務代碼。

問:跑幾輪大文件修改後感覺每次提問扣的 API 費用越來越高怎麼辦?

答:按量 API 下每次工具往返都會重發當前會話累積的歷史記錄(開啟服務商原生提示詞緩存能省一大截,務必勾選支持緩存的官方模型選項);遇到跨十幾個文件的大活時,改用內置 Orchestrator 拆成獨立子任務能大幅削減長窗口累積損耗。

問:Roo Code 有像 Cursor 那樣的打字自動灰色多行 Tab 補全嗎?

答:Roo Code 專注做好側邊欄自主多步智能體與行內右鍵快捷指令,本身不包含獨立高頻預測小模型驅動的實時打字 Tab 補全;如果你需要免費開源的打字補全,可以在 VS Code 裏同時裝一個輕量補全插件(如 Continue 連本地小模型)搭檔使用。

問:按量 API 帳單波動太大,國內沒有境外卡怎麼開通固定包月的 AI 編程訂閱?

答:可在 本站 AI 會員充值中心 按編碼強度自助選購 Claude Pro iOS 自助檔、Claude Max 充值 或包含 Codex 額度的 ChatGPT Pro 充值,全程卡密自助兌換無需交出密碼,封號不在質保範圍。

相關教學

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    用 ChatGPT 速讀英文產品手冊、開源文檔與 GitHub Issue 並沉澱團隊中文內訓手冊

    團隊引入海外 SaaS 工具或開源框架時,全英文文檔晦澀冗長、真正的坑全藏在幾十頁 GitHub Issue 討論裏。本文分享速讀拆解英文手冊、歸類 Issue 排障庫以及重構團隊中文內訓 SOP 的完整實戰流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 寫油猴腳本(Tampermonkey)與瀏覽器書籤小工具解決網頁繁瑣重複操作實戰

    每天在後台系統裏重複勾選幾十個複選框、手工複製網頁表格或清理遮擋閱讀的側邊欄,既枯燥又浪費時間。本文分享不會寫 JS 也能用 F12 配合 ChatGPT 寫出油猴腳本與書籤小工具的完整實戰流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 寫高質素 SQL 窗口函數(RANK / LAG / SUM OVER)做留存與漏斗分析實戰

    做用戶留存率、復購間隔與有序轉化漏斗時,多層自連接既難讀又拖垮數據庫,窗口函數則是高效解法。本文整理數據庫方言喂數規範、CTE 分層提示詞以及用內置沙盒先驗證再上線的完整實戰流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 連接 Canva、Figma、Linear、Jira、Dropbox 等第三方應用搜不到數據或授權失效怎麼辦

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 後,明明顯示已連接卻搜不到文件工單,或老提示授權失效怎麼辦?本文拆解帳號錯綁、OAuth 範圍漏選、權限繼承與管理員攔截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  6. 06

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~