[Claude Code #7] /background와 /tasks, 백그라운드 에이전트

AI에게 긴 작업을 시키면 터미널이 인질로 잡힙니다. 테스트 수백 개를 고치는 동안 그 창을 지켜보고만 있는 거죠.

Claude Code는 이 문제를 백그라운드 세션으로 풉니다. 진행 중인 작업을 통째로 뒤로 보내고, 터미널은 다른 일에 쓰는 거예요.

이번 편은 /background(줄여서 /bg)와 /tasks, 그리고 백그라운드 세션을 관리하는 agent view를 정리합니다.

Claude Code 6편의 /goal이 완주 장치였다면, 이번엔 분업 장치입니다.

/bg: 지금 이 세션을 뒤로 보내기

작업 중인 세션에서 /bg를 입력하면 대화가 백그라운드 세션으로 넘어가고 터미널이 풀립니다.

공식 문서에 따르면 Claude가 한창 응답 중이었어도 그 응답은 백그라운드에서 이어집니다. 여기에 지시를 덧붙여 보내도 됩니다.

/bg 테스트 스위트 돌리고 실패 다 고쳐놔

돌고 있던 백그라운드 셸 명령이나 서브에이전트도 함께 옮겨집니다.

claude –bg: 처음부터 백그라운드로

터미널을 아예 점유하지 않고 시작하는 방법도 있습니다.

claude --bg --name "flaky-test" "SettingsChangeDetector 플레이키 테스트 조사해줘"

실행하면 세션 ID와 함께 관리 명령 안내가 뜹니다. 셸은 바로 다음 입력을 받고요.

• claude agents: 세션 목록 뷰 열기
• claude attach <id>: 이 터미널로 세션 열기
• claude logs <id>: 최근 출력 확인
• claude stop <id>: 세션 중단

agent view: 일꾼들의 관제탑

claude agents를 실행하면 돌고 있는 세션이 상태별로 묶인 화면이 뜹니다. 일하는 중, 입력 대기, 완료, 실패가 아이콘 색과 애니메이션으로 구분돼요.

각 행에는 한 줄 요약이 붙습니다. 작업 중엔 세션 출력에서 최대 15초에 한 번 갱신됩니다. 턴이 끝나면 작고 빠른 모델이 요약을 새로 써 줘요.

행을 고르고 Space를 누르면 상세 내용을 살짝 열어 봅니다(peek). Enter를 누르면 그 세션에 완전히 붙고요(attach). 빈 입력에서 ←를 누르면 다시 관제탑으로 나와요.

입력창에 프롬프트를 치면 그 자리에서 새 백그라운드 세션을 바로 파견할 수 있습니다.

파일 충돌 걱정은 워크트리가 막습니다

백그라운드 세션 여럿이 같은 저장소를 고치면 충돌하지 않을까요?

기본 동작으로 백그라운드 세션은 파일을 편집하기 전에 .claude/worktrees/ 아래 격리된 git 워크트리로 이동합니다. 각자 자기 사본에서 작업하는 구조예요.

워크트리로 옮겨 간 세션은 변경을 알아서 커밋합니다. 원격이 있으면 push까지 하고요. 단 main·master 직행 push나 force push는 하지 않아요. 커밋을 직접 하겠다고 CLAUDE.md 등에 적어 두면 git은 사용자 몫으로 남깁니다.

git 저장소가 아니거나 이미 워크트리 안이라면 이 격리는 건너뜁니다. worktree.bgIsolation 설정으로 끌 수도 있어요.

/tasks: 이 세션의 백그라운드 작업 목록

공식 명령어 문서 기준으로 /tasks는 지금 세션 안에서 돌아가는 백그라운드 작업을 나열합니다. 끝난 서브에이전트까지 포함해서요.

agent view가 세션 단위 관제탑이라면 /tasks는 세션 안쪽 작업 현황판입니다.

끝나면 알아서 알려 줍니다

agent view를 띄워 둔 상태라면, 백그라운드 세션이 입력을 기다리거나 완료·실패할 때 터미널 알림이 옵니다.

일반 세션의 입력창 아래에도 ← 2 agents처럼 입력을 기다리는 에이전트 수가 표시됩니다. 화면을 계속 감시할 필요가 없어요.

권한 설정은 걱정하지 않아도 됩니다. 백그라운드로 넘어가도 acceptEdits·auto 같은 현재 권한 모드가 그대로 유지되고 /add-dir로 추가한 디렉터리도 함께 넘어갑니다.

정리

터미널을 붙잡는 긴 작업은 /bg로 뒤로 보내고 새 작업은 claude --bg로 처음부터 백그라운드에 파견하세요.

관리는 claude agents 관제탑에서, 세션 안 현황은 /tasks로 봅니다. 워크트리 격리 덕에 병렬 작업의 파일 충돌도 걱정이 없어요.

다음 편에서는 세션의 속도와 품질을 조절하는 /model·/effort·/fast·/advisor를 묶어 다룹니다.

출처 및 확인 기준

• Claude Code 공식 문서 — Background agents (agent view) (Anthropic, 2026-08-14 확인)
• Claude Code 공식 문서 — Commands (Anthropic, 2026-08-14 확인)

이어서 읽기

Claude Code 시리즈

• 이전 편: [Claude Code #2] /plan 계획 모드, 수정 전에 설계부터 합의하기
• 이전 편: [Claude Code #1] /init, CLAUDE.md 자동 생성으로 시작하기

관련 주제

• [에이전트 설계 #1] 하네스 엔지니어링이란? 프롬프트 다음에 오는 것