Claude Code Agent View 사용법 총정리: 실행 방법부터 주요 명령어까지

Claude Code에 새로운 기능이 추가되었습니다. 바로 ‘Agent View’입니다. Agent View는 여러 Claude Code 세션을 한 화면에서 확인하고 관리할 수 있도록 만든 기능입니다.

그동안 Claude Code로 여러 작업을 동시에 진행하려면 각각의 터미널을 따로 열어두고, 어떤 세션이 실행 중인지, 어디에서 사용자 입력을 기다리는지, 어떤 작업이 완료됐는지 직접 확인해야 하는 어려움이 있었습니다.

하지만 Agent View가 추가되면서 사용자는 여러 Claude Code 세션을 한 화면에서 관리하고, 필요한 작업에만 빠르게 개입할 수 있습니다.

이 글에서는 Claude Code Agent View의 사용법과 기존 tmux 방식과의 차이, 실무 활용 시 주의할 점을 정리합니다.

Claude Code Agent View 핵심 요약 4가지

• Agent View는 여러 Claude Code 세션을 한 화면에서 관리하는 기능입니다. 실행 중인 세션, 입력 대기 중인 세션, 완료된 작업을 한눈에 확인할 수 있어 여러 터미널을 오가며 상태를 확인해야 하는 불편함을 줄여줍니다.
• tmux와 달리 Claude Code 세션 상태 관리에 특화되어 있습니다. tmux가 터미널 창과 패널을 직접 나누는 방식이라면, Agent View는 실행 중인 Claude Code 세션을 모아 보여주고 필요한 작업에만 빠르게 개입할 수 있게 해줍니다.
• 백그라운드 세션과 Peek 기능으로 병렬 작업 흐름을 만들 수 있습니다. 새 작업을 백그라운드 세션으로 실행하거나 기존 작업을 백그라운드로 전환할 수 있고, Peek 기능으로 세션에 들어가지 않아도 최근 응답과 진행 상황을 빠르게 확인할 수 있습니다.

여러 세션을 동시에 실행할수록 작업 범위와 실행 위치 관리가 중요합니다.
 같은 파일이나 기능을 여러 세션이 동시에 수정하면 충돌이 생길 수 있으므로, 세션별 역할을 나누고 각 세션이 어느 디렉터리에서 실행되는지 확인해야 합니다.

Claude Code Agent View란?

Claude Code Agent View는 여러 Claude Code 세션을 한 화면에서 확인하고 관리할 수 있도록 만든 세션 관리 기능으로 여러 AI 코딩 작업을 동시에 운영하기 위해 추가된 기능입니다.

Agent View를 사용하면 현재 어떤 세션이 실행 중인지, 어떤 세션이 사용자 입력을 기다리는지, 어떤 작업이 완료됐는지 한눈에 확인할 수 있습니다.

새로운 백그라운드 세션을 실행하거나, 각 세션의 상태를 확인하고, 필요한 경우 특정 세션에 들어가 기존 Claude Code처럼 작업을 이어갈 수 있습니다. 

덕분에 버그 수정, 테스트 확인, 문서 정리처럼 서로 다른 작업을 여러 세션으로 나누어 병렬로 진행할 수 있습니다. 

Claude Code Agent View가 

주목받는 이유 

여러 Claude Code 세션을 한 화면에서 관리합니다

Claude Code Agent View는 여러 Claude Code 세션을 하나의 화면에 모아 보여주기 때문에, 터미널을 오가며 확인하지 않아도 각 세션의 진행 상태를 한눈에 파악할 수 있습니다.

덕분에 작업이 많아질수록 각 터미널을 직접 열어보며 어떤 작업이 진행 중인지, 어떤 세션이 사용자 입력을 기다리는지 일일이 확인해야 하는 불편함없이 필요한 업무를 빠르게 처리할 수 있습니다.

필요한 순간에만 개입할 수 있습니다

Agent View의 핵심은 Claude Code에게 여러 작업을 맡겨두고, 사용자는 상태를 확인하다가 필요한 순간에만 개입할 수 있다는 점입니다.

각 세션이 독립적으로 실행되기 때문에 하나의 작업이 끝날 때까지 기다리지 않고, 여러 작업의 흐름을 동시에 관리할 수 있습니다.

버그 수정, 풀 리퀘스트 검토, 로그 조사처럼 여러 AI 코딩 작업을 병렬로 운영하는 방식으로 활용할 수 있어 작업 생산성과 효율성을 모두 높일 수 있습니다. 

