為 AI 程式開發代理安裝 REA

01. 開始之前

你需要終端機、npm，以及支援本機 MCP 的 AI 程式開發代理。本指南涵蓋 Claude Code、Codex 和 Cursor。請使用你擁有或獲准分析的軟體。

node --version
npm --version

REA 目前支援 22.x 中的 Node.js 22.19+、24.x 中的 24.11+，或 26+。23、25 和預先發行版本不在支援範圍內。如有需要，可從 Node.js 取得相容版本。

本範例在 macOS arm64、Node.js 22.23.1 和 REA 6.4.0 環境中驗證。額外引擎的平台支援有所不同，請按目標檢視 官方安裝參考。

02. 連線 AI 程式開發代理

選擇用戶端，獲得針對該用戶端的設定指令。「在安裝時選擇」會開啟互動式用戶端選擇。

npx rea-agents@latest setup

1. 執行指令。npm 可能會先詢問是否下載套件。
2. 檢視 REA 提出的計畫：用戶端設定檔案、配套 skill 指令，以及可選的引擎安裝。
3. 確認你需要的修改。如果首個目標是 JavaScript，可以先不安裝原生分析引擎。
4. 重新啟動或重新連線 AI 程式開發代理，使其載入新的 MCP 伺服器。

安裝流程會同時設定 MCP 註冊和配套工作流指令。只安裝 skill 並不會建立工具連線。

想交給 AI 代理操作？

使用 npx rea-agents@latest setup 為這個 AI 程式開發代理安裝 REA。套用設定前，先展示預計的變更。然後說明如何重新啟動並驗證連線。我的第一個目標是本機 JavaScript 套件。

03. 檢查連線

重新啟動後，詢問 AI 代理是否能看到 REA 工具。在第一篇教學中，它應該能呼叫 analyze_javascript_application。

檢查目前工作階段是否能使用 REA 的 analyze_javascript_application 工具。如果能，請說明它需要什麼本機路徑。如果缺失，請如實報告，不要假裝已執行分析。

也可從終端機檢查用戶端設定。按需將 codex 替換為 claude_code 或 cursor。

npx -y rea-agents@latest doctor --client codex --json

04. 新增目標需要的工具

從想分析的軟體類型出發，無需安裝所有分析引擎。

商業引擎有自己的授權條款，REA 不提供引擎授權。新增前請檢查官方平台要求。

05. 遇到問題怎麼辦

AI 代理看不到 REA

先重新啟動用戶端。如果仍找不到工具，執行上方針對該用戶端的 doctor 指令。你可以只檢視設定修復計畫而不套用：

npx rea-agents@latest setup --client codex --dry-run --json

確認計畫後，如果要套用修改，請去掉 --dry-run --json 再執行相同的 setup 指令。修改設定後再次重新啟動。

「rea: command not found」

專案本機 npm 安裝不會把 rea 加入全域 shell 路徑。本指南的 npx 指令無需全域安裝。如果希望長期使用 CLI：

npm install --global rea-agents
rea --version

引擎檢查失敗

缺少原生分析引擎，不會影響不需要該引擎的 JavaScript 靜態分析。請確認目標所需的分析後端。若要處理大型原生二進位檔，請參閱官方對各引擎啟動逾時的說明。

06. 保持用戶端註冊設定更新

對於基於 npx 的設定，重新執行最新版 setup，檢查修改，再重新啟動用戶端：

npx rea-agents@latest setup

對於全域 CLI，執行 rea update，再按提示重新整理設定。GitHub 上出現新指令，並不會自動更新已經執行的 MCP 伺服器。

第一次使用這個工具？ REA 是什麼？ · 我們如何查核教學