Community코딩 & 개발github.com

Claude 데스크톱 프로필

하나의 Mac에서 여러 Claude 계정을 동시에 사용하고 싶을 때, Dock에서 전환 가능한 별도의 앱 인스턴스를 제공합니다.

Claude 데스크톱 프로필란 무엇인가요?

이 스킬은 macOS에서 하나의 Claude 데스크톱 앱만으로 여러 계정을 동시에 사용할 수 있는 방법을 제공합니다. 기본 `/Applications/Claude.app`은 그대로 두고, `--user-data-dir` 플래그를 통해 각 계정별로 별도의 프로필 폴더를 생성하여 완전히 격리된 앱 인스턴스를 실행합니다. 사용자는 Dock에 각 계정별 실행기를 추가하여 마치 여러 앱처럼 전환할 수 있습니다. 주의할 점은 하나의 인스턴스만 로그인되어 있어야 하며, 앱의 단일 인스턴스 잠금 기능이 없으므로 같은 프로필을 동시에 실행하면 안 됩니다. 이 스킬은 AppleScript와 Bash 스크립트를 사용하여 구현되며, Claude 데스크톱 앱 버전 4.16336.0 및 1.20186.1에서 검증되었습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/soerenmartius/skills/tree/HEAD/skills/claude-desktop-profiles

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Claude 데스크톱 프로필은(는) 무엇을 하나요?

하나의 실제 /Applications/Claude.app, --user-data-dir을 통한 계정별 프로필 폴더, 계정별로 보호된 Dock 실행기. 기존 앱, 로그인 정보, 기본 프로필은 절대 건드리지 않습니다. 실행기와 추가 폴더를 삭제하면 되돌릴 수 있습니다.

Chad Timblin의 가이드 각 Claude 계정에 대해 별도의 데스크톱 앱 실행하기에서 파생됨. macOS 전용. Windows는 미검증 상태이며, 해당 가이드의 부록에 알려진 참고 사항이 있습니다.

기본 규칙

  1. /Applications/Claude.app을 절대 수정, 이동, 이름 변경, 복제 또는 재서명하지 마십시오. 대체 방법으로도 안 됩니다. 2단계가 실패하면 중단하고 보고하세요. 복제를 제안하지 마십시오.
  2. 기본 프로필 ~/Library/Application Support/Claude에 절대 쓰지 마십시오.
  3. 이미 실행 중인 프로필을 실행하지 마십시오. macOS에서 이 앱은 단일 인스턴스 잠금이 없습니다. 한 폴더를 두 번 실행하면 두 개의 라이브 프로세스가 하나의 폴더를 공유합니다 (v4.16336.0에서 2026-11-04 확인, v1.20186.1에서 2026-07-11 확인). 실행기의 포커스 경로는 절대 재실행으로 대체되어서는 안 됩니다.
  4. 로그인은 사용자가 정확히 하나의 인스턴스를 실행 중인 상태에서 진행합니다. Google 및 SSO 로그인은 브라우저를 통해 왕복하고 claude:// 링크로 돌아오며, macOS는 이를 이미 실행 중인 인스턴스에 전달합니다. 두 개가 열려 있으면 로그인된 인스턴스가 이를 받아 Google sign-in code does not answer a sign-in this app started; ignoring을 기록하고, 다른 인스턴스는 로그인 화면에 남습니다. 비밀번호를 절대 처리하지 마십시오.
  5. 런타임에 주의하십시오. 이 세션이 Claude 데스크톱 앱 내에서 실행 중이면, 앱을 종료하면 세션이 종료됩니다. 사용자에게 종료 단계를 텍스트로 전달하십시오. ~/Library를 읽을 수 없으면 터미널에서 실행하라고 알리십시오.
  6. 이 세션에서 생성한 테스트 아티팩트만 삭제하십시오. 스크립트의 스모크 테스트는 실행 전에 존재했던 폴더는 건드리지 않습니다.

범위

전체 작업은 약 10개의 명령어와 README로 구성됩니다. 설치된 버전에 대한 정보는 2단계의 일회성 테스트에서 가져오며, app.asar, entitlements, 퓨즈 또는 Electron 내부를 읽지 않습니다. 사용자 요청 시에만 사용자 정의 실행기 아이콘을 제공합니다.

단계

