Claude Code 상세 사용법 19: agent view와 백그라운드 세션 운영 | DAKER 커뮤니티

Claude Code 상세 사용법 19: agent view와 백그라운드 세션 운영

Claude Code 공식 agent view 문서는 claude agents를 여러 백그라운드 세션을 한 화면에서 관리하는 연구 프리뷰 기능으로 설명한다. 한 세션에 모든 일을 밀어 넣는 대신, 버그 수정, 코드 리뷰, 테스트 실패 조사처럼 서로 독립적인 작업을 행 단위로 나누는 방식이다.

1. 시작 전 버전과 범위를 확인한다

공식 문서 기준 agent view는 Claude Code v2.1.139 이상에서 동작한다. 먼저 버전을 확인하고, 저장소 루트에서 연다.

claude --version
cd ~/projects/my-app
claude agents

여러 저장소가 섞이면 --cwd로 범위를 좁힌다. 큰 모노레포에서 이 옵션 없이 열면 관련 없는 세션까지 보여서 운영 화면이 금방 시끄러워진다.

claude agents --cwd ~/projects/my-app   공식 문서 기준 백그라운드 세션은 파일을 수정하기 전에 `.claude/worktrees/` 아래 git worktree로 이동해 병렬 수정을 격리한다. 단, 이미 worktree 안이거나 git 저장소가 아니거나 설정에서 격리를 끄면 직접 작업 복사본을 만질 수 있다. 이 경우 같은 파일을 동시에 고치게 하지 않는다.  4. 실패 모드를 미리 정한다  세션이 Failed가 되면 바로 재시작하기보다 로그를 먼저 본다. 권한 질문이면 답을 주고, 테스트 실패면 재현 명령을 확인한다. `Ctrl+X`로 삭제하면 Claude가 만든 worktree와 미커밋 변경도 사라질 수 있으니, 보존할 결과는 PR, patch, commit 중 하나로 남긴 뒤 정리한다.  Senior takeaway: agent view는 AI 코딩을 빠르게 만드는 버튼이 아니라 동시성 관리 장치다. 독립 작업만 병렬화하고, 각 세션에 검증 명령을 붙이며, 결과는 PR이나 로그로 회수해야 바이브코딩이 팀 개발 생산성으로 이어진다. 

2. 한 프롬프트는 새 세션 하나라고 생각한다

agent view 입력창에 프롬프트를 쓰고 Enter를 누르면 새 백그라운드 세션이 생긴다. 두 번째 프롬프트는 기존 세션의 후속 질문이 아니라 또 다른 세션이다. 그래서 프롬프트에는 범위, 금지 조건, 검증 명령을 한 번에 넣는다.

Fix the flaky SettingsChangeDetector test.
Only touch the test and the detector module.
Run npm test -- SettingsChangeDetector and report the root cause.

터미널에서 바로 백그라운드로 보낼 수도 있다.

claude --bg --name "settings-flake" "investigate the flaky SettingsChangeDetector test"
claude attach <session-id>
claude logs <session-id>

3. 상태를 보고 개입한다

Working은 도구 실행 중, Needs input은 권한이나 판단을 기다리는 상태, Ready for review는 PR 같은 검토 산출물이 있는 상태다. 대부분은 Space로 peek만 해도 충분하다. 전체 대화가 필요할 때 Enter나 오른쪽 화살표로 attach 한다.