처음 시작하는 분을 위한 가이드

에이전트는 코드를 읽고 고치거나 명령을 실행할 수 있습니다. 먼저 작업 범위와 권한을 확인하고 작은 작업부터 시작해 보세요.

권한 — Ask, Auto, Plan 모드와 도구 권한 설정을 확인하세요. Ask는 필요한 도구 실행에 승인을 요청합니다. Yolo가 켜져 있으면 개별 도구 실행의 승인을 건너뜁니다. 자세한 내용은 작업 모드와 도구와 권한을 확인하세요. 비용 — 요금제와 결제 화면에서 현재 요금과 이용 조건을 확인하세요. 되돌리기 — /rewind는 사용 가능한 체크포인트로 일부 변경을 복구하는 데 도움이 되지만 백업을 대신하지는 않습니다.

설치 문서의 운영체제별 명령으로 설치하세요. macOS·Linux에서는 command -v mirr로 실행 파일 경로를 확인하고, mirr --version으로 버전을 확인하세요. Windows에서는 새 PowerShell에서 mirr --version을 실행하세요. 경로가 설치 로그와 다르면 기존 실행 파일이 먼저 잡힌 것일 수 있습니다. 확인 후 mirr login을 실행하고 브라우저의 로그인 안내를 마친 뒤 터미널로 돌아오세요.

저장소를 읽기 전에 민감한 정보가 포함되어 있는지 확인하세요. 읽은 코드와 프롬프트는 작업 중 모델에 전달될 수 있으므로 보안과 데이터 처리와 개인정보처리방침을 먼저 확인하세요. Ask 모드에서 "이 저장소가 어떤 일을 하는지 설명해 줘. 파일은 수정하지 마"라고 요청할 수 있습니다. 이 요청은 지시일 뿐 읽기 전용 샌드박스가 아닙니다. Yolo를 끄고 도구 권한 설정과 승인 요청의 경로·명령을 확인하세요. 필요한 경우 운영체제나 별도 격리 환경에서 접근과 쓰기 권한을 제한하세요.

Plan 모드로 작은 변경의 계획을 제안받고 범위를 확인한 뒤 승인하세요. 실행 후에는 결과 diff를 확인하고 테스트하세요.

작업 전에 백업을 저장하고 버전 관리를 사용하세요. /rewind에서 사용 가능한 체크포인트를 선택하고 복구 범위와 경고를 확인할 수 있습니다. 체크포인트가 없거나 일부 파일이 복구되지 않을 수 있습니다. 복구하면 이후 추적된 변경이 덮어써질 수 있으므로 추적되지 않은 파일과 다른 사람이나 프로그램의 변경을 포함해 필요한 내용을 미리 별도로 보관하세요. 외부 서비스 게시, 배포, 데이터베이스 변경 같은 외부 작업은 자동으로 취소되지 않습니다. 복구 후 파일과 테스트를 확인하세요. 자세한 내용은 세션과 복구를 참고하세요.

한글 입력이나 터미널 설정, 사내 프록시, MCP 연결에 문제가 생기면 문제 해결 문서를 확인하세요.

개념이 궁금하면 코딩 에이전트란, 실제 업무 자동화는 활용 사례를 보세요.

1. 민감정보가 없는 연습 폴더와 원본 백업을 준비합니다.
2. 설치·로그인과 실행 파일을 확인하고 Yolo를 끈 뒤 작업 모드와 도구 권한을 확인합니다.
3. 설명부터 요청하고, 작은 변경의 계획을 검토·승인한 뒤 diff와 테스트를 확인합니다.

이 순서는 설치 문서, 작업 모드, 복구 안내를 따라 확인할 항목입니다. 실제 설치 transcript, 첫 작업 화면과 /rewind 화면은 아직 확보하지 않았습니다.

2026-11-03 KST에 macOS arm64의 기존 Mirr v0.6.15 설치에서 한글 파일을 만들고 다시 읽는 작은 합성 과제를 수행했습니다. 비어 있는 일회용 연습 폴더에서 파일 하나를 만들고, 정해 둔 한 줄의 내용과 마지막 줄바꿈을 쓰도록 요청했습니다. 고객 자료나 실제 업무 저장소를 사용한 사례가 아닙니다. 새 설치 과정을 검증한 기록도 아닙니다.

