Claude Code에서 미르 코드(Mirr Code)로: 설정을 다시 만드는 순서

옮기기 전에: 무엇이 달라지는가#

Claude Code를 바로 삭제하지 말고 기존 작업을 보관한 상태에서 작은 프로젝트로 병행해 보세요. Mirr에서 읽기나 MCP 연결을 포함한 어떤 작업을 요청하기 전에도 Yolo를 끄고 Ask 모드를 선택한 뒤 작업별 권한 규칙을 확인하세요. 저장소에 남는 파일과 각 도구가 별도로 관리하는 설정은 다릅니다. 아래는 공식 문서에서 확인한 기능과 이전 시 직접 확인할 항목입니다. 자동 이전을 검증한 결과는 아닙니다.

옮겨지는 것과 안 옮겨지는 것 (table)#

공개 보류 조건: 원래 이전 가이드는 CLAUDE.md·훅·서브에이전트의 Mirr 이전 동작을 제품 문서로 확인한 뒤 공개하도록 정했습니다. 동등한 적용·실행은 아직 검증되지 않았습니다. 아래 표는 점검할 목록이며 실제 이전 성공표가 아닙니다.

Claude 공식 문서는 링크별로 2026-11-03에 확인했습니다. 연결된 Mirr 문서는 MCP 기준 2026-10-16 검증으로 표시되어 있으며, 이 표는 실제 이전 결과가 아닙니다.

설치와 로그인#

운영체제별 명령, 버전 확인과 로그인은 Mirr 설치 문서를 따르세요. 이 문서의 검증일 표시는 2026-10-15입니다. 실행 전 설치 스크립트의 출처와 조직 정책을 확인하세요.

남은 검증: 이 페이지에서는 설치와 로그인을 직접 실행하지 않아 transcript가 없습니다.

규칙과 MCP 다시 연결#

1. CLAUDE.md, 규칙, 훅과 서브에이전트를 목록화하고 보안상 필수인 통제를 구분합니다. 원본은 보관하고 자동 호환을 가정하지 마세요.
2. 필요한 지침만 민감정보를 제외해 Mirr 작업에 직접 전달합니다. 지침은 보안 통제를 대체하지 않으므로 필수 검사는 별도로 유지하세요.
3. 필요한 MCP 서버의 공식 주소와 인증 방식을 확인한 다음 Mirr의 /mcp 안내에 따라 연결합니다. 서버 출처와 제공 도구를 검토하고 가능하면 읽기 전용 권한부터 부여하세요.
4. 토큰·비밀번호는 대화, 프로젝트 파일, 공유 로그에 넣지 마세요. 연결 제거와 서비스 측 권한 철회는 별도로 확인합니다.

남은 검증: 실제 지침 재작성과 MCP 재연결 transcript는 아직 없습니다.

CLAUDE.md가 저장소에 남아 있어도 Mirr가 같은 범위로 읽는다고 가정하지 마세요. 필요한 내용을 직접 검토해 요청에 전달하고 작은 과제의 결과로 확인합니다. 훅이나 서브에이전트가 없는 것처럼 보이면 자동 변환을 시도하기보다 필수 통제를 기존 CI·별도 절차로 유지하세요. MCP 오류는 주소·인증·도구 목록을 나눠 조사합니다.

CLAUDE.md가 읽히는 범위와 AGENTS.md 처리#

Claude Code는 실행한 작업 디렉터리에서 상위 폴더로 올라가며 CLAUDE.md와 CLAUDE.local.md를 찾고, 찾은 내용을 서로 덮어쓰지 않고 이어 붙입니다. 상위 폴더의 파일이 먼저 들어가고 실행 위치에 가까운 파일이 나중에 읽힙니다. 하위 폴더의 CLAUDE.md는 실행할 때 모두 읽지 않고, Claude가 그 폴더의 파일을 읽거나 고칠 때 한 번씩 불러옵니다. 블록 단위 HTML 주석은 컨텍스트에 넣기 전에 제거되므로 사람만 보는 메모를 적을 수 있습니다.

