명령어·이관

npx를 쓰면 아래 명령 앞에 npx claude-account-switch@latest를 붙입니다. 글로벌 설치는 claude-account-switch를 사용합니다.

명령	동작
init	처음에는 설정 마법사, 이미 프로필이 있으면 읽기만 하는 요약
add <name>	새 프로필 생성
remove <name>	확인 후 프로필 삭제
list	프로필과 활성 상태 조회
use <name>	활성 프로필 변경
migrate [name] --from <path>	기존 설정 복사; 대상 생략 시 선택
install-shell	감지한 셸과 로컬 실행 파일 설치·복구·갱신
update [--check]	로컬 실행 파일 갱신 또는 설치 없는 확인
mcp [list]	과거 MCP 설정 경로·서버 이름 조회

이름은 소문자·숫자·하이픈, 최대 30자이며 시작과 끝은 문자·숫자여야 합니다. _shared, default는 예약 이름입니다.

기존 설정 가져오기

대상 프로필을 만든 뒤 실행합니다.

npx claude-account-switch@latest migrate work --from ~/.claude

기본 ~/.claude와 별도의 ~/.claude.json을 함께 읽습니다. CLAUDE_CONFIG_DIR이 있으면 해당 폴더와 그 안의 .claude.json도 대상으로 안내합니다. 임의 경로는 --from으로 지정합니다.

설정·명령·프로젝트·플러그인·계획·스킬·에이전트·규칙·훅·CLAUDE.md를 보존합니다. 심볼릭 링크는 기존 대상을 유지합니다. 파일 인증은 선택한 프로필 하나에만 제한 권한으로 복사합니다. macOS Keychain은 옮기지 않으며 실제 인증은 Claude가 확인합니다. .claude.json 존재만으로 로그인을 판단하지 않습니다.

원본을 삭제하지 않습니다. 같은 경로·부모/자식 경로는 거부하며 기존 대상 또는 공유 데이터가 다르면 충돌 경로를 표시하고 중단합니다. 손상된 JSON도 빈 설정으로 덮어쓰지 않습니다.

MCP 호환

2 버전부터 별도 MCP 편집기는 없습니다. mcp와 mcp list는 예전에 저장한 서버 이름·파일 경로만 보여줍니다. URL·토큰·환경변수 값은 출력하지 않습니다. 과거 add/remove/enable/disable 호출은 실패하며 파일을 변경하지 않습니다.

필요한 서버를 선택한 프로필에서 공식 명령으로 다시 등록합니다. 이전 항목은 자동 변환·삭제하지 않습니다.

cpf work
claude mcp add --transport http example --scope user https://example.com/mcp
claude mcp list

공유 파일에 적힌 과거 mcpServers가 모든 계정에서 적용된다고 가정하지 마세요. 사용자·로컬 범위는 Claude의 사용자 설정, 프로젝트 범위는 .mcp.json을 사용합니다. 공식 MCP 가이드를 참고하세요.

업데이트 호환

update와 update --self는 검증된 호환 버전을 별도 로컬 실행 폴더에 설치합니다. 실행 중인 세션은 기존 파일을 유지합니다. --yes는 호환성을 위해 지원합니다. --check는 설치하지 않으며 최신이면 0, 새 버전이 있으면 1, 조회 실패이면 2를 반환합니다.

과거 --claude-code는 공식 업데이트 안내를 출력합니다. Claude 버전을 조회하지 않으므로 --claude-code --check는 2를 반환합니다. Claude 업데이트는 claude update 또는 해당 설치 도구로 진행합니다.

대화형 실행 시 하루 한 번 백그라운드에서 이 도구를 자동 갱신합니다. 다음 실행부터 검증된 버전을 사용하며 계정 데이터·하네스 훅·셸 설정 파일은 수정하지 않습니다. 비대화형 실행에서는 갱신하지 않습니다. CLAUDE_SWITCH_DISABLE_AUTO_UPDATE=1로 끌 수 있습니다. 검사 실패 시 한 시간 후 재시도하고, 다운로드 실패 시 기존 실행 파일을 보존합니다. Node.js와 npm이 필요하며 실행 규약이나 Node 요구 사항이 호환되지 않는 패키지는 거부합니다.

1.x 사용자는 npx claude-account-switch@latest install-shell을 최초 한 번 실행하고 새 터미널을 열어 새 실행 구조로 전환합니다. 일상적인 셸 사용에 글로벌 설치는 필요하지 않습니다. 별도로 설치한 글로벌 명령은 자동 갱신하지 않습니다.