2026 Cursor Agent Skills 맥 교체 후 Claude Code에서 계속 쓰는 법?

공식 mattpocock/skills 안내는 기술 묶음 설치 경로를 2가지로 나누며, 두 경로를 함께 설치하면 같은 기술이 중복될 수 있다고 경고합니다. 공식 안내에 근거하면, 새 맥에서는 프로젝트 파일 방식 또는 Claude Code plugin 방식 중 하나만 선택해야 합니다.

증상 → 가장 빠른 해결: 기존 맥은 정상인데 새 맥의 Claude Code에 같은 기술이 두 벌 보이면 설치를 더하지 마십시오. 기존 맥의 출처를 먼저 기록하고, 파일 방식은 저장소에서 복구하고 plugin 방식은 새 맥에서 다시 설치해야 합니다.

이 글은 Cursor 프로젝트를 새 맥으로 옮기는 개인 개발자, 짧게 쓰고 폐기하는 클라우드 맥을 운영하는 팀, 같은 맥에서 Cursor와 Claude Code를 함께 쓰려는 개발자를 위한 실행 문서입니다.

최종 업데이트: 2026년 8월 27일. 설치 경로와 중복 설치 판단은 프로젝트 안내, 기술 묶음 명령 문서, Claude Code plugin 안내를 기준으로 확인했습니다.

새 맥에서 먼저 정해야 할 단일 출처

기존 맥에서 어떤 방식으로 설치했는지부터 적습니다. 폴더를 먼저 복사하면 판단이 늦어집니다.

mattpocock/skills는 파일 방식은 직접 편집하고 사용자가 갱신하는 경로로, plugin은 Claude Code가 관리하는 경로로 설명합니다. 따라서 Cursor에서 편집한 내용을 계속 자산으로 삼으려면 프로젝트 저장소를 기준으로 잡습니다. 반대로 Claude Code 작업만 하고 관리 부담을 줄이려면 plugin을 선택합니다.

mattpocock/skills를 새 맥에 옮긴다는 말도 두 의미로 나뉩니다. 저장소의 파일이 따라가는 것과, Claude Code가 plugin을 다시 내려받는 것은 같은 복사가 아닙니다.

오래 쓸 새 맥은 파일을 복사하지 말고 저장소로 복구합니다

새 맥을 장기 개발 장비로 사용할 계획이면 기존 사용자 폴더나 캐시를 통째로 복제하지 않습니다. 프로젝트가 요구하는 파일을 저장소에서 가져옵니다. 이렇게 해야 수정 내역이 추적되고, 다음 맥에서도 같은 기준으로 복구할 수 있습니다.

다음 순서로 진행합니다.

1. 기존 맥에서 파일 방식인지 plugin 방식인지 기록합니다. 기술 이름과 사용자 수정 여부도 함께 적습니다.
2. 새 맥에서 저장소를 정상적으로 받습니다. 저장소 안의 기술 디렉터리와 프로젝트 설정 파일이 실제로 내려왔는지 확인합니다.
3. 작성일 현재의 skills 명령 문서에 나온 설치 명령을 사용합니다. 파일 방식이라면 npx skills add mattpocock/skills를 기준으로 확인하되, 명령이나 선택 항목이 바뀌었으면 현재 문서를 우선합니다.
4. 갱신이 필요할 때는 같은 문서의 현재 갱신 명령을 확인합니다. 예전 셸 기록을 그대로 재사용하지 않습니다.
5. 기술 디렉터리 안에서 직접 수정한 파일, 프로젝트 설정, 초기화 결과를 기존 맥과 대조합니다.
6. Cursor에서 기술을 검색하고, 실제 코드를 변경하지 않는 낮은 위험 작업을 한 번 실행합니다.
7. Claude Code에서는 같은 프로젝트 문맥을 연 뒤 기술 목록과 호출 결과를 확인합니다.
8. 세션을 다시 시작해도 같은 출처가 검색되는지 검사합니다.