AGENTS.md는 조건부로 읽힙니다. 작업 디렉터리나 그 상위에 CLAUDE.md, .claude/CLAUDE.md, CLAUDE.local.md 중 하나라도 있으면 AGENTS.md는 읽히지 않습니다. 따라서 개인용 CLAUDE.local.md를 하나 두면 같은 저장소의 AGENTS.md가 빠집니다. 두 파일을 모두 읽히게 하려면 프로젝트 지침 설정을 바꾸거나 CLAUDE.md에 @AGENTS.md를 적어 가져옵니다. AGENTS.md를 직접 읽는 기능은 v2.1.277 이상에서 쓸 수 있고, 그 밖의 버전이나 일부 세션에서는 CLAUDE.md만 읽힙니다. 한 파일이 4MiB를 넘으면 Claude Code는 그 파일을 통째로 건너뜁니다.

자동 메모리 저장 위치와 로드 한도#

Claude Code의 자동 메모리는 작업 중 Claude가 스스로 남기는 기록입니다. 기록은 사용자 정보, 피드백, 프로젝트 진행 상황, 외부 참고 위치의 네 종류이며, 코드에서 바로 알 수 있는 구조나 파일 경로는 저장하지 않는다고 문서가 설명합니다. 프로젝트별 기록은 ~/.claude/projects/<project>/memory/ 아래에 쌓이고, 같은 저장소의 워크트리와 하위 폴더는 이 폴더를 함께 씁니다. 각 기록은 일반 마크다운 파일이라 직접 고치거나 지울 수 있습니다. 머리말이 있는 기록은 쓰기 시각이 modified 항목에 남습니다. 서브에이전트는 메인 대화의 자동 메모리를 읽지 않으며(포크는 예외), memory 필드로 자기 메모리 폴더를 따로 켤 수 있습니다. 자동 메모리 위치는 autoMemoryDirectory 설정으로 바꿀 수 있으며, 절대 경로나 ~/로 시작하는 경로여야 합니다.

새 대화에서는 MEMORY.md 색인의 처음 200줄 또는 25KB 중 먼저 도달하는 분량만 읽힙니다. 그 이상은 다음 로드 때 빠지므로 세부 내용은 주제별 파일로 나누라고 문서가 권합니다. Mirr 한국어 문서에는 자동 메모리에 해당하는 기능과 저장 위치가 나오지 않으므로, 옮기기 전에 이 폴더를 검토해 필요한 내용만 직접 전달하세요.

권한 규칙이 적용되는 순서#

Claude Code의 권한 규칙은 거부(deny), 묻기(ask), 허용(allow) 순서로 평가하며, 처음 일치한 규칙이 결과를 정합니다. 규칙이 구체적이라고 순서가 바뀌지 않습니다. 예를 들어 Bash(aws *) 같은 넓은 거부 규칙은 더 좁은 허용 규칙 Bash(aws s3 ls)에도 걸리므로, 허용 규칙으로 예외를 만들 수 없습니다. 도구 이름만 적은 거부 규칙은 그 도구를 Claude의 맥락에서 아예 뺍니다. Read(./.env)처럼 경로를 적은 읽기 거부는 내장 파일 도구뿐 아니라 cat, head, tail, sed, tee 같은 셸 명령의 읽기에도 적용됩니다. 거부 규칙은 심볼릭 링크가 가리키는 파일에도 적용되므로 링크를 통한 우회가 막힙니다. 셸의 출력 리다이렉션(> 파일)도 편집 규칙의 적용을 받습니다.

