세션끼리 일을 넘길 때 첫 관문
세션을 여러 개 띄워 일하다 보면, 한 세션이 확인한 걸 다른 세션이 알아야 할 때가 옵니다. Claude Code 는 @<세션이름> 으로 같은 기기의 다른 세션에 메시지를 보냅니다. 그런데 대부분 첫 관문에서 막힙니다. 이유는 셋 중 하나입니다.
세 함정
① 이름이 없다. 이름 없는 세션은 my-app-3f 같은 기본 표시명이 붙지만 그건 주소가 아닙니다. → -n <이름> 으로 열거나 세션 안에서 /rename <이름>.
② 이름에 공백이 있다. 공백 이름은 따옴표가 필요합니다(@"release notes"). 자동완성에서 고르면 따옴표가 붙지만 손으로 치면 안 붙습니다. → 공백 없이 짓는 게 제일 쉽습니다(release-notes).
③ 이름이 겹친다 (제일 조용한 함정). 이름은 기기 안에서 유일해야 합니다. 이미 쓰는 이름으로 열거나 /rename 하면 먼저 쥔 세션이 이름을 유지하고, 내 세션은 두 단어 접미사 변형(예: auth-refactor-graceful-unicorn)을 받습니다. 그래서 @이름 은 여전히 그 옛 세션으로 가고, 에러 없이 오배송됩니다. → 변형 이름으로 부르거나, claude stop <id> 로 옛 세션을 닫고 이름을 되찾으세요. 헷갈리면 claude agents 의 짧은 id 로 부릅니다.
명령 레퍼런스
-n <이름>(런치 명명) · @<이름>(전송, 공백이면 @"두 단어") · /rename <이름>(라이브 개명) · claude agents [--json --all](목록) · claude --bg(백그라운드, 다음 프롬프트가 할 일) · attach <id> · logs <id> · stop <id> · -r <id>(대화 이어받기) · -r <id> --fork-session(복사본으로 갈라내기, 원본 유지).
claude agents 는 터미널이 필요하고, 스크립트에선 --json.
옛 정보 교정 (검증본의 핵심)
현장 자료에 "맥·리눅스만 되고 Bedrock 등은 안 된다"가 돌지만, 지금 문서는 Windows 지원(v2.1.234+)이고 같은 기기 세션은 Bedrock·Vertex·Foundry 에서도 됩니다(v2.1.248+). @멘션 자체는 v2.1.232+. 그리고 "/rename 은 중복을 안 막는다"도 틀렸습니다. /rename 도 -n 과 같은 유일성 규칙을 따릅니다. @ 가 안 보이면 claude --version 부터 확인하세요.
쓰는 법
- Claude Code: "@세션 왜 안 걸려" / "이 세션 이름 붙여줘" / "다른 세션으로 넘겨줘" 하면 이 진단으로 원인을 짚고 고칩니다
- 다른 AI:
npx skills add hanmariyang/giting-skills --skill session-mention
한 줄로: 이름을 붙이고, 공백을 안 넣고, 그 이름을 아무도 안 쓰고 있을 것. 이 셋인데 셋 다 안 알려주고, 어긋나도 에러가 안 납니다.