실제 경로는 운영 체제의 전역 폴더를 추측해 적지 않는 편이 안전합니다. 현재 저장소 구조와 CLI 문서가 정한 경로가 기준입니다. 전역 캐시를 배포 근거로 삼으면 새 맥에서 경로가 달라질 때 재현이 끊깁니다.

파일 방식의 장점과 부담

장점

• 프로젝트 변경 사항을 저장소의 커밋과 함께 검토할 수 있습니다.
• Cursor에서 직접 고친 기술 내용을 다음 환경에 전달할 수 있습니다.
• 새 맥이나 임시 환경에서 다시 만들 기준이 분명합니다.

부담

• 사용자가 갱신 시점을 관리해야 합니다.
• 프로젝트별 설정 누락을 직접 찾아야 합니다.
• 저장소에 들어가면 안 되는 비밀값이나 개인 설정이 섞이지 않도록 주의해야 합니다.

임시 클라우드 맥은 완전 복제보다 재생성이 안전합니다

며칠만 쓰는 클라우드 맥은 기존 사용자 폴더를 전부 가져오는 장비가 아닙니다. 목표는 빈 환경에서 저장소를 받고 다시 만들 수 있는가입니다.

프로젝트 파일 방식은 다음 조건에서 유리합니다.

• Cursor와 Claude Code가 같은 프로젝트 파일을 읽어야 합니다.
• 기술을 팀의 코드처럼 수정하고 검토해야 합니다.
• 환경을 폐기한 뒤에도 저장소만으로 다시 시작해야 합니다.

순수한 Claude Code 작업이고 기술 내용을 수정하지 않는다면 plugin을 새 환경에 다시 설치할 수 있습니다. 다만 파일 방식의 같은 이름이 프로젝트 안에 남아 있다면 먼저 정리합니다. plugin을 추가로 설치해 덮어쓰는 방식은 복구가 아닙니다.

환경을 없애기 전에 저장소에 넣을 사용자 수정, 재현에 필요한 설정, 기술 호출 검증 기록을 확인합니다. 반대로 세션 기록, 전역 캐시, 개인 셸 설정은 프로젝트 자산으로 착각하지 않습니다.

주의: 임시 맥에서 정상 작동했다는 사실만으로 재현이 끝난 것은 아닙니다. 환경을 다시 만들 수 있는 저장소 기준과 단일 출처를 남겨야 인수 가능한 결과가 됩니다.

Claude Code plugin만 쓰는 새 맥의 복구 절차

Claude Code plugin을 기준으로 정했다면 옛 맥에서 읽기 전용 파일을 손으로 가져오지 않습니다. 새 맥에서 plugin 관리 문서의 현재 절차로 설치합니다.

확인 순서는 다음과 같습니다.

1. 새 맥에서 Claude Code가 정상적으로 실행되는지 확인합니다.
2. 현재 공식 문서의 plugin 설치 방식을 사용합니다. 오래된 명령을 기억에 의존하지 않습니다.
3. plugin 검색과 활성화 안내에 따라 plugin이 활성 상태인지 확인합니다.
4. Claude Code가 제공하는 기술 목록에 예상한 이름이 나타나는지 확인합니다.
5. 프로젝트를 열고 초기화 요구 사항이 충족되는지 확인합니다.
6. 프로젝트 안에 같은 이름의 파일 방식이 있는지 검색합니다.
7. 중복 파일이 발견되면 설정을 더 진행하지 말고 어느 출처를 폐기할지 결정합니다.
8. 낮은 위험의 테스트 작업을 실행한 뒤 세션을 다시 시작합니다.

plugin이 보이지 않는다고 프로젝트 파일을 급히 복사하지 마십시오. 먼저 활성화 상태, 프로젝트 위치, 현재 문서의 관리 방법을 다시 확인합니다. 파일 방식과 plugin 방식은 내용이 비슷해 보여도 갱신 주체가 다릅니다.

Cursor와 Claude Code를 함께 쓸 때는 도구만 공유합니다