설정의 우선순위에서는 관리 설정이 가장 높습니다. 어느 범위에서든 거부 규칙이 있으면 다른 범위의 허용 규칙이 이기지 못합니다. PreToolUse 훅이 허용을 반환해도 거부와 묻기 규칙은 그대로 적용되며, 종료 코드 2로 막은 훅은 권한 규칙을 평가하기 전에 호출을 차단합니다. Mirr 한국어 문서는 권한 규칙의 평가 순서를 설명하지 않으므로, Claude의 순서를 그대로 옮긴다고 가정하지 말고 같은 규칙이 같은 결과를 내는지 작은 과제로 확인하세요.

훅 종료 코드와 실패 처리#

Claude Code 훅은 ~/.claude/settings.json, 프로젝트의 .claude/settings.json, 개인용 .claude/settings.local.json, 플러그인의 hooks/hooks.json에 정의합니다. 팀이 함께 쓸 정책은 프로젝트 설정 파일에 두고, 개인 실험 훅은 로컬 설정 파일에 둡니다. 클라우드 세션은 로컬 ~/.claude/settings.json을 읽지 않습니다.

종료 코드 2는 차단입니다. 차단할 수 있는 이벤트에서 PreToolUse 훅이 종료 코드 2를 내면 도구 호출이 막힙니다. 종료 코드 1을 포함한 그 밖의 종료 코드, 실행 실패, 잘못된 JSON은 대부분 작업을 그대로 진행시킵니다. PreToolUse 훅이 시간 초과되어도 호출은 막히지 않습니다. 정책을 강제하는 훅이라면 onFailure 값을 "block"으로 설정해 실패를 차단으로 바꿔야 합니다. 공식 문서는 정책 훅에서 종료 코드 1 대신 2를 쓰라고 권합니다. 모든 훅을 잠시 끄려면 설정 파일에 disableAllHooks를 둘 수 있습니다. 사용자 입력 단계의 UserPromptSubmit 훅도 종료 코드 2를 내면 입력을 거절할 수 있습니다. 백그라운드로 실행되는 asyncRewake 훅은 종료 코드 2를 내면 실행 중인 Claude를 깨우고, 표준 오류 출력을 알림으로 전달합니다.

서브에이전트 파일 위치와 권한 필드#

Claude Code는 서브에이전트 정의를 여러 위치에서 찾고, 같은 이름이 있으면 우선순위가 높은 위치의 정의를 씁니다. 우선순위는 관리 설정, --agents 플래그, 프로젝트의 .claude/agents/, 사용자 홈의 ~/.claude/agents/, 플러그인의 agents/ 순서입니다. 프로젝트의 .claude/agents/에 둔 파일은 저장소에 커밋해 팀이 함께 쓸 수 있습니다.

옮길 때 중요한 머리말 항목은 tools, disallowedTools, permissionMode, isolation, memory입니다. tools를 생략하면 서브에이전트가 쓸 수 있는 도구를 모두 상속하고, disallowedTools는 상속받았거나 지정한 목록에서 도구를 뺍니다. permissionMode는 default, acceptEdits, auto, dontAsk, bypassPermissions, plan, manual 중 하나입니다. isolation: worktree를 쓰면 서브에이전트가 임시 Git 워크트리 안에서 실행됩니다. 이 워크트리는 기본적으로 저장소의 기본 브랜치에서 갈라집니다. 플러그인에서 가져온 서브에이전트는 보안상 hooks, mcpServers, permissionMode 필드를 무시하므로, 이 필드가 필요하면 파일을 프로젝트나 사용자 폴더로 옮겨야 합니다. 알 수 없는 필드는 오류 없이 무시되므로 필드 이름의 철자를 확인하세요. 플러그인 서브에이전트는 우선순위가 가장 낮고, 머리말이 파싱되지 않는 파일은 claude plugin validate로 폴더를 검사해 찾을 수 있습니다.

MCP 범위 세 가지와 승인 상태#