Claude Code Agent View vs tmux, 

무엇이 다를까?

기존에는 Claude Code를 병렬적으로 여러 개의 작업을 동시에 진행하기 위해 tmux나 여러 터미널 창을 활용해야 했습니다. 

버그 수정, 테스트 분석, 코드 리뷰처럼 서로 다른 작업을 각각의 터미널에서 실행하고, 사용자가 직접 창을 오가며 진행 상황을 확인하는 방식이었습니다.

이러한 불편을 해결하기 위해 Claude Code Agent View 기능이 추가되었는데요. tmux와 무엇이 다른지 살펴보겠습니다. 

tmux, 터미널 작업 흐름을 사용자가 직접 나누는 방식

tmux는 하나의 터미널 안에서 여러 창과 패널(Pane)을 나누어 사용할 수 있는 터미널 멀티플렉서입니다. 

Claude Code를 여러 개 실행할 때도 tmux를 활용하면 각 작업을 별도 창에 띄워두고 병렬로 진행할 수 있습니다.

다만 Claude Code 전용으로 설계된 기능은 아니기 때문에, 어떤 세션이 입력을 기다리고 있는지, 어떤 작업이 완료됐는지, 마지막 응답이 무엇이었는지는 사용자가 직접 창을 이동하며 확인해야 합니다.

▶ tumx로 Claude Code에서 병렬로 작업을 진행하는 방식 보러가기

Claude Code Agent View, 여러 Claude Code 세션 상태를 한 화면에서 관리하는 방식

Claude Code Agent View는 여러 Claude Code 세션을 한 화면에서 확인하고 관리하기 위한 전용 기능으로, 터미널 창을 직접 나누는 것이 아니라, 실행 중인 Claude Code 세션을 Agent View 안에서 모아 보여주는 방식입니다.

Agent View를 사용하면 어떤 세션이 작업 중인지, 어떤 세션이 사용자 입력을 기다리는지, 마지막 응답은 무엇인지 한눈에 확인할 수 있습니다.

필요한 경우 특정 세션에 들어가 대화를 이어가고, 다시 Agent View로 돌아와 다른 세션의 상태를 확인할 수도 있습니다.

tmux가 여러 터미널을 직접 운영하는 방식이라면, Agent View는 여러 Claude Code 작업 상태를 중심으로 관리하는 방식입니다. 

Agent View를 사용하면 Claude Code 세션이 많아져도 사용자는 모든 터미널을 오가지 않아도 되고, 필요한 작업에만 빠르게 개입할 수 있습니다.

Claude Code Agent View 사용법 

Claude Code Agent View는 v2.1.139 이상 버전부터 Research Preview로 추가되어, claude agents 명령어로 실행할 수 있습니다.

Claude Code Agent View 사용을 위해 위의 명령어를 입력해 최신 버전으로 업데이트 합니다.

업데이트가 완료되면 터미널 화면에 claude agents를 입력하면 Claude Code Agents View 메인 화면이 나옵니다.

세션 목록을 이동하고 작업 화면으로 들어가기 

Agent View 화면에서는 위/아래 방향키를 사용해 여러 세션 목록을 이동할 수 있습니다.
확인하고 싶은 세션을 선택한 뒤 Enter 또는 오른쪽 방향키(→)를 누르면 해당 Claude Code 세션 내부로 들어갑니다.

세션 내부로 들어가면 기존 Claude Code를 사용할 때처럼 대화를 이어가거나, 작업 결과를 확인하고 추가 지시를 내릴 수 있습니다. 

다시 전체 세션 목록이 있는 Agent View 화면으로 돌아가고 싶다면 왼쪽 방향키(←)를 누르면 됩니다.

Space로 세션 내용을 빠르게 확인하기 

Agent View에서는 특정 세션에 완전히 들어가지 않아도 Space 키를 사용하면 최근 진행 상황을 빠르게 확인할 수 있습니다.

이 기능을 사용하면 마지막 응답이나 현재 상태를 간단히 확인할 수 있어, 여러 세션을 동시에 관리할 때 유용합니다.

Claude Code가 사용자 판단을 기다리고 있는 경우에도 해당 세션에 바로 들어가지 않고 내용을 먼저 확인할 수 있습니다. 덕분에 어떤 세션에 먼저 개입해야 하는지 빠르게 판단할 수 있습니다.

