REA 설정

• Windows: 시작 메뉴를 열고 PowerShell을 입력한 뒤 Enter를 누르세요.
• macOS: ⌘ Space를 누르고 터미널을 입력한 뒤 Enter를 누르세요.
• Linux: 대부분의 데스크톱에서 Ctrl Alt T를 누르세요.

Ctrl V(macOS: ⌘ V, Linux 터미널: Ctrl Shift V)로 명령을 붙여넣고 Enter를 누르세요.

명령어는 터미널에 입력하세요. ‘코딩 에이전트’라고 표시된 프롬프트는 에이전트의 채팅에 입력하세요.

터미널을 열고 확인하세요:

node -v
npm -v

node -v가 v22.19+, v24.11+ 또는 v26+를 출력하면 준비가 된 것입니다. 이전 버전이나 ‘인식되지 않음’ / ‘명령을 찾을 수 없음’이 나오면 Node.js 24 LTS를 설치하세요:

winget install --exact --id OpenJS.NodeJS.LTS

npx.cmd rea-agents@latest setup

brew install node

curl -fsSL https://fnm.vercel.app/install | bash

fnm install 24
fnm use 24
fnm default 24

일반 설치 프로그램을 원하나요? nodejs.org에서 LTS 버전을 다운로드하세요.

터미널에서 실습용 폴더를 만들고 그 폴더로 이동하세요.

mkdir rea-work
cd rea-work

다음 단계에서도 사용할 수 있도록 이 터미널을 열어 두세요. 이미 작업 폴더가 있다면 그 폴더를 여세요.

운영체제에 맞는 명령어로 Codex를 설치하세요.

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

curl -fsSL https://chatgpt.com/codex/install.sh | sh

설치 후 터미널을 다시 열고 작업 폴더로 돌아오세요. 그런 다음 Codex를 시작하세요.

codex

‘Sign in with ChatGPT’를 선택하고 브라우저에서 로그인을 마친 뒤 터미널로 돌아오세요. 메시지 입력란이 나타나면 3단계로 이동하세요.

Codex 설치와 로그인

1. 운영체제에 맞는 편집기를 설치하고 로그인하세요.
2. 1단계에서 만든 rea-work 폴더를 여세요.
3. 편집기의 AI 채팅을 열고 Agent 모드를 선택하세요. Windsurf나 Devin Desktop에서는 에이전트 채팅을 열고, VS Code에서는 먼저 GitHub Copilot을 설정하세요.

Cursor 설정 · Windsurf / Devin Desktop 설정 · VS Code와 Copilot 설정

운영체제에 맞는 명령어로 설치하세요.

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.sh | bash

터미널을 다시 열고 작업 폴더로 돌아간 뒤 claude를 실행하세요. 로그인 안내를 따르세요. 지원되는 Claude 구독이나 설정된 API 계정이 필요합니다.

Claude Code 설치와 계정 선택지

Windows나 macOS에 Claude Desktop을 설치하고 로그인하세요. 앱을 완전히 종료한 뒤 Claude 밖에서 연 터미널에서 이 명령어를 실행하세요.

npx rea-agents@latest setup --client claude_desktop

계획을 확인하고 승인한 뒤 Claude를 다시 열고 3단계에서 연결을 확인하세요.

Claude Desktop 다운로드 · Claude Desktop 연결 안내

npm install --global opencode-ai

작업 폴더에서 opencode를 실행하세요. 채팅에서 /connect로 모델 계정을 연결한 뒤 모델을 선택하세요.

OpenCode 설치와 모델 설정

npm 6.4.0 릴리스는 아래 클라이언트를 지원합니다. 클라이언트를 직접 지정하려면 --client에 해당 ID를 넣으세요.

Qoder(qoder), Factory Droid(droid), Trae(trae), ZCode(zcode), DeepSeek Harness(dsh)는 저장소 main에서 사용할 수 있습니다. 소스 빌드나 이 연동을 포함하는 릴리스를 사용하세요.

클라이언트 설정과 문제 해결 · 릴리스별 제공 여부

npx -y rea-agents@6.4.0 mcp

npx rea-agents@latest setup

특정 클라이언트 하나를 지정하려면 해당 설정 ID를 추가하세요.

npx rea-agents@latest setup --client codex

npm이 패키지를 다운로드할지 물으면 y를 입력하고 Enter를 누르세요. REA의 클라이언트 목록에서는 방향키로 이동하고 Space로 클라이언트를 선택한 뒤 Enter로 진행하세요.

데스크톱 앱 (Claude Desktop, Cursor, Windsurf, VS Code): 앱을 완전히 종료한 뒤 다시 여세요. 창만 닫아서는 충분하지 않습니다. macOS에서는 ⌘ Q를 누르세요. Windows에서는 트레이 아이콘이 있다면 그 메뉴에서도 앱을 종료하세요.

터미널 에이전트(Claude Code, Codex, Gemini CLI): 세션을 종료한 뒤 다시 시작하세요.

예제 ZIP 다운로드