Claude Code의 MCP 서버는 로컬, 프로젝트, 사용자 범위 중 하나로 설치합니다. 로컬 범위는 기본값이며, 추가한 프로젝트에서만 로드되고 ~/.claude.json의 해당 프로젝트 항목에 저장되어 개인적으로 남습니다. 프로젝트 범위는 저장소 루트의 .mcp.json에 기록되어 버전 관리로 팀과 공유됩니다. 사용자 범위는 모든 프로젝트에서 로드되며 ~/.claude.json에 저장되고 팀과 공유되지 않습니다.

.mcp.json의 서버는 처음에 승인을 기다리는 상태로 보일 수 있습니다. 복제한 저장소는 자기 서버를 스스로 승인할 수 없고, 워크스페이스 신뢰 대화상자를 수락해야 승인 설정이 반영됩니다. Mirr 한국어 문서는 /mcp로 연결을 추가하고 제거하는 방법을 설명하지만 범위와 저장 위치는 나오지 않으므로, 팀 공유가 필요한 서버는 Mirr의 공유 방식을 따로 확인하세요. 서버 상태는 claude mcp list와 claude mcp get <이름>으로 확인하고, 범위는 claude mcp add의 --scope 옵션으로 고릅니다. 원격 HTTP 서버는 --transport http 옵션으로 추가합니다.

첫 작업: 읽기 → 수정 → 테스트#

1. 커밋되지 않은 변경과 Git이 추적하지 않는 파일, CLAUDE.local.md와 .claude/settings.local.json 같은 개인 파일, 세션 기록 폴더를 별도 위치에 백업하고 복구 가능 여부를 확인합니다. 운영 데이터나 민감정보가 없는 작은 과제를 고르고, 추가 격리가 필요하면 별도 브랜치에서 작업하세요.
2. 어떤 작업을 요청하기 전에도 작업 모드에서 Yolo가 켜져 있으면 끄고 Ask를 선택해 표시를 확인합니다. 도구별 권한 규칙도 확인하고, .claude/settings.json의 permissions 규칙 목록과 대조하세요. Yolo를 끄는 것만으로 모든 실행에 승인이 보장되지는 않습니다. 읽기와 계획부터 요청하고 승인 요청의 경로와 명령을 검토하세요.
3. 범위를 정해 수정을 요청하고, /rewind가 되돌리지 못하는 Bash 변경이 있는지 diff로 확인합니다. 승인된 테스트 명령이 외부 데이터를 바꾸지 않는지도 확인한 뒤 실행합니다.
4. 결과와 실패를 기록하고 필요한 지침·권한을 조정한 후에만 적용 범위를 넓힙니다.

남은 검증: 실제 첫 작업의 diff와 테스트 출력은 아직 수집하지 않았습니다.

되돌리기#

1. 작업을 멈추고 /rewind를 쓰기 전에 현재 변경 사항을 Git으로 확인해 보존할 내용을 따로 저장합니다. 기존 Claude Code 설정과 저장소를 유지했다면 그 환경에서 다시 작업할 수 있습니다.
2. 파일 복구가 필요하면 백업이나 Git 기록을 기준으로 범위를 확인하세요. Mirr의 /rewind는 사용 가능한 체크포인트와 복구 범위에 제한이 있으며 백업을 대체하지 않습니다. 복구 안내를 확인하세요.
3. 외부 게시, 배포, 데이터베이스 변경은 해당 서비스의 복구 절차로 따로 처리합니다. Claude Code 시절 .mcp.json이나 사용자 범위에 등록한 MCP 서버 가운데 쓰지 않는 것은 서비스에서 토큰 권한을 철회하세요.

데이터 처리는 각 서비스와 계정 조건을 따릅니다. Claude 데이터 사용 안내는 계정 유형과 설정에 따라 보존 및 학습 사용 정책이 다르다고 설명합니다. Mirr와 모델 제공자, MCP 서비스의 전송 대상·저장 위치·보존 기간·삭제 절차는 계약과 현재 정책을 각각 확인하세요. Mirr의 보존 기간과 학습 사용 여부는 이 한국어 문서에서 확인되지 않습니다.

Claude Code 체크포인트가 되돌리지 못하는 변경#