세션을 정렬하고 고정하기

세션이 많아지면 목록을 정리하는 기능도 중요합니다.
Ctrl + S를 누르면 세션 목록을 상태별 또는 디렉터리별로 정렬할 수 있습니다. 여러 프로젝트를 동시에 다루는 경우에는 디렉터리 기준으로 묶어보면 어떤 프로젝트에서 어떤 작업이 진행 중인지 확인하기 쉽습니다.

중요한 세션은 Ctrl + T로 상단에 고정할 수 있습니다. 자주 확인해야 하는 작업이나, 검토가 필요한 세션을 고정해두면 목록이 많아져도 빠르게 찾을 수 있습니다.

세션 순서를 직접 바꾸고 싶다면 Shift + ↑, Shift + ↓를 사용하면 됩니다. 진행 중인 작업, 확인이 필요한 작업, 완료된 작업을 원하는 순서로 배치해 관리할 수 있습니다.

필요 없는 세션 삭제하기

작업이 끝났거나 더 이상 필요하지 않은 세션은 Ctrl + X로 정리할 수 있습니다. 선택한 세션에서 Ctrl + X를 한 번 누르면 중지되고, 짧은 시간 안에 한 번 더 누르면 목록에서 삭제됩니다.

단축키가 동작하지 않는다면 한글 입력 상태인지 확인하는 것이 좋습니다. 터미널 환경에서는 입력기가 한글 상태일 때 일부 단축키가 제대로 작동하지 않을 수 있으므로, 단축키를 사용할 때는 영문 입력 상태로 전환하는 것이 안전합니다.

@로 subagent를 선택할 수 있습니다 

Agent View 하단 입력창에서 @를 입력하면 현재 Claude Code 환경에서 사용할 수 있는 subagent(서브 에이전트) 목록이 자동완성 형태로 표시됩니다. 

이 기능을 활용하면 작업 성격에 맞는 서브 에이전트를 선택해 프롬프트를 작성할 수 있습니다. 화면 구현은 프론트엔드 관련 서브 에이전트에게, 문서 정리는 문서 작성용 서브 에이전트에게 맡기는 식으로 작업 역할을 더 명확하게 나눌 수 있습니다. 

▶ 역할별 전문 작업을 맡기는 Subagent 제작 방법 보러가기

Claude Code 작업을 백그라운드 세션으로 실행하기

Agent View에서는 Claude Code 작업을 백그라운드 세션으로 실행해 관리할 수 있습니다. 새로운 작업을 처음부터 백그라운드로 시작할 수도 있고, 이미 진행 중인 Claude Code 작업을 중단하지 않고 백그라운드로 전환할 수도 있습니다.

새 작업을 백그라운드에서 실행하고 싶다면 터미널에서 claude --bg "작업 내용"을 입력하면 됩니다. 

이 방식은 버그 수정, 테스트 확인, 문서 정리처럼 서로 독립적인 작업을 각각의 세션으로 나누어 실행할 때 유용합니다. 하나의 작업이 끝날 때까지 기다리지 않고 여러 Claude Code 작업을 동시에 진행할 수 있습니다.

반대로 일반 Claude Code 세션에서 이미 작업을 진행 중이라면 해당 세션에 /bg 또는 /background를 입력해 작업을 백그라운드로 보낼 수 있습니다. 

백그라운드 세션을 사용하면 터미널에서 시작한 작업이 길어지더라도 그 작업에 계속 묶여 있을 필요가 없습니다. 진행 중인 작업은 Agent View에서 관리하고, 사용자는 다른 세션을 확인하거나 새로운 작업을 시작할 수 있습니다.

* Claude Code Agent View 주요 명령어

Claude Code Agent View의 핵심 기능 

백그라운드 세션을 만들 수 있습니다

Agent View에서는 새로운 Claude Code 작업을 백그라운드 세션으로 실행할 수 있습니다. 기존에는 Claude Code로 여러 작업을 병렬로 진행하려면 tmux나 여러 터미널 창을 직접 나누어 사용해야 했지만, Agent View를 사용하면 Claude Code 세션만큼은 한 화면에서 실행하고 관리할 수 있습니다.

덕분에 하나의 작업이 끝날 때까지 기다리지 않고, 버그 수정, 테스트 확인, 문서 정리처럼 서로 독립적인 작업을 각각의 백그라운드 세션에 맡길 수 있습니다.

