본문으로 건너뛰기

빠른 시작

설치부터 프로젝트 연결, 첫 대화, 권한 승인, 결과물 확인까지 10분 안에 따라 해 봅니다.

시작하기 전에​

  • 엘리스 계정과, 그 계정이 소속된 기관이 필요합니다. 기관에 헬피코드 이용 권한(모델·토큰)이 있어야 합니다.
  • 데스크톱 앱은 macOS, Windows, Linux를 지원합니다. 웹(런박스)을 쓴다면 설치 단계는 건너뛰세요.

1단계: 설치하고 로그인​

  1. 헬피코드 앱을 설치하고 실행합니다.
  2. 로그인을 누르면 기본 브라우저가 열립니다. 엘리스 계정으로 인증하면 앱 창이 다시 앞으로 나옵니다.
  3. 브라우저에서 로그인이 안 되면 브라우저에서 로그인이 안된다면? 아래의 웹 사이트에서 로그인 코드 받기로 코드를 받아 입력하고 인증을 누릅니다.
  4. 소속 기관이 여러 개면 목록에서 기관을 검색해 선택합니다. 소속 기관이 하나도 없다면 "소속된 기관이 없습니다" 화면이 나오며, 기관에 소속된 계정으로 다시 로그인해야 합니다.
팁

런박스에서는 로그인 화면이 없습니다. 플랫폼이 이미 인증한 상태로 열립니다. 세션이 끝나면 런박스를 다시 시작해야 합니다.

2단계: 프로젝트 연결​

왼쪽 사이드바의 프로젝트 섹션에서 프로젝트 추가를 누릅니다.

  1. 프로젝트명을 입력합니다(최대 50자, 다른 프로젝트와 중복 불가).
  2. 소스 폴더 추가에서 작업할 폴더를 선택합니다(선택 사항).
  3. 만들기를 누릅니다.

폴더를 연결하지 않고 바로 새 대화를 시작해도 됩니다. 이 경우 헬피코드가 임시 작업 폴더를 만들어 그곳에서 작업하며, 나중에 입력창의 프로젝트 추가 칩으로 프로젝트를 연결할 수 있습니다. 자세한 내용은 프로젝트와 작업 폴더를 참고하세요.

3단계: 첫 작업 시키기​

입력창에 하고 싶은 일을 적고 전송합니다. 처음에는 코드를 바꾸지 않는 질문으로 시작해 보세요.

이 프로젝트가 무엇을 하는지 요약해줘
메인 진입점은 어디야?

AI가 파일을 읽으며 답하는 동안 응답이 실시간으로 표시됩니다. 도구 호출은 "{도구} 작업 중..."으로, 추론 과정은 "생각 보기"로 접혀서 표시됩니다. 진행 중에는 언제든 중단할 수 있습니다.

4단계: 코드 바꾸기​

이제 변경을 요청해 봅니다.

README에 설치 방법 섹션을 추가해줘

입력창 아래 수락 모드 칩이 수동 수락(기본값)이면, 파일을 수정하기 전에 권한 패널이 입력창 위에 나타납니다.

선택의미
거부이 작업을 막습니다. AI는 막혔다는 사실을 알고 다른 방법을 찾습니다.
이번만 허용지금 요청만 허용합니다.
항상 허용같은 범위의 비슷한 요청을 계속 허용합니다.

허용하면 AI가 파일을 수정합니다. 권한의 종류와 범위는 권한에서 자세히 설명합니다.

경고

자동 수락 모드는 안전하다고 판단한 작업을 묻지 않고 진행합니다. 처음에는 수동 수락으로 AI가 무엇을 하는지 확인하는 것을 권장합니다.

5단계: 결과 확인​

  • AI가 만든 파일은 답변 아래 파일 카드({파일명} 생성)로 나타납니다. 미리보기로 열거나 파일열기로 폴더에서 확인합니다.
  • 화면 오른쪽 위 폴더 아이콘으로 대화 내 생성파일 패널을, 지구본 아이콘으로 브라우저 패널을 엽니다.

자주 쓰는 입력​

입력동작
/plan코드를 바꾸지 않고 계획만 세우게 합니다.
/compact대화가 길어졌을 때 요약해서 컨텍스트 공간을 확보합니다.
/mcpMCP 서버를 켜고 끕니다.
/init프로젝트용 AGENTS.md 초안을 만듭니다.
Cmd/Ctrl + K대화를 검색합니다.

전체 목록은 슬래시 명령을 참고하세요.

다음 단계​