Claude Code의 /rewind는 Claude의 편집 도구로 바꾼 파일을 기준으로 되돌립니다. 이미 편집한 파일을 뒤에 Bash 명령이 다시 바꾸었다면 그 변경도 되돌려지지만, Bash 명령만 바꾼 파일은 추적되지 않습니다. 서브에이전트의 편집은 보통 체크포인트에 잡히지 않으며, 예외는 전경에서 실행되는 포크된 스킬뿐입니다. 세션 밖에서 직접 고친 파일과 같은 파일을 건드린 다른 동시 세션의 변경도 보통 잡히지 않습니다.

체크포인트는 세션 안에서 편집한 파일의 스냅샷이며, 최근 100개까지 보관합니다. 세션 스냅샷은 마지막 저장 후 기본적으로 약 30일이 지나면 정리되고, 정리된 체크포인트로 되돌리면 No files were restored 오류가 날 수 있습니다. 보관 기간은 cleanupPeriodDays 설정으로 늘릴 수 있습니다. 심볼릭 링크와 하드 링크는 되돌리지 않고 건너뛰며 Restored the code, but skipped N files 경고를 띄웁니다. 요약 기능은 파일을 바꾸지 않고 대화만 압축합니다. 요약은 선택한 지점 이후를 줄이는 방식과 그 이전을 줄이는 방식이 있으며, 원본 메시지는 세션 기록에 남습니다. 옮기기 전에는 위 경로에 해당하는 파일을 Git 기록으로 따로 확인하세요. 메뉴에서는 코드와 대화를 함께 되돌리거나 대화만, 코드만 되돌리는 항목과 요약 항목을 고를 수 있으며, 되돌릴 파일 변경이 없는 지점에서는 코드 되돌리기 항목이 나타나지 않습니다. 작업 중에 보낸 메시지에는 자체 체크포인트가 없어서 코드 복구 없음으로 표시되며, 그 변경은 턴을 시작한 프롬프트를 골라 코드를 복구해야 되돌려집니다.

그래서 Mirr Code는?#

한국어로 끝까지 일하는 터미널 코딩 에이전트입니다. 한국어로 요청하고 한글 명령을 검색할 수 있습니다. 한국어 작업 안내에 따르면 HWP·HWPX에 관해 질문하거나 처리 코드 작성을 요청할 수 있지만, 실제 파일 읽기·수정·변환 지원은 연결된 도구에 따라 달라집니다.

가격은 Mirr Code 요금제, 모델은 Mirr 1.0 Pro를 참고하세요. 최신 영어 벤치마크나 방대한 생태계 자체가 목적이라면 기존 도구가 더 나을 수 있습니다.

Claude Code 비용 문서는 2026-11-03에 확인했습니다. 실제 계정의 청구 상태와 해지 여부는 확인되지 않았습니다.

/usage 명령과 비용 추정치 읽기#

Claude Code는 토큰 사용량에 따라 과금되며, 구독 요금제의 가격은 공식 가격 페이지에서 따로 확인하라고 비용 문서가 안내합니다. /usage의 세션 블록은 API 사용자를 위한 토큰 통계입니다. Pro, Max, Ultra 구독자에게는 구독에 포함된 사용량이 막대그래프와 활동 통계로 같은 화면에 나오므로 세션 금액은 청구와 관계가 없습니다. 세션 금액은 토큰 수에 목록 가격을 곱해 기기에서 계산한 추정치이며, 조직 설정의 modelPricing 표가 있으면 계약 요율로 계산됩니다. 정확한 청구 내역은 Claude Console의 사용량 화면에서 확인하세요.

