플랫폼 가이드
CLI 설치 및 사용
터미널에서 작업을 실행하고 채팅을 재개하며 문제를 진단하세요.
이 가이드는 macOS에서 Remy CLI 설치, 로그인, 로컬 프로젝트 작업 실행, 채팅 재개, CLI 업데이트 및 피드백 보내기를 다룹니다.
흐름도 소스 보기(Mermaid)
flowchart LR
A["Node.js 및 npm 설정"] --> B["Remy CLI 설치"]
B --> C["로그인"]
C --> D["프로젝트로 이동"]
D --> E["작업 시작"]
E --> F["검토 및 계속하기"]
1. 시작하기 전에
1.1 시스템 및 런타임 요구사항
| 필요한 것 | 요구사항 |
|---|---|
| 운영체제 | • 이 가이드는 macOS를 다룹니다. |
| 칩 | • Apple silicon(arm64) • Intel(x64) |
| Node.js 및 npm | • Node.js 18 이상 • 정상 작동하는 npm 설치 |
| 터미널 및 네트워크 | • Mac의 터미널에 접근 가능 • 패키지 설치 및 브라우저 로그인에 필요한 네트워크 접근 |
| Remy 계정 | • Corepass 계정으로 로그인할 수 있습니다. |
| 로컬 프로젝트 | • 프로젝트 폴더가 컴퓨터에 저장되어 있고 접근할 수 있습니다. • 프로젝트 자체 환경과 의존성이 준비되어 있습니다. |
CLI에는 Node.js와 npm이 필요합니다. 표준 npm 방식으로 Remy CLI를 설치할 때는 Python이나 Rust를 별도로 설치할 필요가 없습니다. 프로젝트와 테스트에는 여전히 자체 환경과 의존성이 필요합니다.
터미널에서 설정을 확인하세요.
node --version
npm --version
두 명령 모두 버전 번호를 출력해야 합니다. 하나라도 명령이 없으면 Node.js 웹사이트에서 적절한 Mac 설치 프로그램을 받아 설치를 마친 뒤 새 터미널을 여세요. Remy 설치 전에 현재 LTS 릴리스를 선택하세요.
1.2 모델 접근
Remy 계정으로 로그인하여 해당 계정에서 사용 가능한 모델을 사용하세요. 표준 워크플로에는 별도의 모델 제공업체 계정이나 API 키가 필요하지 않습니다.
데스크톱 앱과 CLI에는 각각 로그인해야 합니다. Remy Desktop에 로그인했더라도 CLI를 처음 사용할 때는 로그인해야 합니다.
2. CLI 설치 및 확인
2.1 Remy CLI 설치
터미널에서 다음을 실행하세요.
npm install -g @corepassinc/remy
설치가 끝날 때까지 기다리세요. 설치 프로그램은 운영체제 및 Node.js 런타임의 아키텍처에 맞는 구성 요소를 선택합니다. Apple silicon 또는 Intel용 CLI 패키지를 별도로 선택할 필요는 없습니다.
2.2 명령 사용 가능 여부 확인
설치 후 다음을 실행하세요.
remy --version
remy --help
| 점검 | 예상 결과 |
|---|---|
| remy --version | • 설치된 CLI 버전을 출력합니다. |
| remy --help | • 명령 도움말과 사용 가능한 옵션을 표시합니다. |
터미널이 remy를 찾지 못하면 새 터미널을 열고 7절의 설치 및 명령 경로 안내를 확인하세요.
3. 로그인 및 계정 확인
3.1 로그인
터미널에서 다음을 실행하세요.
remy login
- 열린 브라우저에서 로그인을 완료하세요.
- 터미널로 돌아와 결과를 기다리세요.
- Signed in as …가 표시되면 다음 단계로 진행하세요.
로그인에 실패하면 터미널 메시지에 따라 연결을 확인하거나 로그인을 다시 시작하세요.
3.2 활성 계정 확인
remy whoami
이 명령으로 로그인한 계정, 현재 계정 범위 및 작업 디렉터리를 확인하세요. 팀 계정을 사용한다면 의도한 팀이 선택되어 있는지 확인하세요.
3.3 런타임 확인
remy doctor
결과를 보고 조치할 사항을 결정하세요.
| 결과 | 대처 방법 |
|---|---|
| 로그인 또는 필수 런타임 점검 통과 | • 프로젝트로 이동하여 작업을 시도하세요. |
| 로그인하지 않음 | • remy login을 실행하고 다시 확인하세요. |
| 저장된 로그인 세션을 사용할 수 없음 | • 메시지에 따라 다시 로그인하세요. |
| 필수 구성 요소가 없거나 시작하지 못함 | • 설치 완료 여부를 확인하고 필요하면 다시 설치하세요. 계속되면 피드백을 보내세요. |
| 선택적 도구를 사용할 수 없음 | • 해당 도구의 요구사항을 확인하세요. • 선택적 도구 하나를 사용할 수 없다고 기본 코딩 작업까지 반드시 불가능한 것은 아닙니다. |
런타임 점검 통과가 전체 작업을 검증한 것은 아닙니다. 실제 작업을 실행하여 모델 접근, 프로젝트 접근 및 결과가 예상대로 동작하는지 확인하세요.
CLI에서 로그아웃하려면 다음을 실행하세요.
remy logout
4. 프로젝트에서 대화형 작업 시작
4.1 프로젝트 폴더로 이동
터미널에서 작업할 프로젝트로 이동한 뒤 Remy를 시작하세요.
cd "/path/to/project"
remy
/path/to/project를 실제 로컬 프로젝트 경로로 바꾸세요.
Remy를 시작할 때 프로젝트 폴더를 지정할 수도 있습니다.
remy --workspace "/path/to/project"
| Remy 시작 방식 | 사용되는 프로젝트 폴더 |
|---|---|
| 프로젝트 폴더에서 remy 실행 | • 터미널의 현재 디렉터리. |
| remy --workspace "/path/to/project" | • 지정한 폴더. |
시작 전에 폴더를 확인하세요. CLI는 현재 작업 디렉터리를 기준으로 동작합니다. 다른 프로젝트에서 작업하려면 대화형 세션을 종료한 뒤 다른 폴더로 이동하거나
--workspace로 Remy를 시작하세요.
4.2 모델 선택 및 작업 보내기
Remy 대화형 인터페이스에서 다음을 수행하세요.
- F2를 누르거나 /model을 입력하여 사용 가능한 모델을 확인하세요.
- 모델을 선택하세요. 추론 설정이 있는 모델은 Ctrl+U로 조정하세요.
- 입력 영역에 작업을 설명하고 Enter를 눌러 보내세요.
macOS 터미널에서 Option+Enter는 줄바꿈을 추가합니다. Ctrl+G를 누르면 키보드 단축키와 사용 가능한 옵션이 표시됩니다.
작업 시작 전에 모델을 선택하세요. CLI에 표시되는 목록은 현재 계정에서 사용 가능한 모델을 반영합니다.
4.3 작은 변경 수행
기존 프로젝트의 실제 문제를 선택하세요. 아래 예시는 주문 목록의 필터링과 페이지 나누기를 사용합니다. 기능과 동작을 자신의 프로젝트에 맞게 바꾸세요.
먼저 관련 코드를 이해하세요.
이 프로젝트의 문서와 관련 지침을 읽으세요.
주문 목록의 파일, 필터링 로직, 페이지 나누기 로직 및 테스트를 식별하세요.
분석만 하세요. 파일 수정, 의존성 설치, 커밋 또는 코드 푸시는 하지 마세요.
Remy가 작업을 이해했는지 확인한 뒤 같은 채팅에서 계속하세요.
주문 목록 3페이지에서 상태 필터를 바꾸면 목록이 비어 보입니다.
1페이지로 돌아가야만 결과가 나타납니다.
문제를 찾아 수정하여 필터가 바뀌면 페이지 번호가 초기화되도록 하세요.
관련 로직만 변경하고 관련 테스트를 추가·실행하세요.
완료되면 변경한 파일, 점검 결과 및 완료하지 못한 점검을 요약하세요.
아직 코드를 커밋하거나 푸시하지 마세요.
Remy가 추가 정보나 확인을 요청하면 응답 전에 요청을 읽으세요. /permissions로 현재 채팅의 작업 권한을 확인하고 인터페이스 안내에 따라 설정을 선택하세요.
4.4 결과 검토 및 계속하기
| 점검 항목 | 확인할 사항 |
|---|---|
| 파일 변경 | • 변경한 파일. • 변경이 작업 범위 안에 있는지. |
| 테스트 및 점검 | • 실제로 실행한 점검. • 통과, 실패 또는 미실행 여부. |
| 동작 | • 원래 재현 단계가 이제 예상대로 동작하는지. |
| 남은 작업 | • 환경 문제, 실패한 점검 또는 사용자의 입력이 필요한 결정 사항. |
Git을 사용하는 프로젝트라면 같은 프로젝트에서 다른 터미널 창을 열어 미커밋 변경을 확인하세요.
git status --short
git diff
기본적으로 git diff는 추적 중인 파일의 스테이징되지 않은 변경을 표시합니다. 새 파일 내용이나 스테이징된 변경은 표시하지 않습니다. 스테이징된 변경에는 git diff --cached를 사용하고 새 파일은 직접 열어 확인하세요. 표시되는 변경에 작업 시작 전부터 있던 작업이 포함될 수도 있습니다.
결과를 개선하려면 원래 채팅에서 일어난 일, 예상한 동작 및 바꿔야 할 점을 설명하세요.
페이지 번호는 이제 초기화되지만 목록이 새로 고쳐지지 않습니다.
필터가 바뀌자마자 새 데이터를 요청해야 합니다.
이 문제만 수정하고 관련 테스트를 추가·실행한 뒤
변경 사항과 점검 결과를 요약하세요. 아직 코드를 커밋하거나 푸시하지 마세요.
4.5 자주 사용하는 키보드 단축키
| 키 | 역할 |
|---|---|
| Enter | • 입력을 보냅니다. 작업 실행 중에는 입력이 대기열에 들어갈 수 있습니다. |
| Option+Enter | • 입력 영역에 줄바꿈을 추가합니다. |
| F2 | • 모델 선택을 엽니다. |
| Ctrl+U | • 사용 가능한 추론 설정을 엽니다. |
| Ctrl+R | • 기존 채팅 목록을 엽니다. |
| Ctrl+G | • 키보드 단축키 도움말을 표시합니다. |
| Ctrl+C | • 선택한 텍스트를 복사할 수 있습니다. • 입력 영역에 초안이 있으면 지웁니다. • 입력 영역이 비어 있으면 실행 중인 작업의 취소를 요청합니다. |
| Ctrl+D | • 유휴 상태일 때 대화형 인터페이스를 종료합니다. |
5. 명령 및 채팅 계속하기
5.1 명령 입력 위치 알아보기
| 명령 유형 | 입력 위치 | 예시 |
|---|---|---|
| 터미널 명령 | • Remy 대화형 인터페이스를 시작하기 전이나 종료한 뒤 시스템 터미널에서 입력합니다. | • remy login • remy doctor • remy exec "작업 설명" |
| 대화형 명령 | • Remy 내부의 입력 영역에 입력합니다. | • /help • /model • /resume |
npm install 같은 설치 명령은 Remy에 작업 프롬프트로 보내지 말고 시스템 터미널에서 실행하세요.
5.2 자주 사용하는 대화형 명령
| 명령 | 역할 |
|---|---|
| /help | • 대화형 명령 도움말을 표시합니다. |
| /model | • 모델을 나열하고 선택할 수 있게 합니다. |
| /new | • 새 채팅을 시작합니다. |
| /resume | • 현재 프로젝트의 기존 채팅을 선택하여 계속할 수 있게 합니다. |
| /resume --last | • 현재 프로젝트의 가장 최근 채팅을 계속합니다. |
| /permissions | • 현재 채팅의 작업 권한을 표시합니다. |
새 채팅을 시작하거나 기존 채팅을 재개하기 전에 현재 작업을 마치고 프로젝트의 실제 파일 상태를 확인하세요.
5.3 이전 채팅 나열
시스템 터미널에서 다음을 실행하세요.
remy history list
활성 계정 범위 안에서 현재 프로젝트의 채팅을 나열합니다. 대화형 인터페이스에서는 /resume 또는 Ctrl+R로 채팅을 선택하여 계속하세요.
볼 수 있는 채팅은 로그인한 계정, 팀 범위 및 프로젝트 폴더에 따라 달라집니다. 로컬 기록에 접근할 수 있다고 모든 기기가 자동 동기화되는 것은 아닙니다.
5.4 일회성 작업 실행
지속적인 대화가 필요 없는 명확한 작업에는 다음을 사용하세요.
remy exec "이 프로젝트의 README를 읽고 프로젝트 및 테스트 실행 방법을 요약하세요. 분석만 하고 파일은 수정하지 마세요."
명령은 해당 작업을 실행하고 결과를 출력합니다. 후속 지침이 필요한 작업은 remy로 대화형 모드를 시작하세요.
로컬 참고 자료를 제공하려면 파일을 첨부하세요.
remy exec --attach "./requirements.md" "이 요구사항을 읽고 이 프로젝트에서 영향을 받는 모듈과 구현 단계를 식별하세요. 아직 파일은 수정하지 마세요."
파일 경로를 컴퓨터에 존재하는 파일로 바꾸세요. 더 많은 옵션은 다음을 실행하여 확인하세요.
remy exec --help
6. Remy CLI 업데이트
6.1 버전 확인
remy --version
6.2 기본 릴리스 업데이트
현재 작업을 마치고 Remy 대화형 인터페이스를 종료한 뒤 다음을 실행하세요.
npm install -g @corepassinc/remy
설치가 끝나면 다시 확인하세요.
remy --version
remy --help
CLI가 여전히 이전 버전을 표시하면 터미널이 찾는 명령을 확인하세요.
command -v remy
npm prefix -g
Node.js 버전 관리자를 사용하면 각 Node.js 환경에 별도의 전역 설치 디렉터리가 있을 수 있습니다. 환경 전환 후 활성 환경에서 Remy 설치와 명령 경로를 확인하세요.
7. 문제 해결 및 알려진 제한 사항
7.1 설치 및 런타임 문제
| 문제 | 먼저 확인할 사항 |
|---|---|
| node 또는 npm을 찾을 수 없습니다 | • Node.js와 npm이 설치되어 있는지 확인하세요. • 새 터미널을 열고 다시 시도하세요. |
| 설치 중 npm이 네트워크 오류를 보고합니다 | • 연결, 프록시 및 npm 서비스 접근을 확인하세요. • 오류 메시지를 보관하고 연결이 복구되면 다시 시도하세요. |
| npm 전역 설치 중 Permission denied가 발생합니다 | • 사용자 계정이 전역 설치 디렉터리에 쓸 수 있는지 확인하세요. • 다시 시도하기 전에 Node.js/npm 설정 및 디렉터리 구성을 검토하세요. |
| remy를 찾을 수 없습니다 | • 설치가 끝났는지 확인하세요. • 새 터미널을 여세요. • npm prefix -g로 현재 전역 설치 위치와 명령 경로를 확인하세요. |
| 업데이트 후에도 이전 버전이 실행됩니다 | • command -v remy로 실제 실행 파일 경로를 확인하세요. • 다른 Node.js 환경이나 이전 설치로 전환하지 않았는지 확인하세요. |
| 로그인하지 않았습니다 | • CLI에서 remy login을 실행하세요. • 데스크톱 앱에 로그인해도 CLI에 로그인되지는 않습니다. |
| 로그인 세션이 더 이상 유효하지 않습니다 | • 메시지에 따라 다시 로그인하세요. 필요하면 remy logout 후 remy login을 실행하세요. |
| 런타임 구성 요소가 없거나 시작되지 않습니다 | • remy doctor로 자세한 내용을 확인하세요. • npm 설치가 완료되었고 플랫폼 구성 요소를 건너뛰지 않았는지 확인하세요. • 재설치로 해결되지 않으면 피드백을 보내세요. |
| Remy가 프로젝트 파일을 찾지 못합니다 | • pwd로 시작한 디렉터리를 확인하세요. • --workspace 경로와 파일 존재 여부를 확인하세요. |
| 프로젝트나 테스트가 실행되지 않습니다 | • 프로젝트 자체 의존성, 환경 및 테스트 명령을 확인하세요. • 실제 오류를 해결한 뒤 계속하세요. |
| 예상한 채팅이 기록에 없습니다 | • 활성 계정, 팀 범위 및 프로젝트 폴더를 확인하세요. • remy whoami로 현재 맥락을 확인하세요. |
| 명령이나 옵션을 인식하지 못합니다 | • remy --version과 remy --help를 확인하세요. • 의도한 릴리스를 사용하는지 확인하세요. 불일치가 계속되면 정확한 명령과 버전을 보고하세요. |
7.2 범위 및 제한 사항
- 이 가이드는 Apple silicon 및 Intel의 macOS를 다룹니다.
- 로컬 작업은 컴퓨터, 터미널 세션 및 프로젝트 환경에 의존합니다. 필요한 환경을 사용 가능한 상태로 유지하세요.
- 도구 접근은 클라이언트마다 다릅니다. 선택적 CLI 도구는 진단 결과와 실제 구성에 따라 달라집니다.
- CLI는 현재 개별 응답에 좋아요/싫어요 평가를 지원하지 않습니다. 제품 문제에는 다음 절의 피드백 명령을 사용하세요.
- 채팅을 재개해도 파일이 롤백되지 않습니다. 계속하기 전에 현재 파일 상태를 확인하세요.
8. 도움 받기 및 피드백 보내기
8.1 명령 도움말 보기
remy --help
remy doctor --help
remy feedback send --help
Remy 안에서는 명령에 /help, 키보드 단축키에 Ctrl+G를 사용하세요.
8.2 문제 설명
문제 설명을 feedback.txt 같은 UTF-8 텍스트 파일로 저장하세요. 재현 단계, 예상한 동작, 실제 동작, 오류 메시지 및 버전 세부 정보를 포함하세요.
8.3 미리 보기 및 제출
먼저 보고서를 미리 확인하세요.
remy feedback send --type bug --impact moderate --description-file "./feedback.txt" --dry-run
--dry-run은 보고서를 보내지 않고 미리 보기를 표시합니다. 설명과 피드백 옵션을 확인한 뒤 해당 플래그를 제거하고 명령을 다시 실행하세요.
remy feedback send --type bug --impact moderate --description-file "./feedback.txt"
CLI는 미리 보기를 표시한 뒤 확인을 위해 send를 입력하도록 요청합니다. 취소하려면 다른 내용을 입력하세요.
| 옵션 | 값 |
|---|---|
| --type | • bug: 제품 문제 • ui: 인터페이스 문제 • performance: 성능 문제 • suggestion: 제안 • other: 기타 |
| --impact | • blocked: 계속할 수 없음 • severe: 큰 영향 • moderate: 부분적인 영향 • minor: 작은 영향 |
문제에 맞는 유형과 영향을 선택하세요. 예시의 bug와 moderate 값은 예시일 뿐입니다.
명령이 성공을 명시적으로 확인하고 피드백 ID를 반환했을 때만 제출된 것으로 판단하세요. Result unknown은 CLI가 신뢰할 수 있는 제출 결과를 받지 못했다는 뜻입니다. 중복 보고를 피하려면 다시 보내기 전에 지원팀에 확인하세요.
CLI 시작, 로그인 또는 피드백 명령을 사용할 수 없으면 support@corepass.com으로 지원팀에 문의하세요.