작성자 주: Claude Code에 새로 도입된 Agent View 연구 프리뷰(Research Preview) 버전에 대해 핵심 기능, 4단계 시작 방법, tmux 멀티 윈도우와의 비교, 그리고 백그라운드 세션 과금 주의사항까지 한눈에 정리해 드립니다.
코딩을 하다 보면 여러 개의 Claude Code 작업을 동시에 돌릴 때가 있죠. 아마 이런 경험 한 번쯤 있으실 겁니다. 화면에 터미널 탭이 6개나 떠 있고, 각 탭에서 AI가 코드를 작성하거나 테스트를 돌리는 동안, 혹시라도 AI가 "계속할까요?"라고 물어보는 프롬프트를 놓칠까 봐 탭을 이리저리 오가며 확인하는 상황 말입니다. tmux 화면 분할도 임시방편일 뿐, 근본적인 해결책은 아닙니다. 진짜 문제는 '창'이 아니라 "어떤 세션이 실행 중이고, 어떤 세션이 내 입력을 기다리는지 알 수 없다"는 점이니까요.
Anthropic이 2026년 5월 11일 공개한 Claude Code Agent View 연구 프리뷰는 바로 이 고충을 해결하기 위해 나왔습니다. 실행 중인 모든 Claude Code 세션을 하나의 대시보드에 모아주어, 누가 작업 중인지, 누가 입력을 기다리는지, 누가 이미 완료되었는지를 한눈에 파악할 수 있게 해줍니다. 이 가이드에서는 Agent View의 기능과 사용법, 그리고 기존의 tmux 멀티 윈도우 방식과의 차이점을 알기 쉽게 설명해 드릴게요. 이 글을 다 읽고 나면 현재 사용 중인 워크플로우를 바꿀 가치가 있는지 바로 판단하실 수 있을 겁니다.
Claude Code Agent View란 무엇인가
Claude Code Agent View는 Claude Code CLI에 내장된 세션 대시보드로, Claude Code v2.1.139 이상 버전에서 사용할 수 있습니다. 여러 Claude Code 세션을 '명단' 형태로 한 화면에 나열해주며, 각 행마다 세션 상태, 최근 활동, 그리고 현재 무엇을 기다리고 있는지 보여줍니다.
이것은 별도의 새로운 도구가 아니라 Claude Code 자체의 기능입니다. 더 이상 병렬 작업을 위해 tmux 창이나 iTerm2 화면 분할을 따로 설정할 필요가 없습니다. claude agents 명령어 한 번이면 대시보드로 진입하여 모든 세션을 한눈에 관리할 수 있죠. 개발자 입장에서는 'AI 세션 관리'라는 문제에 대한 공식적인 해결책이 생긴 셈입니다.
참고로, Agent View는 현재 연구 프리뷰 단계이며 Pro, Max, Team, Enterprise 구독자 및 Claude API 사용자를 대상으로 제공됩니다. APIYI(apiyi.com)를 통해 Claude 모델을 사용하는 개발자라면, Claude Code의 ANTHROPIC_BASE_URL을 APIYI로 설정하여 Anthropic 공식 CLI를 그대로 사용하면서도 국내의 안정적인 네트워크와 캐시 과금 0.1x의 비용 혜택을 누릴 수 있습니다.
Agent View를 이해하는 또 다른 방법은 기존 방식과의 관계를 보는 것입니다. 과거에는 여러 Claude Code를 실행하기 위해 터미널 탭을 여러 개 열거나, tmux로 화면을 나누거나, 백그라운드 프로세스를 관리하는 쉘 스크립트를 직접 짜야 했습니다. 하지만 탭이 너무 많아 관리가 안 되거나, tmux의 학습 곡선이 높거나, 직접 짠 스크립트에서 PID나 로그, 상태 동기화를 직접 처리해야 하는 등 불편함이 컸죠. Agent View는 이 모든 것을 통합하여 'AI 작업 관리자'와 같은 경험을 제공합니다.
Claude Code Agent View의 5가지 핵심 능력
Agent View는 단순히 목록을 보여주는 인터페이스처럼 보이지만, 사실 여러 도구에 흩어져 있던 기능들을 하나로 통합한 강력한 도구입니다. 다음 표는 꼭 기억해야 할 5가지 핵심 능력을 정리한 것입니다.
| 능력 | 동작 | 해결하는 문제 |
|---|---|---|
| 세션 목록 | 모든 Claude Code 세션 및 상태 나열 | tmux 탭이 너무 많아 관리가 어려움 |
| 상태 시각화 | 작업 중 / 입력 대기 / 완료 / 실패 / 유휴 / 중지 | 누가 내 입력을 기다리는지 모름 |
| 백그라운드 실행 | /bg, claude --bg로 세션을 포그라운드에서 분리 |
터미널 창을 계속 점유할 필요 없음 |
| 빠른 미리보기 | 방향키 선택 + 스페이스바(Peek) | 세션에 들어가지 않고도 최신 출력 확인 |
| 자동 워크트리(Worktree) | 파일 작성 시 .claude/worktrees/로 자동 격리 |
다중 세션 병렬 수정 시 충돌 방지 |
🎯 사용 팁: Agent View를 처음 써보신다면, 먼저 서로 다른 작업의 백그라운드 세션 2개를 띄워 상태 변화를 관찰해 보세요. 익숙해지면 4~5개까지 병렬 작업을 늘려보세요. APIYI(apiyi.com)의 Claude 모델 API를 활용하면 국내에서도 Agent View의 장기 실행 능력을 훨씬 안정적으로 누릴 수 있습니다.
세션 목록은 Agent View의 가장 직관적인 기능입니다. 예전에는 "위쪽 탭은 프론트엔드 수정, 아래쪽은 테스트 실행"이라고 머릿속으로 기억해야 했지만, 이제 대시보드가 각 세션의 이름과 최근 활동을 바로 알려줍니다. 상태 시각화는 이 도구의 '영혼'과도 같습니다. 상태 레이블을 훑어보는 것만으로도 즉시 처리가 필요한 세션을 파악할 수 있어, 모든 창을 일일이 확인하는 수고를 덜어줍니다. 6가지 상태(working / waiting / completed / failed / idle / stopped)에 익숙해지면, 거의 모든 세션을 직접 attach할 필요가 없다는 것을 깨닫게 될 거예요.
백그라운드 실행은 Agent View가 tmux를 대체할 수 있는 핵심 이유입니다. /bg는 현재 세션을 백그라운드로 보내고, claude --bg "<task>"는 처음부터 백그라운드 모드로 새 작업을 시작합니다. 둘 다 터미널이 연결되어 있지 않아도 Claude Code가 작업을 계속 진행하게 해줍니다. 자동 워크트리 격리 기능 덕분에 여러 세션이 같은 저장소를 수정해도 서로 덮어쓰지 않습니다.
Peek 미리보기 기능도 짚고 넘어갈 만합니다. 예전에는 세션 진행 상황을 보려면 무조건 attach해서 화면이 다시 렌더링되길 기다려야 했고, 그사이에 중요한 질문을 놓치기도 했습니다. Agent View의 Peek 패널은 '최신 출력'이나 '답변 대기 중인 질문'만 보여주므로, 메시지 미리보기처럼 훨씬 효율적으로 정보를 확인할 수 있습니다.
Claude Code Agent View 시작하기 및 사용법
Agent View는 진입 장벽이 매우 낮습니다. 다음 4단계만 따라 하면 바로 사용 가능합니다.
| 단계 | 명령 또는 조작 | 역할 |
|---|---|---|
| 1. 버전 업그레이드 | claude --version 확인 후 ≥ v2.1.139로 업데이트 |
Agent View 활성화 조건 충족 |
| 2. 대시보드 진입 | 터미널에 claude agents 입력 또는 세션 내 왼쪽 방향키 |
세션 목록 열기 |
| 3. 백그라운드 시작 | claude --bg "utils 디렉토리 리팩토링" |
백그라운드 세션 바로 생성 |
| 4. 전환 및 대응 | 방향키로 행 선택 → 스페이스바(미리보기) → 엔터(진입) | 진행 상황 확인, 질문 답변, 결과 확인 |
🎯 빠른 시작 팁: Claude Code의
ANTHROPIC_BASE_URL을https://api.apiyi.com/v1으로 설정하고 APIYI(apiyi.com)의 Claude 모델 키를 사용하면 국내에서도 Agent View를 원활하게 실행할 수 있습니다. 캐시 비용이 0.1배로 적용되어 다중 세션 장기 실행 시 비용 부담이 공식 인터페이스보다 훨씬 낮습니다.
다음은 가장 흔한 작업 시나리오입니다. 풀스택 프로젝트에서 '백엔드 API 설계'와 '프론트엔드 컴포넌트 재작성'이라는 두 가지 독립적인 작업을 동시에 수행해야 할 때 이렇게 구성할 수 있습니다.
# 두 개의 백그라운드 세션 시작
claude --bg "사용자 로그인 모듈의 백엔드 REST API 설계 및 OpenAPI 설명 작성"
claude --bg "Header 컴포넌트 재작성 및 새 사용자 메뉴 추가"
# 언제든지 Agent View를 열어 진행 상황 확인
claude agents
Agent View에 진입하면 두 세션이 행 형태로 나열됩니다. 특정 행의 상태가 Waiting for input으로 바뀌면, Claude가 "필드를 새로 추가할까요?"와 같은 의사결정을 기다리고 있다는 뜻입니다. 이때 방향키로 선택하고 스페이스바를 눌러 미리보기를 한 뒤, 내용을 확인하고 엔터를 눌러 세션에 진입해 답변하면 됩니다.
APIYI(apiyi.com)의 Claude 키를 사용하면 공식 API와 동일한 경험을 누릴 수 있으며, 국내 네트워크 환경에서도 백그라운드 세션이 끊기지 않아 '야간 무인 작업'을 수행하려는 개발자에게 매우 유용합니다.
초보자가 가장 많이 하는 실수는 /bg와 claude --bg의 사용 시나리오를 혼동하는 것입니다. /bg는 이미 열려 있는 세션 안에서 입력하는 명령어로, "현재 세션을 백그라운드로 보내고 계속 실행"하는 용도입니다. 반면 claude --bg "<task>"는 셸에서 바로 새로운 백그라운드 작업을 시작하는 것으로, 처음부터 터미널을 점유하지 않습니다. 전자는 "현재 대화 일시 중지", 후자는 "새 직원을 고용해 독립적으로 일 시키기"에 가깝습니다.
Claude Code Agent View와 tmux 다중 창 비교
Agent View를 이해하는 또 다른 관점은, 이것이 무엇을 대체하는지 살펴보는 것입니다. 아래 표는 '기존의 tmux 다중 창 방식'과 '새로운 Agent View 방식'의 핵심적인 경험 차이를 비교한 것입니다.
| 구분 | tmux 다중 창 | Claude Code Agent View |
|---|---|---|
| 상태 파악 | 창을 일일이 전환하며 확인 | 한 화면에서 모든 세션 상태 확인 |
| 백그라운드 실행 | 직접 창 생성 + 데몬 스크립트 | claude --bg "<task>" 한 줄 명령 |
| 입력 대기 | 놓치면 작업 멈춤 | 대시보드에서 "Waiting for input" 강조 |
| 다중 세션 파일 쓰기 | 서로 덮어쓸 위험 있음 | 자동 worktree 격리 |
| 학습 비용 | 단축키 숙달 필요 | 방향키 / Space / Enter로 충분 |
| 복잡한 협업 | 유연하지만 직접 스크립트 작성 필요 | Agent Teams와 결합하여 확장 가능 |
🎯 선택 가이드: 1인 개발의 병렬 작업이라면 Agent View만으로도 충분합니다. 만약 여러 에이전트가 협업해야 하는 상황(팀 모드)이라면, Anthropic의 Agent Teams가 여전히 tmux나 iTerm2의 화면 분할 기능을 필요로 합니다. 두 방식은 서로 충돌하지 않습니다. APIYI(apiyi.com)는 동일한 Claude 모델을 지원하므로 어떤 방식을 선택하든 문제없이 사용할 수 있습니다.
'세션 격리'의 세부 사항은 짚고 넘어갈 가치가 있습니다. Claude Code는 Agent View 모드에서 특정 세션이 파일을 수정하려고 하면, 자동으로 .claude/worktrees/ 아래의 독립적인 작업 트리로 이동시킵니다. 모든 병렬 세션은 원본 체크아웃의 '읽기' 권한은 공유하지만, 각자 독립적인 '쓰기' 영역을 가집니다. 작업이 끝난 후 어떤 변경 사항을 병합할지 결정하면 됩니다. 이러한 '읽기 공유, 쓰기 격리' 모델은 과거 숙련된 개발자들이 다중 에이전트 워크플로우를 직접 구축할 때 강조하던 모범 사례와 정확히 일치합니다.
이 메커니즘은 노련한 개발자들이 '병렬 작업마다 git worktree를 하나씩 생성'하던 방식과 완전히 동일합니다. Anthropic은 이를 누구나 바로 사용할 수 있는 기본 동작으로 만든 것이죠. 초보자에게는 worktree를 몰라도 안전하게 여러 Claude Code 작업을 병렬로 수행할 수 있다는 것을 의미합니다.
Agent View가 본인의 일상적인 워크플로우에 적합한지 판단할 수 있도록, 현재 가장 적합한 시나리오와 그렇지 않은 시나리오를 아래 표로 정리했습니다.
| 유형 | 추천 여부 | 이유 |
|---|---|---|
| 다중 디렉터리 코드 리팩토링 | ✅ 강력 추천 | 자동 worktree + 백그라운드 실행과 완벽한 궁합 |
| 문서/테스트 자동 생성 | ✅ 추천 | 모듈별 세션 분리, 상태 한눈에 파악 가능 |
| 의존성 일괄 업데이트 | ✅ 추천 | 저장소당 에이전트 하나씩, 간섭 없음 |
| 데이터 분석 탐색 | ⚠️ 상황에 따라 | 작업이 짧고 전환이 잦으면 효율이 낮음 |
| 실시간 채팅/질의응답 | ❌ 비추천 | 단일 세션이면 충분, 에이전트 다중 실행은 낭비 |
| 팀 다중 에이전트 협업 | ⚠️ Agent Teams 권장 | 화면 분할 협업 필요, tmux/iTerm2 병행 권장 |
Claude Code Agent View 자주 묻는 질문(FAQ)
Q1: Agent View는 유료인가요? 구독 한도에 포함되나요?
Agent View 자체는 무료이지만, 각 백그라운드 세션은 전면 세션과 마찬가지로 Claude 구독 한도나 API 잔액을 소모합니다. 예를 들어 10개의 에이전트를 동시에 실행하면 한도가 약 10배 속도로 소모되므로, 특히 Pro 요금제 사용자는 동시 세션 수를 주의 깊게 관리하여 비용을 예측해야 합니다.
Q2: 백그라운드 세션은 계속 실행되나요? 컴퓨터를 끄면 어떻게 되나요?
백그라운드 세션은 사용자의 로컬 기기에서 실행됩니다. 기기가 절전 모드로 전환되거나, 종료되거나, Claude Code 프로세스가 종료되면 세션도 중단됩니다. 클라우드 기반 에이전트가 아니기 때문에 컴퓨터를 다시 켜면 세션을 다시 활성화해야 합니다. 진정한 "무인" 장기 작업을 수행하려면 기기가 계속 깨어 있는 상태를 유지해야 합니다.
Q3: Agent View와 Agent Teams는 같은 기능인가요?
아닙니다. Agent View는 "한 화면에서 여러 세션을 관리"하는 대시보드이며, 각 세션은 독립적인 작업을 수행합니다. 반면 Agent Teams는 "여러 에이전트가 서로 협업"하는 다중 역할 메커니즘으로, 리더가 여러 팀원을 조율하여 작업을 진행하며 tmux나 iTerm2를 통한 화면 분할이 필요합니다. 두 기능은 서로 충돌하지 않으며 공존할 수 있습니다. 전자는 "멀티태스킹 관리"를, 후자는 "다중 역할 협업" 문제를 해결합니다.
Q4: 국내에서 Agent View를 안정적으로 사용할 수 있나요?
Agent View는 로컬 CLI 기능이지만, 기본 모델 호출은 Anthropic API를 거치므로 국내 네트워크 환경의 영향을 받을 수 있습니다. APIYI(apiyi.com)에서 제공하는 Claude 모델을 통해 ANTHROPIC_BASE_URL을 APIYI로 설정하면 장기 실행 세션의 중단 문제를 해결할 수 있으며, 플랫폼은 이미 안정적으로 운영되고 있습니다.
Q5: 10개의 백그라운드 에이전트로 인해 한도가 초과되는 것을 어떻게 방지하나요?
세 가지 실용적인 방법이 있습니다. claude --bg 실행 전 각 작업의 예상 업무량을 명확히 파악하고, Agent View에서 idle(대기) 상태인 세션을 주기적으로 정리하며, 캐시 가능한 시스템 프롬프트를 앞쪽에 배치하여 0.1x 캐시 요금을 활용하세요. APIYI(apiyi.com)는 기본적으로 캐시 전략을 지원하므로 장기 실행 시 비용을 크게 절감할 수 있습니다.
Q6: Agent View에서 AI에게 직접 응답할 수 있나요?
네, 가능합니다. 대기 중인 세션을 선택하고 스페이스바를 눌러 Peek(미리보기)를 실행하면 AI가 무엇을 묻고 있는지 확인할 수 있습니다. 간단한 "yes/no" 결정이라면 Peek 패널에서 바로 "yes, ship it"과 같이 입력하여 세션을 즉시 진행할 수 있으며, 전체 기록(transcript)으로 들어갈 필요가 없습니다. 이는 "AI가 10분마다 한 번씩 묻는" 장기 작업에 매우 유용합니다.
Q7: Agent View는 어떤 상황에서 사용하기 좋나요?
다음 세 가지 경우에 가장 적합합니다: 장기 코드 리팩토링(여러 디렉터리 동시 실행), 문서/테스트 자동 생성(모듈별 세션), 의존성 업데이트(저장소별 세션). 이러한 작업은 "시간이 오래 걸리고, AI가 스스로 진행하며, 사람은 핵심 지점에서만 개입"한다는 공통점이 있어 Agent View의 세션 관리 경험과 완벽하게 일치합니다. APIYI(apiyi.com)를 통해 Claude에 접속한 후 백그라운드를 실행하면 더욱 안정적인 장기 실행 환경을 구축할 수 있습니다.
Q8: Agent View 사용 후에도 tmux를 계속 써야 하나요?
네, 하지만 사용 방식은 달라집니다. tmux는 여전히 Agent Teams 협업의 기초이자 원격 서버 환경에서 세션을 유지하는 가장 간단한 방법입니다. 하지만 1인 개발자의 로컬 병렬 작업에 있어서는 Agent View가 tmux의 역할을 대부분 대체할 수 있습니다.
Claude Code Agent View 핵심 요약
- Agent View는 Claude Code v2.1.139에 도입된 공식 대시보드로, 여러 세션을 한 화면에서 관리할 수 있습니다.
- 2026년 5월 11일 Research Preview 형태로 출시되었으며, Pro, Max, Team, Enterprise 및 API 사용자에게 제공됩니다.
- 5대 핵심 기능: 세션 목록, 상태 시각화, 백그라운드 실행, Peek 빠른 미리보기, 자동 워크트리(worktree) 격리.
- 실행 방법:
claude agents명령어를 입력하거나, 세션 내에서 왼쪽 방향키를 누르면 됩니다. - 백그라운드 명령어
/bg및claude --bg "<task>"를 통해 세션을 터미널 전면에서 분리하여 계속 진행할 수 있습니다. - 백그라운드 세션도 구독 한도를 소모하므로 비용 예측과
idle세션 정리가 필요합니다. - APIYI(apiyi.com)를 통해 Claude 모델을 연결하고 Agent View를 활용하면 국내 접속 안정성을 확보하고 0.1x 캐시 요금 혜택을 누릴 수 있습니다.
요약
Claude Code Agent View의 핵심 가치는 기존에 tmux, 커스텀 데몬 스크립트, 그리고 사용자의 기억력에 의존해야 했던 '다중 AI 세션 관리' 작업을 Claude Code 자체 기능으로 통합했다는 점입니다. 초보자라면 복잡한 Unix 도구 체인을 따로 배우지 않아도 한 대의 머신에서 여러 개의 Claude 작업을 동시에 효율적으로 실행할 수 있게 되며, 숙련자라면 worktree 격리, 백그라운드 세션, 상태 인식 등을 기본 동작으로 활용해 반복적인 수고를 크게 덜 수 있습니다. 즉, Agent View는 '여러 AI를 동시에 구동하는 것'을 엔지니어링 지식이 필요한 고급 기술에서 누구나 사용할 수 있는 기본 기능으로 탈바꿈시켰습니다.
Agent View를 본격적으로 활용해보고 싶다면 Claude Code의 ANTHROPIC_BASE_URL을 APIYI(apiyi.com)로 설정하는 것을 추천합니다. 이를 통해 국내에서 안정적인 모델 호출이 가능할 뿐만 아니라, 캐시 비용 0.1배 혜택을 통해 장시간 실행되는 백그라운드 작업의 비용 부담까지 줄일 수 있습니다. 현재 국내 개발자가 Agent View를 도입하기에 가장 최적화된 조합입니다.
— APIYI 기술팀, 더 많은 AI 모델 실전 튜토리얼은 APIYI(apiyi.com)에서 확인하세요.