구독자가 한도를 넘었을 때는 /usage-credits가 사용량 크레딧을 켜고 끄는 화면을 엽니다. 개인 구독자는 claude.ai의 설정 화면이 열리고, 팀과 엔터프라이즈 구성원은 권한이 있으면 조직 설정이 열리며 권한이 없으면 관리자에게 요청이 전송됩니다. API 조직은 Console의 작업 공간 단위로 지출 한도와 비용 보고를 관리하며, Console 계정으로 처음 인증하면 "Claude Code" 작업 공간이 자동으로 만들어집니다. 비용 문서는 기업 배포 전체의 평균을 활성 개발자 하루 약 13달러로 밝히고, 자기 팀의 비용은 소규모 시범 그룹에서 기준선을 잡아 추정하라고 권합니다.

데이터 보관 기간과 로컬 기록#

Claude Code 데이터 보관 기간은 계정 유형과 설정에 따라 다릅니다. 소비자 요금제(Free, Pro, Max, Ultra)에서 모델 개선에 데이터 사용을 허용하면 5년, 허용하지 않으면 30일 보관됩니다. 상업용 계정(Team, Enterprise, API)의 표준 보관 기간은 30일이며, 자격을 갖춘 Claude for Enterprise 계정만 무보존 옵션을 쓸 수 있고 계정팀이 조직별로 켭니다. /feedback, /bug, /share로 보낸 기록은 5년 보관됩니다.

Claude Code 클라이언트는 세션 기록을 ~/.claude/projects/ 아래에 평문으로 저장하며 기본 보관 기간은 30일입니다. cleanupPeriodDays로 기간을 바꿀 수 있으므로 옮기기 전에 민감한 내용이 든 세션 기록을 정리하거나 기간을 조정하세요. 같은 설정이 체크포인트 스냅샷의 보관 기간에도 쓰입니다. 데스크톱 앱이나 Cowork에서 시작했거나 마지막으로 이어 간 세션 기록은 기본 정리 기간의 적용을 받지 않는다고 문서에 나옵니다. /feedback 보고서는 Claude가 초안을 만들어 두어도 사용자가 보내기 전에는 전송되지 않습니다.

첫 과제의 계약을 전환 전후로 고정하기#

작은 오류 수정 하나를 골랐다면 기대 동작과 유지할 계약을 먼저 적습니다. 오류 문구를 바꾸는 과제라면 상태 코드와 출력 구조는 유지할지 정하세요. 이전 도구에서 이미 수정한 파일을 새 도구의 독립 결과처럼 비교하면 안 됩니다. 같은 기준 상태를 사용하거나 상태가 다르다는 사실을 기록하세요. 실제 실행 승인과 데이터를 보관할 위치도 과제 시작 전에 정합니다.

이 표는 검토 양식입니다. 비교 화면과 재연결 transcript, 실제 작업의 테스트 출력은 여전히 별도로 필요하며 문서 확인만으로 성공표를 만들 수 없습니다.

이전 환경의 설정을 그대로 가져오기보다, 어떤 지침·훅·서브에이전트가 새 환경에서 같은 역할을 하는지 하나씩 대응을 만들고 그 결과를 남기는 편이 이동을 판단하기 쉽습니다. 대응이 되지 않는 항목은 '옮기지 않았다'로 기록하고, 새 환경에서 다시 만들거나 계속 사용하지를 따로 결정합니다. 설치와 재연결은 화면 한 장으로 끝내지 말고, 연결 확인과 첫 작업의 실제 출력을 따로 남깁니다. 이렇게 범위를 좁히면 이전 환경의 존재와 새 환경의 동작을 뒤섞지 않고 비교할 수 있습니다. 확인하지 않은 항목은 추측으로 옮기지 않고, 재확인이 필요할 때까지 그대로 두는 것이 오류를 줄입니다.

관련#

• 작업 모드

편집 메모 (2026-11-02): 원래 지침·훅·서브에이전트 공개 보류 조건과 진단·복구 전 보관 범위를 보충했습니다. 지침 비교 화면, 설치·MCP 재연결 transcript, 롤백 명령과 첫 작업 테스트는 아직 없습니다. 상태나 검증일은 바꾸지 않았습니다.