플랫폼 가이드
데스크톱 설치 및 사용
설치, 로그인, 프로젝트 설정, 변경 검토 및 업데이트 방법을 알아보세요.
Remy 설치, 로그인, 프로젝트 설정, 작업 실행, 결과 검토 및 앱 업데이트 방법을 알아보세요. 첫 코딩 작업의 전체 과정은 빠른 시작을 참조하세요.
흐름도 소스 보기(Mermaid)
flowchart LR
A["다운로드 및 설치"] --> B["로그인"]
B --> C["프로젝트 추가"]
C --> D["작업 시작"]
D --> E["결과 검토"]
E --> F["개선 또는 전달"]
1. 시작하기 전에
1.1 올바른 설치 프로그램 선택
| 운영체제 | 칩 / 아키텍처 | 설치 프로그램 |
|---|---|---|
| macOS | Apple silicon | Apple silicon / arm64, DMG |
| macOS | Intel | Intel / x64, DMG |
| Windows | x64 | Windows x64, EXE |
다운로드 페이지에서는 Linux도 제공합니다. 이 가이드는 macOS와 Windows를 다룹니다.
Mac에서는 Apple 메뉴 → 이 Mac에 관하여를 열어 칩이나 프로세서를 확인하세요. Windows에서는 설정 → 시스템 → 정보 → 시스템 종류로 이동하여 아키텍처를 확인하세요.
1.2 계정 및 프로젝트 준비
| 필요한 것 | 확인할 사항 |
|---|---|
| Remy 계정 | • Corepass 계정으로 로그인할 수 있습니다. |
| 인터넷 연결 | • 컴퓨터가 인터넷에 연결됩니다. • 브라우저에서 Remy에 로그인할 수 있습니다. |
| 로컬 프로젝트 | • 프로젝트가 컴퓨터에 저장되어 있고 사용자 계정에서 접근할 수 있습니다. • 프로젝트나 테스트 실행에 필요한 환경과 의존성이 준비되어 있습니다. |
| 모델 접근 | • Remy 계정으로 사용 가능한 모델에 접근할 수 있습니다. • 별도의 모델 제공업체 계정이나 API 키는 필요하지 않습니다. |
프로젝트에는 자체 런타임 요구사항이 있습니다. 데스크톱 앱에는 Remy에 필요한 런타임이 포함되어 있으므로 Remy 사용을 위해 Python이나 Node.js를 설치할 필요가 없습니다. 프로젝트에 해당 도구가 필요하면 프로젝트 문서에 따라 설정하세요.
2. 다운로드 및 설치
Remy 다운로드 페이지에서 설치 프로그램을 받으세요. 위 표에 따라 운영체제와 칩에 맞는 버전을 선택하세요.
2.1 macOS
- Mac의 칩에 맞는 DMG를 다운로드하세요.
- DMG를 두 번 클릭하고 설치 창의 안내에 따라 Remy를 응용 프로그램으로 옮기세요.
- 응용 프로그램 폴더에서 Remy를 여세요.
설치 확인: Remy에 로그인 화면이 열리거나 이미 로그인했다면 작업 공간이 열립니다.
2.2 Windows
- Windows x64 EXE 설치 프로그램을 다운로드하세요.
- 두 번 클릭하고 설치 마법사를 따르세요.
- 설치 폴더를 선택하고 설치를 완료하세요.
- 시작 메뉴에서 Remy를 여세요.
설치 확인: Remy에 로그인 화면 또는 작업 공간이 열립니다.
2.3 준비 상태 확인
- 설치 프로그램이 컴퓨터의 운영체제와 칩에 맞습니다.
- 앱이 정상적으로 열립니다.
- Get started를 클릭하면 기본 브라우저에 로그인 페이지가 열립니다.
설치 프로그램이 열리지 않거나 앱이 시작되지 않으면 7절의 해당 문제를 참조하세요.
3. 로그인 및 주요 화면 익히기
3.1 로그인
- Remy를 열고 Get started를 클릭하세요.
- 기본 브라우저에서 로그인을 완료하세요.
- Remy로 돌아와 작업 공간에 들어가세요.
브라우저 로그인을 기다리는 동안 앱에 Continue signing in with your browser가 표시됩니다.
다시 시작하려면 Cancel sign-in을 클릭한 뒤 Get started를 클릭하세요. 로그인에 실패하면 표시된 메시지에 따라 연결을 확인하거나 다시 로그인하세요.
3.2 주요 제어 기능 찾기
| 제어 기능 | 역할 |
|---|---|
| 사이드바의 프로젝트 및 채팅 | • 기존 프로젝트와 이전 대화를 찾습니다. • 작업 간에 전환합니다. |
| New chat | • 새 대화를 시작합니다. |
| 프로젝트 선택기 | • 기존 프로젝트를 선택합니다. • New project를 선택하여 프로젝트를 만듭니다. |
| 메시지 입력란 | • 작업을 설명하거나 요구사항을 추가합니다. • 모델 및 사용 가능한 추론 설정을 선택합니다. |
| Explorer | • 프로젝트 파일과 폴더를 탐색합니다. |
| Changes | • Git 프로젝트의 미커밋 변경과 파일 diff를 검토합니다. |
| 사이드바 아래의 계정 메뉴 → Settings | • 앱 설정을 변경합니다. |
| 채팅 메뉴 → Send feedback | • 현재 채팅의 문제를 보고합니다. |
설정 열기: 사이드바 아래의 계정을 클릭하고 Settings를 선택하세요. 로그아웃하려면 계정 메뉴에서 Log out을 선택하세요.
4. 프로젝트 및 채팅 사용
4.1 기존 프로젝트 추가
- 프로젝트 선택기를 열고 New project를 클릭하세요.
- Create project 대화상자에서 Project name을 입력하세요.
- Source folders에서 Add folders the agent can read and edit를 클릭하고 코드가 들어 있는 로컬 폴더를 선택하세요.
- 이름과 폴더를 확인한 뒤 Create project를 클릭하세요.
- 해당 프로젝트에서 New chat을 클릭하여 작업을 시작하세요.
대부분의 경우 문서, 소스 코드 및 빌드 구성이 들어 있는 프로젝트 루트 폴더를 선택하세요. 예를 들면 다음과 같습니다.
example-project/ ← 이 폴더를 추가하세요
├── README.md
├── package.json ← 프로젝트 환경 및 의존성(예시)
├── src/
└── tests/
예시 폴더 구조입니다. 실제 파일 이름은 프로젝트에 따라 달라집니다.
Source folders는 Remy가 읽고 수정할 수 있는 프로젝트 폴더입니다. 생성 전에 의도한 프로젝트를 선택했는지 확인하고 프롬프트에 각 작업의 범위를 설명하세요.
4.2 여러 폴더 사용
예를 들어 프런트엔드와 백엔드가 별도 폴더에 있다면 Source folders 아래의 Add folder를 클릭하여 둘 다 포함하세요.
| 폴더 역할 | 사용 방식 |
|---|---|
| 첫 번째 폴더 | • 프로젝트의 기본 폴더가 됩니다. |
| 추가 폴더 | • 해당 폴더가 필요한 작업을 위해 프로젝트에 포함됩니다. |
| 파일 및 변경 보기 | • 여러 폴더가 있는 프로젝트에서는 파일이나 diff를 검토하기 전에 확인할 폴더를 선택하세요. |
요구사항을 추가할 때 관련 폴더를 명시하여 Remy가 이름만 보고 추측하지 않도록 하세요.
이 프로젝트는 프런트엔드와 백엔드 폴더가 분리되어 있습니다.
프런트엔드에서 보내는 매개변수가 백엔드의 검증 규칙과 일치하는지 확인하세요.
관련 파일과 차이점을 나열하세요.
분석만 하세요. 파일은 수정하지 마세요.
4.3 새 채팅 시작 또는 기존 채팅 계속하기
| 하려는 일 | 권장 동작 |
|---|---|
| 새 작업 시작 | • 관련 프로젝트를 선택하고 New chat을 클릭하세요. |
| 같은 작업에 요구사항 추가 | • 원래 채팅을 열고 계속하세요. |
| 결과 개선 | • 원래 채팅에서 일어난 일, 예상한 동작 및 바꿔야 할 점을 설명하세요. |
| 다른 프로젝트에서 작업 | • 새 채팅을 시작하기 전에 해당 프로젝트를 선택하세요. |
작업을 시작하기 전에 현재 프로젝트 이름과 폴더를 확인하세요. 새 채팅에서는 목표와 제약 조건을 다시 설명하세요.
5. 작업 실행 및 결과 검토
5.1 모델 선택 및 작업 설명
메시지 입력란 옆에서 사용 가능한 모델을 선택하고 제공되는 경우 추론 설정을 조정하세요. Dynamic을 선택하여 Remy가 모델을 고르고 작업 진행이 막히면 더 강력한 모델로 전환하도록 할 수도 있습니다. 자동 선택된 모델은 표시되지 않습니다.
현재 작업 실행 중에는 사용자가 수동으로 모델을 전환할 수 없습니다. 사용 가능한 모델과 추론 설정은 앱에 표시되는 옵션을 확인하세요.
수행 방법이 명확하고 결과를 확인하기 쉬운 작업을 Remy에 주세요.
| 포함할 세부 사항 | 예시 |
|---|---|
| 작업 대상 | • 주문 목록의 필터링 및 페이지 나누기. |
| 예상 결과 | • 필터를 변경하면 목록이 1페이지로 돌아가 올바른 결과를 표시합니다. |
| 범위 | • 관련 로직만 변경하고 다른 페이지는 건드리지 마세요. |
| 점검 | • 관련 테스트를 추가하고 실행하세요. • 변경한 파일과 점검 결과를 요약하세요. |
| 전달 | • 아직 코드를 커밋하거나 푸시하지 마세요. |
5.2 작업 템플릿 사용
예시의 기능과 동작을 자신의 프로젝트에 맞게 바꾸세요.
버그 찾기 및 수정
주문 목록 3페이지에서 상태 필터를 바꾸면 목록이 비어 보입니다.
1페이지로 돌아가야만 결과가 나타납니다.
원인을 찾고 필터가 바뀌면 페이지 번호를 초기화하세요.
관련 테스트를 추가하고 실행하세요.
관련 로직만 변경한 뒤 변경한 파일, 점검 결과 및 완료하지 못한 점검을 요약하세요.
아직 코드를 커밋하거나 푸시하지 마세요.
수정 없이 기존 변경 검토
현재 미커밋 변경을 검토하세요.
필터링, 페이지 나누기 및 정렬의 상호작용과 누락된 경계 사례에 집중하세요.
파일 위치, 발생 조건 및 수정 제안과 함께 심각도순으로 문제를 나열하세요.
아직 파일 수정, 커밋 또는 코드 푸시는 하지 마세요.
첫 코딩 작업의 전체 과정은 빠른 시작을 참조하세요.
5.3 작업 중 맥락 추가
Remy가 추가 정보나 확인을 요청하면 응답 전에 요청을 읽으세요. 요구사항이 바뀌면 같은 채팅에서 새 범위를 설명하세요.
제약 조건 추가: 이 변경은 프런트엔드에서만 수행하세요. API는 변경하지 마세요.
접근 방식에 API 변경이 필요하다면 이유와 영향을 설명한 뒤 제 확인을 기다리세요.
5.4 파일 및 변경 검토
- Explorer로 프로젝트 파일을 탐색하고 확인할 파일을 여세요.
- Changes로 Git 작업 트리의 변경 사항을 검토하세요. 파일을 선택하여 추가, 삭제 또는 수정된 내용을 확인하세요.
- 패널이 열려 있지 않으면 패널 추가 메뉴에서 Explorer 또는 Changes를 선택하세요.
Changes는 현재 Git 작업 트리를 표시합니다. 작업 시작 전부터 있던 미커밋 작업이 포함될 수 있습니다. 해당 변경을 이번 작업의 변경과 구분하세요. Git 저장소 밖의 폴더에는 HEAD 대비 diff가 없으므로 파일과 작업 요약을 직접 확인하세요.
5.5 작업 완료 여부 확인
| 점검 항목 | 확인할 사항 |
|---|---|
| 변경 범위 | • 요청한 작업을 해결하는 변경입니다. • 관련 없는 파일을 변경하지 않았습니다. |
| 실행 기록 | • 테스트 또는 점검이 실제로 실행되었습니다. • 실행하지 못한 점검에는 설명이 있습니다. |
| 동작 | • 원래 재현 단계에서 더 이상 문제가 발생하지 않습니다. • 새 기능이 합의된 요구사항을 충족합니다. |
| 남은 작업 | • 실패한 점검, 환경 문제 또는 사용자의 입력이 필요한 결정 사항. |
추가 작업이 필요하면 원래 채팅에서 구체적인 문제를 설명하세요. 예를 들면 다음과 같습니다.
필터를 바꾸면 페이지 번호는 1로 초기화되지만 목록이 새로 고쳐지지 않습니다.
필터가 바뀌자마자 새 데이터를 요청해야 합니다.
이 문제만 수정하고 관련 테스트를 추가·실행한 뒤
변경 사항과 점검 결과를 요약하세요. 아직 코드를 커밋하거나 푸시하지 마세요.
6. Remy 업데이트
6.1 버전 확인
macOS에서는 Remy → About Remy를 열어 앱 버전을 확인하세요.
피드백 대화상자에서도 Information included automatically 위에 마우스를 올려 보고서에 포함되는 Remy version과 기타 정보를 확인할 수 있습니다.
6.2 업데이트 확인
| 운영체제 | 이동할 위치 |
|---|---|
| macOS | • 화면 위쪽 메뉴 막대: Remy → Check for Updates… |
| Windows | • 앱 메뉴: Help → Check for Updates… |
다음 메시지 중 하나가 표시될 수 있습니다.
| 메시지 | 다음 단계 |
|---|---|
| 현재 사용 가능한 업데이트가 없습니다. | • 현재 버전을 계속 사용하세요. |
| 새 버전 …을 사용할 수 있습니다. | • 백그라운드 다운로드가 끝날 때까지 기다린 뒤 업데이트를 설치하세요. |
| Remy가 업데이트를 다운로드하고 있습니다. | • 다운로드가 끝날 때까지 기다리세요. |
| 업데이트를 확인할 수 없습니다. | • 연결을 확인하고 표시된 오류에 따라 다시 시도하세요. 계속되면 문제를 보고하세요. |
6.3 업데이트 설치
- 작업을 저장하고 아직 실행 중인 작업이 있는지 확인하세요.
- 업데이트 다운로드가 완료되면 업데이트 안내의 Install Update 또는 사이드바의 Relaunch to update를 클릭하세요.
- 안내에 따라 설치를 마치고 앱을 다시 여세요.
Remy가 작업 실행 중이라고 알리면 작업을 마친 뒤 재시작하여 업데이트하세요.
7. 문제 해결 및 알려진 제한 사항
7.1 설치, 로그인 및 작업 문제
| 문제 | 먼저 확인할 사항 |
|---|---|
| 설치 프로그램이 열리지 않습니다 | • 다운로드가 완료되었는지 확인하세요. • 운영체제와 칩에 맞는지 확인하세요. • 웹사이트에서 올바른 설치 프로그램을 다시 받고 보고를 위해 정확한 시스템 메시지를 보관하세요. |
| 설치 후 앱이 시작되지 않습니다 | • 설치가 끝났으며 설치된 앱을 여는지 확인하세요. • 지원팀에 전달할 운영체제, 설치 파일 이름 및 오류 메시지를 기록하세요. |
| 브라우저 로그인 후에도 앱이 기다립니다 | • 브라우저 로그인을 완료했는지 확인하세요. • Remy로 돌아와 표시된 메시지를 읽으세요. 다시 시도하려면 Cancel sign-in을 클릭한 뒤 Get started를 클릭하세요. |
| 로그인 시 네트워크 또는 프록시 오류가 표시됩니다 | • 연결 또는 프록시를 확인하세요. • 연결이 복구되면 로그인을 다시 시작하세요. |
| Remy가 프로젝트 파일을 찾지 못합니다 | • 채팅이 올바른 프로젝트에 속하는지 확인하세요. • Source folders에 대상 폴더가 포함되는지 확인하세요. • 파일이 로컬에 저장되어 있고 접근 가능한지 확인하세요. |
| 프로젝트나 테스트가 실행되지 않습니다 | • 프로젝트 환경과 의존성을 확인하세요. • 테스트 명령이 이 프로젝트에 맞는지 확인하세요. • 실제 오류를 해결한 뒤 점검을 다시 실행하세요. |
| Changes에 예상한 diff가 표시되지 않습니다 | • 올바른 폴더를 보고 있는지 확인하세요. • 미커밋 변경이 있는 Git 저장소인지 확인하세요. • 실제 파일과 작업 요약도 확인하세요. |
| 업데이트 다운로드에 실패합니다 | • 연결을 확인하고 업데이트 제어 기능에서 다시 시도하세요. • 계속 실패하면 오류를 기록하고 피드백을 보내세요. |
7.2 알려진 제한 사항
- 작업 실행 중에는 사용자가 수동으로 모델을 전환할 수 없습니다. Dynamic은 더 강력한 모델로 자동 전환할 수 있습니다.
- Branch는 새 채팅 분기를 만듭니다. 파일 변경을 되돌리지는 않습니다.
- Browser Use와 Computer Use는 현재 macOS만 지원합니다.
- 로컬 프로젝트에서 작업할 때는 컴퓨터, Remy 및 작업에 필요한 환경을 사용 가능한 상태로 유지하세요. 클라우드 작업은 Cloud 가이드를 참조하세요.
8. 도움 받기 및 더 알아보기
8.1 문제 보고
- 관련 채팅의 메뉴를 열고 Send feedback을 선택하세요.
- Submit feedback to Remy에서 피드백 유형과 영향 수준을 고른 뒤 문제를 설명하세요.
- 필요한 스크린샷이나 첨부 파일을 추가하고 Submit feedback을 클릭하세요.
사이드바의 채팅을 오른쪽 클릭하여 Send feedback을 선택할 수도 있습니다.
재현 방법, 예상한 동작 및 실제로 일어난 일을 설명하세요. 오류 메시지나 관련 스크린샷을 포함하세요.
8.2 응답 평가
응답 아래의 좋아요 또는 싫어요 버튼을 사용하고 도움이 된 점이나 기대에 못 미친 점을 설명하세요. 작업의 목표, 발생한 문제 및 기대한 결과는 개선할 점을 이해하는 데 도움이 됩니다.
피드백 옵션을 찾을 수 없거나 앱을 열 수 없다면 support@corepass.com으로 지원팀에 문의하세요.