S는 이 스킬 디렉토리의 scripts/claude-profiles.sh입니다. bash $S를 실행하면 사용법이 출력됩니다. AppleScript 소스는 CLAUDE_LAUNCHER_SOURCES (기본값 ~/Documents/claude-multi-account/launcher-sources)에 저장됩니다. 사용자가 다른 폴더를 선택하면 5단계의 README 폴더를 가리키도록 설정하십시오. /Applications에 쓰기 권한이 없으면 CLAUDE_LAUNCHER_DIR=$HOME/Applications를 설정하십시오. verify-mechanism은 /tmp/claude-profile-test-<pid>를 쓰고 제거합니다.

  1. 입력. 기본 계정은 현재 로그인된 계정입니다. 이 계정은 기본 프로필을 유지하고 Claude (<Label>).app을 받습니다. 다른 모든 계정은 Claude-<Label> 폴더와 자체 Claude (<Label>).app을 받습니다. 레이블과 이메일이 제공되지 않았으면 요청하십시오. 어떤 계정이 로그인되어 있는지 확인하려면 기본 프로필의 config.json에 있는 lastKnownAccountUuid와 ~/.claude.json의 oauthAccount를 비교하십시오. 다르면 사용자에게 앱에 표시된 이메일을 물어보십시오. 어떤 프로필 폴더 이름도 다른 폴더 이름의 접두사가 되어서는 안 됩니다. build는 기존 폴더 및 다른 실행기 소스에 의해 명명된 폴더와의 충돌을 거부합니다. Application Support 아래에서 Claude로 시작하지만 Cookies 파일이 없는 폴더(예: Claude-3p)는 프로필이 아닙니다. 건드리지 마십시오.
  2. 사전 점검 및 메커니즘. bash $S preflight를 실행하십시오. 창이 나타날 것이라고 사용자에게 경고한 다음 bash $S verify-mechanism을 실행하십시오. 실패하면 중단하고 사용자에게 알리십시오.
  3. 빌드 및 스모크. 기본 계정: bash $S build <Label> default. 다른 각 계정: bash $S build <Label> Claude-<Label>을 실행한 다음 bash $S smoke <Label> Claude-<Label>을 실행하십시오. 기본 실행기는 스모크 테스트하지 마십시오. 포커스 경로가 사용자가 예상하지 못한 순간에 자동화 프롬프트를 트리거합니다. 이전 실행에서 실행기 또는 README가 존재하면 README 폴더를 백업하고, 제자리에서 다시 빌드하십시오 (build가 덮어씁니다). 이 세션에서 생성하지 않은 실행기는 절대 삭제하지 마십시오.
  4. 마이그레이션 확인. claude.ai 측의 항목(대화, 프로젝트, 커넥터)은 로그인을 따릅니다. 데스크톱 측 항목은 그렇지 않습니다. MCP 서버는 <profile>/claude_desktop_config.json에 있습니다. 선택적으로 복사하십시오. 전체 복사는 모든 로컬 서버 프로세스를 두 배로 만듭니다. 예약된 작업은 <profile>/local-agent-mode-sessions/<uuid>/<uuid>/scheduled-tasks.json 및 <profile>/claude-code-sessions/...에 있습니다. 해당 계정이 실행 중인 인스턴스 내에서 로그인되어 있는 동안에만 실행되며, 대상 인스턴스가 종료된 상태에서 마이그레이션하십시오. 필드를 정확히 복사하고 notifySessionId는 삭제하며 lastRunAt은 유지하고, 이전 복사본에서는 enabled: false로 설정하고 유지하십시오. 같은 파일의 preferences 블록(Cowork 설정, 우회 권한 게이트, 허용된 출처, 폴더 권한, Chrome 확장 프로그램 페어링)은 기본 프로필에 남아 있습니다. README에 사용자가 다시 설정해야 할 항목을 나열하고, Chrome 확장 프로그램과 페어링하는 인스턴스는 하나만 있어야 한다고 명시하십시오. ~/.claude는 모든 인스턴스에서 공유되므로 전역 CLAUDE.md가 모두에 적용됩니다.
  5. README. references/readme-template.md를 사용자가 지정한 폴더(기본값 ~/Documents/claude-multi-account)에 채우십시오.
  6. 인계를 아래 텍스트로 하고 중단하십시오. 사용자가 각 로그인을 보고하기 전에 bash $S ps를 실행하여 아무것도 출력되지 않는지 확인하십시오. 출력되면 직접 인스턴스를 종료하십시오 (kill에 pid 사용, SIGTERM은 이 앱의 정상 종료 신호입니다). 그런 다음에만 사용자에게 실행기를 클릭하라고 알리십시오. 모든 실행 중인 창은 동일하게 보이므로, "로그인된 창 종료" 단계를 사용자가 잘못 이해할 수 있습니다.
  7. 사용자가 다시 보고할 때: bash $S ps는 각 인스턴스가 고유한 프로필과 고유한 account= UUID를 사용 중임을 보여야 합니다.

인계 텍스트