파일을 만든 도구는 38바이트를 기록했다고 보고했고, 같은 파일을 다시 읽은 결과는 한글 파일 이름과 내용이 요청과 같았습니다. 그 뒤 별도의 Node 프로세스가 한글 이름의 실제 파일을 읽어 기대한 문장과 마지막 줄바꿈의 UTF-8 바이트 전체와 비교했고, 일치했습니다. 이 짧은 입력에서 확인한 것은 파일 이름과 내용, 그리고 38바이트라는 결과입니다.

실행은 Auto 권한 모드였고, 규칙에 따른 허용과 모드에 따른 자동 허용이 기록됐습니다. 사람이 승인창을 보고 승인하거나 거절한 시험이 아니며, GUI나 한글 조합 입력, 체크포인트 복구는 확인하지 않았습니다. 앞선 더 큰 CSV 과제 시도는 실행 전에 거부되거나 실행 중 오류로 끝났고, 원인은 확정하지 못했습니다. 이 실패 기록도 남아 있으므로 이 성공 한 건을 서비스 전체의 정상 동작으로 일반화하지 않습니다. 설치 transcript와 첫 작업·복구 화면은 이 과제 하나로 대신하지 않습니다.

이 기록에는 이름을 확인한 모델이나 신뢰할 수 있는 사용량·비용 값이 없습니다. 따라서 무료 이용, 요금제의 모델 이용 권리, 속도나 설치 시간에 대한 주장으로 쓰지 않습니다. 다른 운영체제와 버전의 호환성도 따로 확인이 필요합니다.

설치 직후라면 터미널을 완전히 닫고 새로 연 뒤 mirr --version을 실행하세요. Windows에서도 새 PowerShell 창을 열어야 합니다. 그래도 찾지 못하면 설치 로그의 완료 메시지와 설치 경로를 확인합니다. 기본 실행 파일 위치는 macOS와 Linux에서 ~/.local/bin/mirr, Windows에서 %USERPROFILE%\.local\bin\mirr.exe입니다. 파일은 있는데 명령을 찾지 못한다면 설치 로그의 안내대로 PATH를 설정해야 합니다. PATH는 터미널이 실행할 프로그램을 찾는 폴더 목록입니다. 이 문제를 해결하려고 Node.js나 npm을 설치할 필요는 없습니다.

mirr login을 실행하면 터미널에 로그인 주소와 인증 코드가 표시됩니다. 브라우저를 열지 묻는 안내에서 Enter를 누르고, 열리지 않으면 표시된 주소를 직접 여세요. 브라우저에서 사용할 Patty 계정으로 로그인해 인증을 마친 뒤 터미널로 돌아와 완료 메시지를 확인합니다. 인증이 끝날 때까지는 그 터미널을 열어 두세요. 인증 코드가 만료되면 명령을 다시 실행해 새 주소와 코드를 사용합니다. 브라우저 로그인이 끝났는데 터미널에 완료 메시지가 없다면 웹사이트 로그인과 Mirr Code 연결은 별개이므로 설치와 로그인 문제 문서를 확인하세요.

Mirr Code는 실행한 폴더를 기준으로 프로젝트를 살펴봅니다. 작업할 프로젝트 폴더로 이동한 뒤 mirr를 실행하세요. 예를 들어 cd my-project로 이동하고 실행하는 식입니다. 입력창이 열리면 원하는 결과를 설명하면 됩니다. 이전 대화를 이어가려면 mirr --continue를, 저장된 대화 목록에서 고르려면 mirr --resume을 사용합니다. 대화를 불러오는 것만으로는 파일이 과거 상태로 되돌아가지 않습니다.

입력창에서 Shift+Tab을 누르면 Ask, Auto, Plan 순서로 모드가 바뀝니다. Ask는 필요한 도구 실행에 승인을 요청하므로 처음 쓸 때 실행할 작업을 하나씩 확인하기 좋습니다. Auto는 승인 설정에 따라 자동으로 진행하고 필요할 때 확인을 요청합니다. Plan은 먼저 조사해 계획을 제안하고, 그 계획을 승인하면 실행으로 이어집니다. Yolo 모드는 Ctrl+Y로 켜고 끕니다. Yolo가 켜져 있으면 Shift+Tab으로 모드가 바뀌지 않으므로, 모드를 바꾸려면 먼저 Yolo를 끄세요. 처음 쓰는 폴더에서는 Yolo에 관한 안내가 먼저 나오니 내용을 읽고 선택하면 됩니다.

