OrangeTree Cloud

앱 설치 및 실행

npm으로 설치하고, 앱에서 한 번 ‘연결’하면 끝입니다. 환경변수 설정도, 토큰 복사도 필요 없습니다.

1 · 사전 준비

먼저 이 두 가지를 설치하세요.

⬢

Node.js 20 이상

OrangeTree 앱이 Node.js로 실행됩니다. LTS 버전을 권장합니다.

Node.js 설치 →

확인: node -v

✶

Claude CLI (Claude Code)

AI 작업을 수행하는 런타임입니다. 설치 후 claude login으로 로그인하세요.

Claude Code 설치 안내 →

확인: claude --version

2 · 설치 & 실행

터미널에서 두 줄, 그리고 한 번의 연결.

  1. 1

    설치

    npm으로 전역 설치합니다.

    npm install -g @orangeworks/orangetree

    한 번만 실행해 볼 거라면 npx @orangeworks/orangetree

  2. 2

    실행

    실행하면 브라우저가 자동으로 열립니다 (로컬 모드).

    orangetree

    콘솔에 Orange Tree -> http://127.0.0.1:4100 [local] 가 보이면 정상입니다.

  3. 3

    클라우드에 연결

    앱 상단 툴바의 [🔗 연결] 버튼을 누르면 짧은 코드가 표시됩니다 — 이 사이트에서 승인하면 자동으로 페어링되어 외부에서도 접속할 수 있습니다. (토큰을 복사·붙여넣을 필요가 없습니다.)

    연결 PC 관리로 →

    ⚠ 외부 접속(원격 연결)에는 활성 구독이 필요합니다.

자주 묻는 문제

“claude CLI를 찾을 수 없다”고 나와요

Claude Code를 설치하고 claude login으로 로그인하세요. 앱은 이 CLI로 AI 작업을 수행합니다.

포트 4100이 이미 사용 중이에요

앱이 자동으로 비어 있는 다음 포트를 선택합니다. 콘솔에 표시된 주소를 사용하세요.

어떤 OS를 지원하나요

Windows · macOS · Linux를 지원합니다. 원격 터널 구성요소는 첫 연결 시 자동으로 내려받습니다.