가이드Insta Edits for Claude중급약 10분5단계
Claude Code로 Instagram Edits for Mac의 릴스를 편집시키는 법
릴스를 자주 만드는 크리에이터와 개발자를 위한 중급 가이드입니다. Claude Code가 Edits for Mac의 편집기 도구까지 쓰도록 연결하는 방법을 익힙니다.
시작하기 전에
- Apple silicon(M1 이후) Mac
- Edits for Mac(무료) 설치, Instagram 로그인, Claude 작업 중 계속 실행
- Claude Code 설치
- python3 3.9 이상, 명령줄 도구 안내가 뜨면 xcode-select --install 실행
Edits for Mac에서 Edits › Settings › Automation으로 이동해 Enable Automation Server를 켜고 Access token을 복사하세요. Claude가 작업하는 동안 Edits를 열어 두세요.
터미널에서 claude를 실행하고, Claude Code 안에서 아래 명령어를 실행하세요. 설치 명령어 두 개는 한 번에 하나씩 실행하세요.
마켓플레이스 추가 /plugin marketplace add faisalkhanzemi/insta-edits-for-claude아래 두 번째 명령어를 실행하세요. Claude Code가 가려진 입력창으로 access token을 물으면 1단계에서 복사한 토큰을 붙여 넣으세요. 토큰은 키체인에 저장됩니다.
플러그인 설치 /plugin install insta-edits@insta-editsClaude Code를 다시 시작한 뒤 /mcp를 실행하세요. 이 플러그인은 edits 스킬도 함께 설치합니다.
이렇게 되면 성공: /mcp 목록에서 edits가 connected로 표시되면 됩니다.
Edits에서 프로젝트를 연 뒤 Claude에 요청을 보내세요. Edits가 홈 화면(도구 32개)에서 편집기(도구 274개)로 바뀌면 브리지가 Claude에 알려 주므로 편집기 전체를 쓸 수 있습니다. edits 스킬은 명시적인 허락 없이는 게시하지 않도록 Claude에 지시합니다.
예시 프롬프트 In the Edits project I have open, cut the clips on the beat of the music, add captions and transitions, then export the reel. Do not publish anything.뜻: 열려 있는 Edits 프로젝트에서 음악 비트에 맞춰 클립을 자르고 자막과 전환을 넣어 릴스를 내보내되, 아무것도 게시하지 말라는 지시입니다.
주의할 점
- 채팅에서 Claude에게 설치를 시키면 가려진 토큰 입력창이 뜨지 않습니다. /plugin configure insta-edits@insta-edits로 토큰을 입력하고, 채팅에는 붙이지 마세요.
- 셸 스크립트로 설치하거나 Claude 데스크톱 앱에서 설치하면 토큰을 묻지 않습니다. Claude Code에서 /plugin configure insta-edits@insta-edits로 나중에 설정하세요.
- Edits가 아직 꺼져 있어도 브리지는 연결되고 도구가 없다고 알립니다. Edits가 응답하면 Claude에 알려 주므로 재시작은 필요 없습니다.
- 'Cannot reach Edits' 오류는 Edits가 닫혀 있거나 Automation Server가 꺼져 있다는 뜻입니다. 토큰이 거부되면 갱신 방법이 안내됩니다.
- 테스트를 거친 클라이언트는 Claude Code뿐입니다. 다른 MCP 클라이언트는 insta-edits serve를 실행할 수 있지만 검증되지 않았습니다.
자주 묻는 질문
- Claude Code를 Edits에 바로 연결하면 안 되나요?
- Edits는 홈 화면에서 도구 32개, 프로젝트를 열면 274개를 제공하지만 tools/list_changed 알림을 보내지 않습니다. 브리지가 없으면 Claude는 세션 내내 홈 도구 32개만 보고 편집기를 보지 못합니다.
- access token은 어디에 저장되나요?
- 플러그인은 macOS 키체인에, CLI는 0600 파일에 토큰을 보관합니다. 토큰은 ~/.claude.json, 로그, 오류 메시지에 나타나지 않습니다.
- Claude 데스크톱 앱에서도 되나요?
- 터미널의 Claude Code와 Claude 데스크톱 앱의 Code 탭에서 쓸 수 있습니다.
- 문제가 생기면 어떻게 진단하나요?
- doctor 명령어가 앱부터 로그인까지 모든 연결 고리를 점검합니다. --json을 붙이면 버그 제보에 첨부할 보고서가 나옵니다.
출처
바탕이 된 소식
- faisalkhanzemi/insta-edits-for-claude (11월 13일)