승인 요청에는 실행하려는 파일 경로와 명령이 표시됩니다. 그 경로와 명령이 요청한 작업과 같은지 확인한 뒤 허용하거나 거절하세요. 의도와 다르면 거절하고 조건을 다시 설명하면 됩니다. 권한 규칙은 작업을 허용하거나, 승인을 요청하거나, 실행을 막을 수 있습니다. 한 번의 승인이 관련 없는 다른 작업까지 허용하지는 않습니다. 실행이 끝난 뒤에도 변경된 파일과 실행한 명령을 기준으로 결과를 다시 확인할 수 있습니다.

비밀번호와 인증 토큰은 대화, 코드, 공개 로그에서 빼 두는 것이 기본 원칙입니다. 도움을 요청할 때도 오류 문구에서 이런 정보를 지운 뒤 전달하세요. 파일을 공유할 때는 작업에 필요한 파일만 고르고, 고객의 개인정보는 미리 가려 두세요. 다른 사람의 자료를 요청에 넣어야 한다면 그 자료를 처리할 권한이 있는지 먼저 확인하세요.

입력창에 !를 먼저 입력하면 뒤에 쓴 내용이 셸 명령으로 컴퓨터에서 직접 실행됩니다. 명령이 어떤 작업을 하는지 확인한 뒤에 사용하세요. 이 명령이 승인 요청을 거치는지는 단축키 문서에 따로 적혀 있지 않으므로, 파일을 바꾸거나 지우는 명령은 직접 확인하고 실행하는 편이 안전합니다.

응답이 멈춘 것 같으면 화면이 파일을 읽는 중인지, 명령을 실행하는 중인지, 승인을 기다리는 중인지 확인하세요. 승인 대기 상태라면 요청된 작업의 허용 여부를 고릅니다. 진행 중인 응답은 Ctrl+C로 중단할 수 있습니다. 다만 중단하기 전에 실행된 파일 수정이나 외부 서비스 작업은 자동으로 취소되지 않습니다. 중단한 뒤에는 같은 대화에서 어디까지 진행됐는지 물어보거나 대화를 다시 불러와 상태를 확인하세요.

주제가 바뀌어 이전 대화가 필요 없다면 /new로 새 대화를 시작합니다. 같은 작업을 이어가면서 대화만 줄이고 싶다면 /compact로 대화를 요약합니다. 긴 대화에서 방향을 바꿀 때는 바뀐 조건을 다시 설명하고, 다른 프로그램에서 파일을 고쳤다면 그 사실도 알려 주세요. 파일을 과거 상태로 되돌리는 것은 /rewind에서 다루는 체크포인트의 역할입니다.

/rewind를 입력하면 현재 대화에서 쓸 수 있는 체크포인트가 표시됩니다. 돌아갈 지점을 고른 뒤 대화만, 파일만, 또는 둘 다 되돌릴지 선택합니다. 목록 선택은 방향키와 Enter로, 취소는 Esc로 합니다. 진행하기 전에 복구 범위와 경고를 읽으세요. 사용할 수 있는 체크포인트가 없거나 일부 파일을 복구할 수 없다면 화면에 안내가 나오고, 복구되지 않은 파일은 따로 확인해야 합니다.

업데이트 전에 실행 중인 Mirr Code를 종료하세요. mirr upgrade를 실행하면 새 버전이 있을 때 내려받아 설치하고, 이미 최신이면 그 사실을 표시합니다. 설치하지 않고 업데이트 여부만 보려면 mirr upgrade --check를 사용하세요. 설치 뒤에는 mirr --version으로 버전을 확인합니다. 다운로드가 실패하면 오류 문구를 보관하고 설치와 로그인 문제 문서를 확인하세요. 이때 npm으로 다시 설치할 필요는 없습니다.

일반적인 사용에는 설정 파일을 직접 고칠 필요가 없습니다. 개인 설정은 macOS와 Linux에서 ~/.mirr/config.toml, Windows에서 %APPDATA%\mirr\config.toml에 있습니다. 프로젝트 설정은 프로젝트 폴더의 mirr.toml입니다. 같은 항목이 여러 곳에 있으면 기본값보다 개인 설정이, 개인 설정보다 프로젝트 설정이, 프로젝트 설정보다 실행할 때 지정한 옵션이 우선합니다. 계정이 제공하는 모델과 서비스 연결은 따로 관리되므로 제공된 접속 정보를 그대로 두세요. 외부 서비스의 비밀번호와 토큰은 일반 프로젝트 설정에 넣지 마세요.