같은 새 맥에서 두 도구를 병행할 수는 있습니다. 그러나 Claude Code에 같은 이름의 기술을 두 출처로 제공하면 안 됩니다.

가장 단순한 구성은 두 가지입니다.

• 두 도구가 같은 프로젝트 파일을 읽도록 구성합니다.
• Claude Code는 plugin만 사용하고, 프로젝트 안에는 같은 이름의 파일을 두지 않습니다.

Cursor에서만 보이는 파일을 Claude Code에서도 자동으로 볼 수 있다고 가정하지 않습니다. 반대도 마찬가지입니다. 두 도구를 함께 쓴다는 것은 프로젝트 문맥을 맞춘다는 뜻이지, 설치 출처를 겹친다는 뜻이 아닙니다.

새 맥 인수 전 검증과 되돌리기 기준

새 환경을 넘기기 전에는 다음 증거를 남깁니다.

• [ ] 파일 방식인지 plugin 방식인지 한 줄로 기록했습니다.
• [ ] 기술의 실제 출처와 보이는 목록을 확인했습니다.
• [ ] 직접 수정한 내용이 저장소 또는 선택한 관리 경로에 보존되어 있습니다.
• [ ] Cursor에서 낮은 위험 작업을 한 번 실행했습니다.
• [ ] Claude Code에서도 예상 기술을 한 번 호출했습니다.
• [ ] 프로젝트 설정과 초기화 결과를 확인했습니다.
• [ ] 세션을 다시 시작한 뒤 같은 출처가 유지됩니다.
• [ ] 전역 캐시나 개인 폴더를 인수 자료에서 제외했습니다.
• [ ] 실패 시 돌아갈 저장소 커밋 또는 단일 plugin 출처를 정했습니다.

복구가 실패하면 설치를 한 번 더 겹치지 않습니다. 먼저 기존 맥에서 검증된 저장소 버전으로 되돌리거나, 선택한 단일 plugin 출처만 남깁니다. 기술 이름이 두 번 보이는 상태에서 갱신을 반복하면 어느 내용이 호출됐는지 확인하기 어려워집니다.

현재 맥의 방식이 불분명하다면 MacHTML 콘솔에서 새 환경의 작업 상태를 확인할 때도 이 기록을 함께 남기는 편이 좋습니다. 장기 장비가 아니라 짧은 검증용 환경이라면 임시 맥과 장기 맥 선택 기준을 먼저 읽고, 작업 기간과 재현 필요성을 기준으로 결정하십시오.

기존 방식은 편해 보여도 사용자 폴더 복제에는 세 가지 문제가 있습니다. 숨은 캐시와 전역 설정이 따라오고, 파일 방식과 plugin이 겹칠 수 있으며, 환경을 폐기한 뒤 무엇이 프로젝트에 필요한지 남지 않습니다. 이 조건이라면 MacHTML의 맥 렌탈로 짧은 검증 환경을 만들고, 저장소와 이 인수 목록만으로 새 세션을 확인하는 편이 더 깔끔합니다. 다만 장기간 고정된 무거운 작업이나 물리 장치 연결이 핵심이면 직접 구매한 맥이 더 적합할 수 있습니다. 단순히 Cursor와 Claude Code의 병행 구성을 시험하거나 임시 개발 공간이 필요할 때만 렌탈을 선택하십시오.

필요한 것은 오래된 맥의 복사본이 아니라, 하나의 출처와 다시 실행할 수 있는 검증 기록입니다. MacHTML 환경을 사용한다면 작업 기간에 맞춰 맥을 선택하고, 위 체크 목록을 반납 또는 인수 전에 다시 확인하면 됩니다. 자세한 환경 선택은 MacHTML 서비스 안내에서 확인할 수 있습니다.

더 읽기: 새 맥에서 에이전트 기술을 설치하고 팀 설정까지 맞추는 방법 Claude Code와 맥 환경에서 MCP 연동을 구성하는 안내 Cursor의 최신 기능과 맥 개발 환경 활용법 살펴보기