문제 해결

자주 만나는 오류와 해결 방법입니다.

"macOS is asking for permission to use the keychain"

macOS가 키체인 사용 허가 창을 띄웠는데 20초 안에 아무도 답하지 않았습니다. 화면이 잠겨 있거나 사람이 없는 컴퓨터에서 생깁니다. 그 컴퓨터 앞에서 허용한 뒤 다시 실행하세요. 사람이 없는 컴퓨터라면 aisync keystore file로 키를 파일(권한 0600)에 두세요. 이 선택은 aisync 설정에 저장되므로, Claude Code가 셸 환경 없이 MCP 서버를 띄울 때도 그대로 적용됩니다. 바꾼 뒤에는 aisync unlock(Vault는 aisync vault login)을 다시 하세요.

"secrets for … are locked on this machine"

이 컴퓨터에 저장소 키가 없습니다. 처음 쓰는 컴퓨터이거나 다른 곳에서 aisync passwd로 패스프레이즈를 바꾼 경우입니다.

aisync unlock

MCP 서버가 뜨지 않음

.claude.json에 적힌 서버 명령을 터미널에서 그대로 실행하면 오류가 보입니다.

aisync exec --repo you/aisync-config -- npx -y @modelcontextprotocol/server-slack

키가 없거나(위 항목), 참조한 토큰 이름이 저장소에 없거나, Vault 토큰이 만료된 경우가 대부분입니다.

"profile … changed in the repo since your last pull"

다른 컴퓨터에서 같은 프로필을 올렸습니다. 먼저 받으세요. 이 컴퓨터에서만 고친 파일은 그대로 남습니다.

aisync pull default
aisync push default

"these changed both here and in the repo"

같은 파일을 양쪽에서 고쳤습니다. 리포 것을 받으려면 aisync pull --force, 내 것을 남기려면 aisync push --force입니다. 자세한 내용은 동기화와 충돌을 보세요.

"secret-looking values would be committed in plain text"

올리려는 내용에 토큰이 보입니다. MCP 서버라면 --secrets를 붙여 저장소로 옮기고, 파일이라면 값을 빼세요. 시크릿에 방법이 있습니다.

받은 뒤에도 새 MCP 서버가 안 보임

Claude Code는 세션을 시작할 때만 MCP 서버를 읽습니다. 세션을 다시 시작하세요.

처음 받을 때 기존 설정이 사라질까 걱정됨

받기 전에 aisync pull default --dry-run으로 무엇을 바꿀지 볼 수 있습니다. 실제로 받을 때도 바꾸거나 지우는 파일은 <설정 폴더>/.aisync/backup/에 먼저 복사합니다.

이 문서는 aisync 0.1 기준입니다.