입력창에 /help를 입력하면 도움말을 볼 수 있습니다. /를 입력하면 명령 목록이 열리고, 이름을 검색해 원하는 명령을 고를 수 있습니다. 명령 목록은 한글 이름과 초성으로도 찾을 수 있습니다. 설치한 확장 기능에 따라 추가 명령이 나타날 수 있으니, 목록이 문서와 조금 다르게 보이면 확장 기능 설치 여부를 먼저 확인하세요.

/language ko를 실행하면 화면과 응답의 기본 언어가 한국어로 바뀝니다. /language en이나 /language auto도 쓸 수 있고, /language만 입력하면 현재 언어와 사용할 수 있는 값을 볼 수 있습니다. 특정 요청에만 다른 언어가 필요하다면 요청에 그 언어를 적으면 됩니다. 색상 테마는 /theme에서 고릅니다.

무엇을 바꿀지 아직 정하지 못했다면 “이 프로젝트가 어떤 구조인지 설명해 줘”라는 질문부터 시작해도 좋다고 소개 문서는 안내합니다. 코드를 바로 바꾸기 전에 프로젝트를 이해하는 것부터 할 수 있습니다. 이후 원하는 변경을 설명하고, 수정 범위와 확인 방법을 함께 검토하면 됩니다. 실행 권한이 필요한 작업이 나오면 승인 요청에서 경로와 명령을 확인하는 단계가 그대로 적용됩니다.

대화 화면을 열지 않고 질문 하나만 전달하고 싶다면 mirr -p를 사용합니다. 예를 들어 “이 프로젝트의 실행 방법을 설명해 줘. 파일은 수정하지 마.”라고 쓰고 실행하면 됩니다. 결과를 다른 프로그램에서 처리하려면 --output-format json 옵션을 붙일 수 있습니다. 이때 출력은 요청과 프로젝트에 따라 달라지므로, 자동화에 넣는다면 오류 출력과 종료 코드도 함께 처리해야 합니다.

외부 연결이 필요 없는 일반적인 코딩 작업에는 MCP를 따로 설정할 필요가 없습니다. 이슈 관리나 디자인 도구의 자료를 작업에 참고해야 할 때 /mcp로 연결합니다. 연결 주소와 로그인 방법은 서비스의 공식 MCP 연결 안내에서 확인하고, 문서의 형식 예시를 그대로 쓰지 말고 공식 안내의 실제 주소로 바꿔 입력하세요. 연결 상태와 제공 도구는 다시 /mcp에서 확인합니다.

Enter는 요청을 보내거나 목록에서 선택하고, Shift+Enter는 입력창에서 줄을 바꿉니다. Tab은 명령과 파일의 자동완성 후보를 고르고, Esc는 선택 창을 닫거나 현재 조작을 취소합니다. 목록 항목은 방향키로 고릅니다. 나머지 조작과 macOS의 ⌘Y 같은 단축키는 단축키 문서에서 확인하세요.

입력창에서 /model을 입력하면 모델 선택 화면이 열리고, 현재 모델과 선택할 수 있는 항목을 볼 수 있습니다. 세션을 시작할 때 모델을 직접 지정하려면 mirr --model 옵션을 쓸 수 있습니다. 모델을 바꿔도 파일 수정과 명령 실행 권한은 그대로이므로, 승인 요청은 계속 확인하세요.

입력창에서 /usage를 열면 사용량 안내를 볼 수 있습니다. 화면에 표시된 이용 한도와 계정 상태에 따라 필요한 조치를 진행하세요. 계정 이용 권한이 없다는 오류는 인터넷을 다시 연결한다고 해결되지 않습니다. 로그인한 Patty 계정과 이용 상태를 먼저 확인한 뒤, 안내와 실제 상태가 다르면 오류 문구를 문의 양식으로 보내세요.

mirr --help는 설치된 버전의 명령과 옵션을 보여 줍니다. 터미널 명령 문서에도 자주 쓰는 명령이 표로 정리되어 있으니, 옵션이 헷갈릴 때는 그 문서와 --help 출력을 함께 보세요. 두 결과가 다르다면 설치 버전이 문서와 다를 수 있으므로 mirr --version으로 버전부터 확인하세요.