에이전트가 파일을 다운로드할 수 없다면 이 압축 파일을 직접 푸세요. 에이전트에게 notes-example 폴더의 경로와 같은 내보내기 질문을 전달하세요.

REA로 /absolute/path/to/app에 있는 앱을 조사해 주세요. 데이터를 내보내는 방식을 찾아 관련 파일과 줄을 보여 주세요.

REA를 실행하는 컴퓨터에 분석 도구 하나를 설치하세요. 호스트는 여러분의 운영체제이고, 대상은 분석하려는 프로그램입니다.

npx -y rea-agents@latest doctor --provider hopper --json

java -XshowSettings:properties -version
javac -version

$env:GHIDRA_INSTALL_DIR = "C:/tools/ghidra_12.1.4_PUBLIC"
$env:JAVA_HOME = "C:/tools/jdk-21"
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup

export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra_12.1.4_PUBLIC"
export JAVA_HOME="/absolute/path/to/jdk-21"

npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup

{
  "command": "idalib-mcp",
  "args": ["--stdio", "--max-workers", "1"],
  "mode": "headless"
}

$env:REA_IDA_MCP_CONFIG = "C:/analysis/ida-mcp.json"
$env:REA_ANALYSIS_PROVIDER = "ida"
npx -y rea-agents@latest doctor --provider ida --json
npx rea-agents@latest setup

export REA_IDA_MCP_CONFIG="/absolute/path/to/ida-mcp.json"
export REA_ANALYSIS_PROVIDER="ida"
npx -y rea-agents@latest doctor --provider ida --json
npx rea-agents@latest setup

연결한 뒤 원본 실행 파일의 전체 경로와 사용할 분석 도구를 에이전트에 알려 주세요.

REA와 제가 설정한 분석 도구로 /absolute/path/to/program를 조사해 주세요. 함수와 문자열을 나열한 뒤, 사용자 입력을 처리하는 부분을 코드 참조와 함께 설명해 주세요.

네이티브 분석 예제 따라 하기

분석할 대상에 맞는 가이드를 여세요. 각 가이드에서 추가 도구, 지원 호스트, 첫 명령어를 안내합니다.

Flutter 가이드 · 패키지와 리소스 · EVM 바이트코드 · 모든 조사 가이드

앱을 실행하지 않고 JavaScript 또는 Electron 앱 폴더나 ASAR 파일을 분석합니다:

npx -y rea-agents@latest analyze-javascript-application "/absolute/path/to/app" --json

경로를 압축을 푼 앱 폴더나 .asar 파일로 바꾸세요. Windows에서는 "D:/apps/example" 같은 경로를 사용할 수 있습니다.

결과에는 앱의 식별 정보, 모듈 간 연결과 소스 위치가 나옵니다. REA가 연결을 확인하지 못한 부분도 표시됩니다.

셸에서 rea 명령을 항상 사용할 수 있도록 설치하려면:

npm install --global rea-agents

JavaScript 앱 가이드 이어서 보기

npx -y rea-agents@latest function "/absolute/path/to/program" main --provider ghidra --json

main을 대상의 함수 목록에 있는 함수 이름이나 주소로 바꾸세요. 먼저 Ghidra를 설정해야 합니다.

macOS나 Linux에서는 Node.js를 준비한 뒤 curl 설치 프로그램을 사용할 수도 있습니다.

curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash

설정 안내에 따라 에이전트를 연결하세요. 안내가 나타나지 않으면 rea setup를 실행하세요.

셸에서 rea를 찾지 못하면 설치 프로그램이 출력한 실행 파일 경로를 사용하세요. Linux의 기본 설정 명령은 "$HOME/.local/bin/rea" setup입니다.

설정 후 클라이언트를 다시 시작하거나 연결하세요. doctor로 REA 연결을 확인할 수 있습니다. Codex의 예:

3단계의 클라이언트 검사에 사용하는 설정 ID를 지정하세요. 편집기 클라이언트에서는 MCP 설정에서 REA를 활성화하고 에이전트 채팅에서 도구 사용을 허용하세요.

사용 중인 분석 도구를 확인하세요. Ghidra의 예:

npx -y rea-agents@latest doctor --provider ghidra --json

보고서에 실패한 검사와 권장 후속 조치가 나옵니다.

Windows 클라이언트와 분석 도구에는 Windows PowerShell을 사용하세요. 에이전트가 WSL 안에서 실행된다면 해당 Linux 환경 안에 Node.js와 REA를 설치하고 Linux 경로를 사용하세요. 헤드리스 분석 도구는 REA와 같은 호스트에서 실행됩니다.

터미널에서는 공백이 있는 경로를 따옴표로 감싸세요.

Windows 설정 명령어:

npx.cmd rea-agents@latest setup

에이전트 연결을 갱신하려면 최신 설정 명령어를 다시 실행하고 계획을 확인한 뒤 클라이언트를 다시 시작하세요.

npx rea-agents@latest setup

전역 CLI를 설치했다면 rea update로 업데이트하세요. REA의 클라이언트 설정과 스킬을 제거하려면 npx rea-agents@latest uninstall을 사용하세요.

업데이트와 제거 상세 안내