한 번에 하나의 인스턴스만 열어두고:

  1. Applications에서 실행기를 Dock으로 드래그하고 일반 Claude 타일을 제거하십시오. 여러 인스턴스가 실행되면 해당 타일이 모두 켜지고 macOS가 선택한 인스턴스에 포커스됩니다.
  2. 모든 Claude 창을 종료하십시오. 각 창에서 Cmd+Q를 눌러 하나도 남지 않을 때까지 종료하십시오. 모든 창이 동일하게 보이므로 하나를 유지하려고 하지 마십시오. 정확히 하나의 인스턴스가 실행 중일 때만 로그인이 완료됩니다.
  3. Claude (<Label2>)를 클릭하고 해당 계정으로 로그인한 다음 같은 방식으로 종료하십시오. 다른 계정에 대해 반복하되, 항상 다른 것은 실행하지 않은 상태여야 합니다.
  4. Claude (<Label1>)를 클릭하십시오. 기본 계정은 여전히 로그인되어 있습니다.
  5. 이제부터는 원하는 조합으로 열 수 있습니다. 하나의 인스턴스만 종료하려면 먼저 해당 창을 클릭한 다음 Cmd+Q를 누르십시오.

실행기가 처음으로 실행 중인 인스턴스에 포커스할 때, macOS가 System Events를 제어하도록 허용할지 묻습니다. Allow를 클릭하십시오. 거부하면 자동 포커스만 비활성화됩니다. 실행 중인 타일은 하나의 아이콘을 공유하며 Dock 재시작 후 병합될 수 있습니다. 둘 다 무해합니다.

주의사항

증상조치 방법
두 인스턴스가 동일한 Dock 아이콘을 표시하거나 하나의 타일로 병합됨미관상 문제입니다. 실행기는 타일이 아닌 프로세스로 인스턴스를 찾습니다.
Quick Entry 단축키가 하나의 인스턴스에서만 작동함둘 다 단축키를 등록합니다. 한 인스턴스의 설정에서 변경하거나 비활성화하십시오.
한 인스턴스에서 "업데이트하려면 다시 시작" 메시지모든 인스턴스를 종료한 다음 실행기를 통해 다시 시작하십시오. 하나의 앱 번들, 하나의 업데이트 경로입니다.
두 번째 프로필에서 Cowork 사용자체 VM 번들을 다운로드하며, 프로필당 약 10GB입니다.
kill $pids가 "illegal pid: 1\n2"로 실패함zsh는 단어 분할을 하지 않습니다. xargs kill을 통해 파이프하십시오. 스크립트는 이미 이렇게 합니다.
인스턴스가 여전히 실행 중인 상태에서 테스트 폴더가 삭제됨먼저 종료하고, 종료를 확인한 후 삭제하십시오. 스크립트는 이미 이렇게 합니다.
Google 또는 SSO 로그인이 브라우저를 열고, "Claude 앱에서 로그인 완료" 메시지와 함께 "Open Claude"가 작동하지 않으며, 새 인스턴스가 로그인 화면에 남아 있음다른 인스턴스가 실행 중이어서 콜백을 수신했습니다. 모든 인스턴스를 종료하고(ps로 확인), 해당 실행기만 열고 다시 로그인하십시오. 모든 인스턴스는 ~/Library/Logs/Claude/main.log를 공유합니다. [Auth] 및 sign-in code를 grep하여 어떤 인스턴스가 수신했는지 확인하십시오. 시도 간에 pid가 변경되지 않으면 사용자가 실제로 종료하지 않은 것입니다.
설정 중 자동화 프롬프트가 나타남누군가 이미 실행 중인 인스턴스의 실행기를 열었습니다. Allow를 클릭하십시오. 아무 문제 없습니다.

위험 신호

  • "이 앱은 단일 인스턴스 잠금이 있으므로 포커스 실패 시 재실행해도 안전합니다." 잠금이 없습니다. 2단계가 이 버전에 대한 유일한 진실 공급원입니다.
  • "로그인은 앱 내에서 이루어지므로 두 인스턴스를 모두 열어둘 수 있습니다." 로그인 중에는 항상 하나의 인스턴스여야 합니다.
  • "Plan B: 앱을 복제하고 재서명합니다." 금지입니다. 중단하고 보고하십시오.
  • "먼저 app.asar / entitlements / 퓨즈를 검사하겠습니다." 범위를 벗어납니다.
  • "겸사겸사 아이콘에 배지를 추가하겠습니다." 요청 시에만.
  • "기본 실행기도 테스트하겠습니다." 포커스 경로가 사용자에게 프롬프트를 띄웁니다. 파이프라인 확인만 하십시오.

복구

비기본 인스턴스를 재설정하려면: 종료하고, 프로필 폴더를 삭제하고, 실행기를 클릭하고, 다시 로그인하십시오. 모든 것을 되돌리려면: 실행기와 추가 프로필 폴더를 삭제하십시오. 실제 앱과 기본 프로필은 관여되지 않습니다. 실행기를 소스에서 재빌드하려면: osacompile -o "/Applications/Claude (<Label>).app" <source>.applescript

관련 스킬