데스크톱과 런박스
헬피코드는 데스크톱 앱과 런박스(웹) 두 환경에서 실행됩니다. 둘의 차이와 런박스 운영 방법을 설명합니다.
한눈에 비교
| 항목 | 데스크톱 앱 | 런박스 |
|---|---|---|
| 실행 위치 | 내 PC(macOS, Windows, Linux) | 엘리스 클라우드 컨테이너 |
| 화면 접속 | 앱 창 | 브라우저 |
| 로그인 | 시스템 브라우저 OAuth(+코드 로그인) | 없음. 플랫폼이 토큰을 주입 |
| 로그아웃·기관 변경 | 프로필 메뉴에 있음 | 없음 |
| 기관 결정 | 로그인 후 선택 | 컨테이너가 속한 기관으로 자동 결정, 맞는 기관이 없으면 선택 화면 |
| 작업 폴더 | 내 PC의 폴더(OS 폴더 선택) | 컨테이너 안의 경로 |
| 브라우저 패널 | 내장 네이티브 브라우저(탭) | iframe + 포트별 미리보기 주소 |
| 파일열기 | 탐색기에서 표시 | 해당 없음 |
| 업데이트 | 다운로드 안내 | 재시작 시 자동 다운로드 |
| 세션 만료 | 재로그인 | 런박스 재시작 |
| 창·단축키 | 단일 인스턴스, 최소 1024×700, Cmd/Ctrl+K | 브라우저 창 |
두 환경 모두 같은 호스트 서버와 AI 엔진을 사용하므로 프로젝트 지침, 스킬, 서브에이전트, MCP, 권한 동작은 같습니다.
데스크톱 앱
동작
- 단일 인스턴스: 앱을 다시 실행하면 기존 창이 복원되어 앞으로 나옵니다.
- 창: 최소 1024×700. macOS·Windows는 숨김 타이틀바를 쓰고 전체 화면 상태가 화면에 전달됩니다.
- 링크: 외부 링크는 시스템 기본 브라우저에서 열리고, 앱 창은 외부 주소로 이동하지 않습니다.
- 권한: 웹 권한 요청은 클립보드 쓰기만 허용하고 나머지는 거부합니다.
- 포트: 마지막에 쓴 서버 포트를 기억해 다음 실행에서 재사용합니다. MCP OAuth 리디렉션 주소가 바뀌지 않게 하기 위해서이며, 포트가 막혀 있으면 OS가 빈 포트를 고릅니다.
- 사내 프록시 환경: 시스템 인증서(CA)를 신뢰하도록 설정되어 있어 사내 TLS 검사 프록시에서도 동작합니다.
- 종료: 앱을 닫으면 엔진 프로세스를 정리한 뒤 종료합니다.
- 엔진 비정상 종료: 치명적이면 "Helpy Code stopped" 오류창을 띄우고 앱을 종료합니다.
런박스
런박스는 엘리스 클라우드 컨테이너에서 헬피코드를 웹으로 제공하는 방식입니다. 설치 없이 브라우저로 접속해 사용합니다.
로그인과 기관
- 로그인·로그아웃·기관 변경 메뉴가 없습니다. 플랫폼이 컨테이너 소유자의 계정으로 인증한 상태로 앱을 띄웁니다.
- 기관은 컨테이너가 속한 기관으로 자동 결정됩니다. 맞는 기관을 찾지 못하면 기관 선택 화면이 나오고, 소속된 기관이 없으면 "기관에 소속된 뒤 런박스를 다시 시작해 주세요."가 표시됩니다.
- 세션은 사용하는 동안 자동으로 갱신됩니다. 더 이어갈 수 없으면 "세션이 만료되었습니다 — 런박스를 다시 시작해 주세요."가 표시됩니다.
- 인증 정보는 AI 도구가 읽을 수 없도록 보호됩니다.
업데이트
새 버전이 나오면 사이드바에 "New — 업데이트가 있습니다." 배너가 나타나고, 런박스를 재시작하라는 안내가 표시됩니다. 재시작하면 최신 버전을 자동으로 받아 실행합니다.