기존 작업을 백그라운드로 보낼 수 있습니다

Agent View를 활용하면 작업을 처음부터 Agent View에서 시작하지 않았더라도, 진행 중인 세션을 중단하지 않고 백그라운드로 전환할 수 있습니다.

현재 작업은 Agent View에서 계속 관리하고, 사용자는 다른 Claude Code 세션을 확인하거나 새로운 작업을 시작할 수 있습니다.

덕분에 이전에 시작한 작업이 길어지더라도 해당 작업에 계속 묶여 있을 필요 없이, 빠르게 다른 작업으로 전환할 수 있습니다.

Peek 기능으로 세션 내용을 빠르게 확인할 수 있습니다

Peek은 Agent View에서 특정 Claude Code 세션의 최근 내용을 미리 확인할 수 있는 기능입니다.

세션 전체로 들어가지 않아도 마지막 응답이나 현재 진행 상황을 볼 수 있어, 여러 작업을 동시에 관리할 때 빠르게 상태를 파악하는 데 유용합니다.

작업 결과를 간단히 확인하거나, Claude Code가 사용자 판단을 기다리는 상황에서 빠르게 내용을 살펴볼 때 활용할 수 있어, 불필요한 세션을 오가지 않고 필요한 작업에만 처리할 수 있습니다.

Claude Code Agent View 

사용 시 주의할 점 

서로 충돌할 수 있는 작업은 동시에 실행하지 않습니다

Agent View에서는 여러 Claude Code 세션을 백그라운드로 실행할 수 있습니다. 하지만 여러 세션이 같은 파일이나 같은 기능을 동시에 수정하면 변경 내용이 충돌할 수 있습니다.

따라서 Agent View에서는 작업 범위가 분리된 세션을 병렬로 실행하는 것이 좋습니다. 같은 컴포넌트, 같은 API, 같은 설정 파일을 수정해야 한다면 여러 세션에 나눠 맡기기보다 하나의 세션에서 처리하거나 순서를 나눠 진행하는 편이 안전합니다.

세션별 작업 범위를 명확히 나눠야 합니다

Agent View는 여러 작업을 동시에 실행할 수 있게 해주지만, 각 세션의 목표가 모호하면 관리가 복잡해질 수 있습니다. 범위가 넓은 요청을 여러 세션에 동시에 맡기면 서로 비슷한 파일을 수정하거나, 작업 방향이 달라질 수 있습니다.

그래서 Agent View를 사용할 때는 세션마다 역할을 분명히 나누는 것이 중요합니다. 한 세션은 버그 원인 분석, 다른 세션은 테스트 확인, 또 다른 세션은 문서 수정처럼 작업 단위를 구분해야 결과를 검토하기 쉽습니다.

백그라운드 세션을 방치하지 않아야 합니다

Agent View의 장점은 여러 세션을 백그라운드에서 실행하고 상태를 확인할 수 있다는 점입니다.  하지만 세션이 많아질수록 입력 대기 중인 작업이나 완료된 작업을 놓칠 수 있습니다.

따라서 여러 세션을 실행한 뒤에는 Agent View에서 입력 대기 상태, 완료 상태, 마지막 응답을 주기적으로 확인해야 합니다. 특히 코드 수정이 포함된 작업은 최종 변경 범위와 테스트 결과를 확인한 뒤 다음 작업으로 넘어가는 것이 좋습니다.

실행 위치를 반드시 확인해야 합니다

Agent View에서 새 세션을 만들면 기본적으로 현재 작업 디렉터리를 기준으로 실행됩니다. 여러 저장소나 여러 worktree를 함께 사용하고 있다면, 각 세션이 어느 프로젝트에서 실행되는지 확인해야 합니다. 

실행 위치를 확인하지 않으면 의도한 프로젝트가 아니라 다른 경로에서 작업이 진행될 수 있습니다. Agent View로 여러 작업을 동시에 실행할수록, 세션을 시작하기 전에 작업 디렉터리와 대상 저장소를 먼저 확인하는 것이 중요합니다.

클로드 코드, 그냥 사용하지 말고 이렇게 사용하세요

Claude Code Subagent 사용법, 역할만 정해주면 알아서 처리합니다

Claude Code /goal 출시: 목표만 주면 AI가 끝까지 처리한다

클로드 코드 에이전트 팀 사용법, 역할별 AI 팀으로 개발 자동화하기