플랫폼 가이드

데스크톱 설치 및 사용

설치, 로그인, 프로젝트 설정, 변경 검토 및 업데이트 방법을 알아보세요.

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

  1. Mac의 칩에 맞는 DMG를 다운로드하세요.
  2. DMG를 두 번 클릭하고 설치 창의 안내에 따라 Remy를 응용 프로그램으로 옮기세요.
  3. 응용 프로그램 폴더에서 Remy를 여세요.

설치 확인: Remy에 로그인 화면이 열리거나 이미 로그인했다면 작업 공간이 열립니다.

2.2 Windows

  1. Windows x64 EXE 설치 프로그램을 다운로드하세요.
  2. 두 번 클릭하고 설치 마법사를 따르세요.
  3. 설치 폴더를 선택하고 설치를 완료하세요.
  4. 시작 메뉴에서 Remy를 여세요.

설치 확인: Remy에 로그인 화면 또는 작업 공간이 열립니다.

2.3 준비 상태 확인

  • 설치 프로그램이 컴퓨터의 운영체제와 칩에 맞습니다.
  • 앱이 정상적으로 열립니다.
  • Get started를 클릭하면 기본 브라우저에 로그인 페이지가 열립니다.

설치 프로그램이 열리지 않거나 앱이 시작되지 않으면 7절의 해당 문제를 참조하세요.

3. 로그인 및 주요 화면 익히기

3.1 로그인

  1. Remy를 열고 Get started를 클릭하세요.
  2. 기본 브라우저에서 로그인을 완료하세요.
  3. 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 기존 프로젝트 추가

  1. 프로젝트 선택기를 열고 New project를 클릭하세요.
  2. Create project 대화상자에서 Project name을 입력하세요.
  3. Source folders에서 Add folders the agent can read and edit를 클릭하고 코드가 들어 있는 로컬 폴더를 선택하세요.
  4. 이름과 폴더를 확인한 뒤 Create project를 클릭하세요.
  5. 해당 프로젝트에서 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 업데이트 설치

  1. 작업을 저장하고 아직 실행 중인 작업이 있는지 확인하세요.
  2. 업데이트 다운로드가 완료되면 업데이트 안내의 Install Update 또는 사이드바의 Relaunch to update를 클릭하세요.
  3. 안내에 따라 설치를 마치고 앱을 다시 여세요.

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 문제 보고

  1. 관련 채팅의 메뉴를 열고 Send feedback을 선택하세요.
  2. Submit feedback to Remy에서 피드백 유형과 영향 수준을 고른 뒤 문제를 설명하세요.
  3. 필요한 스크린샷이나 첨부 파일을 추가하고 Submit feedback을 클릭하세요.

사이드바의 채팅을 오른쪽 클릭하여 Send feedback을 선택할 수도 있습니다.

재현 방법, 예상한 동작 및 실제로 일어난 일을 설명하세요. 오류 메시지나 관련 스크린샷을 포함하세요.

8.2 응답 평가

응답 아래의 좋아요 또는 싫어요 버튼을 사용하고 도움이 된 점이나 기대에 못 미친 점을 설명하세요. 작업의 목표, 발생한 문제 및 기대한 결과는 개선할 점을 이해하는 데 도움이 됩니다.

피드백 옵션을 찾을 수 없거나 앱을 열 수 없다면 support@corepass.com으로 지원팀에 문의하세요.

8.3 더 알아보기

하려는 일 참고할 곳
첫 코딩 작업 완료 • 빠른 시작
터미널에서 Remy 사용 • CLI 가이드
클라우드 작업 시작 또는 로컬 작업을 클라우드로 이동 • Cloud 가이드
추가 지침 및 자주 묻는 질문의 답변 찾기 • Remy 웹사이트의 Docs