Claude Code Agent View란 무엇인가 — 백그라운드 세션이 프로젝트 컨텍스트를 공유하는 방식과 수정 사항 저장 위치 (2026)

Anthropic의 문서는 이를 다음과 같이 설명합니다: "claude agents로 열 수 있는 Agent view는 실행 중인 작업, 입력이 필요한 작업, 완료된 작업 등 모든 백그라운드 세션을 위한 하나의 화면입니다."

각 행은 별도의 세션입니다. "각 백그라운드 세션은 터미널 연결 없이 계속 실행되는 완전한 Claude Code 대화이며, 원할 때 언제든지 열고 응답하고 나갈 수 있습니다."

세 가지 방식으로 행을 다룰 수 있습니다:

• Dispatch (할당). 하단에 프롬프트를 입력하고 Enter를 누릅니다. "여기에서 입력하는 모든 프롬프트는 고유한 새 세션을 시작합니다."
• Peek (엿보기). 행에서 Space를 눌러 최신 상태, 결과 또는 대기 중인 질문을 확인하고 목록을 벗어나지 않고 응답할 수 있습니다.
• Attach (연결). Enter 또는 오른쪽 화살표를 눌러 전체 대화를 열고, 빈 프롬프트에서 왼쪽 화살표를 눌러 다시 돌아갑니다.

또한 /bg 또는 왼쪽 화살표를 사용하여 열려 있는 세션을 Agent view로 보낼 수 있으며, /fork를 사용하여 세션을 새 백그라운드 세션으로 복사할 수 있습니다.

Agent view는 로컬 머신에서 세션을 실행합니다. 문서는 Claude가 클라우드에서 시작하고 추적하는 병렬 세션에 대해서는 Claude Code의 Projects를 참조하라고 안내합니다.

할당된 세션은 새로운 대화입니다. 다른 행에서 논의된 내용을 상속받지 않습니다.

대신 해당 위치에서 시작된 모든 Claude Code 세션과 동일하게 프로젝트의 상시 컨텍스트를 가져옵니다:

• 디렉토리. "새 세션은 Agent view를 연 디렉토리에서 실행됩니다." 다른 디렉토리를 대상으로 하려면 해당 위치에서 Agent view를 열거나, @<repo>로 하위 저장소를 언급하거나, 해당 디렉토리에서 claude --bg를 실행하면 됩니다.
• 지침 파일. Claude Code는 세션 시작 시 작업 디렉토리와 그 상위 디렉토리에서 CLAUDE.md 파일을 로드하고, .claude/rules/에서 paths 필드가 없는 규칙들을 로드합니다. 경로 범위가 지정된 규칙은 Claude가 일치하는 파일로 작업할 때 로드됩니다.
• 저장소 자동 메모리 (Auto memory). Claude Code의 메모리 문서에 따르면 "동일한 git 저장소 내의 모든 worktree와 하위 디렉토리는 하나의 자동 메모리 디렉토리를 공유합니다." 동일한 저장소의 백그라운드 세션은 동일한 위치에서 읽습니다.
• Agent view에서 설정한 모델 및 설정. Agent view의 /model, /effort, /fast 설정은 다음에 할당할 세션의 시작 설정이 되며, claude agents에 전달한 구성 플래그는 할당된 세션으로 전달됩니다.

메모리와 관련하여 알아두어야 할 예외가 하나 있습니다. 메모리 문서에 따르면 /memory 토글은 자동 메모리를 끄지만, 백그라운드 세션에서 다시 켜지는 않습니다. 만약 그곳에서 자동 메모리가 꺼져 있다면, 터미널에서 직접 시작한 세션에서 다시 켜야 합니다.

백그라운드 세션은 파일을 공유하지만 대화는 공유하지 않습니다.

디스크에 있는 내용을 공유합니다. CLAUDE.md 파일, 규칙, 자동 메모리 디렉토리는 저장소의 모든 세션에 대해 동일합니다. 한 세션이 자동 메모리에 노트를 저장하면, 해당 저장소의 다른 세션이 사용하는 공유 디렉토리에 저장됩니다. Claude Code 세션 간 컨텍스트 공유 가이드에서 컨텍스트를 전달하는 다른 방법들을 확인할 수 있습니다.

대화는 공유하지 않습니다. 각 행은 독립된 대화입니다. 한 세션에 응답으로 말한 내용이나 세션이 도출해낸 결과는 어딘가에 기록하지 않는 한 해당 세션에만 머뭅니다.

Fork는 복사본으로 시작하여 독립적으로 진행됩니다. /fork는 현재 대화를 모델, 권한 모드, effort 레벨, 추가된 권한 승인 사항과 함께 새 백그라운드 세션으로 복사합니다. 그 이후에는 "두 대화는 독립적이며, 복사본이 수행하는 어떤 작업도 원본 대화에 자동으로 입력되지 않습니다." 문서에는 한 가지 예외가 명시되어 있습니다. 세션 간 메시징이 활성화된 경우, 어느 한 세션의 Claude가 다른 세션에 명시적으로 메시지를 보낼 수 있습니다. Claude 앱에서 원격 세션을 포크하는 가이드에서 클라우드의 동일한 패턴을 다룹니다.

세션을 백그라운드로 보낼 때 유지되는 것. 이미 열려 있는 세션을 백그라운드로 이동하면 대화 내용이 유지됩니다. 실행 중인 백그라운드 명령, 백그라운드 subagent, /loop 작업도 그대로 이어집니다. 실행 중인 모니터는 중지되며, Claude Code가 먼저 확인을 요청합니다.

이 부분은 병렬 세션이 서로 충돌하지 않도록 방지하는 핵심입니다. 문서의 설명은 다음과 같습니다: "파일을 편집하기 전에 Claude는 세션을 .claude/worktrees/ 아래의 격리된 git worktree로 이동시킵니다. 따라서 병렬 세션은 동일한 체크아웃을 읽을 수 있지만, 쓰기는 각자의 영역에 수행합니다."

즉, 할당된 세션은 작업 디렉토리를 읽는 것으로 시작하지만, 변경 사항을 만들기 전에 자체 worktree로 이동합니다. 해당 세션이 생성한 subagent는 상위 세션의 작업 디렉토리를 상속받으므로, 그들의 수정 사항도 해당 worktree에 저장됩니다.

새로운 worktree에 포함되는 내용

Claude Code의 worktree 문서는 생성되는 worktree의 기본값을 다음과 같이 설명합니다: "저장소의 기본 브랜치에서 브랜치를 생성하고, 추적 중인(tracked) 파일만 체크아웃합니다." 또한 "worktree는 새로운 체크아웃이므로, 그곳에서 개발 환경을 초기화하십시오"라고 덧붙입니다.

컨텍스트 측면에서 이는 두 가지 방식으로 중요합니다:

• 커밋되지 않은 지침 파일의 변경 사항은 포함되지 않습니다. CLAUDE.md나 규칙을 수정하고 커밋하지 않았다면, 기본 브랜치에서 체크아웃된 worktree는 커밋된 버전만 가집니다.
• Gitignored 파일도 포함되지 않습니다. 여기에는 .env와 같은 로컬 파일이 포함됩니다. worktree 문서는 gitignored 파일을 새 worktree로 가져오기 위한 .worktreeinclude 파일에 대해 설명합니다.

worktree.baseRef 설정을 통해 시작 지점을 변경할 수 있습니다. 기본값인 "fresh"는 원격의 기본 브랜치에서 브랜치를 생성하며, "head"는 현재 로컬 HEAD에서 브랜치를 생성합니다. Claude Code worktree가 메모리를 공유하는지에 대한 가이드에서 worktree 세션이 로드하는 항목을 자세히 다룹니다.

Claude가 worktree를 건너뛰는 경우

문서에는 세션이 제자리에서 편집을 수행하는 경우를 나열하고 있습니다. 여기에는 열려 있는 터미널에서 백그라운드로 이동시킨 세션, 이미 연결된 worktree 내에 있는 세션, git 저장소가 아니며 worktree 훅이 없는 디렉토리 등이 포함됩니다. 또한 worktree.bgIsolation을 "none"으로 설정하여 저장소의 격리 기능을 끌 수도 있습니다.

작업 저장 방식

백그라운드 세션이 자체 worktree에서 코드를 변경한 경우, Claude Code는 작업을 마치기 전에 보존하도록 Claude에게 지시합니다. 원격 저장소가 있으면 브랜치를 커밋하고 푸시하며, 작업에 필요한 경우 드래프트 풀 리퀘스트(PR)를 생성합니다. 이러한 지침은 main 또는 master로의 직접 푸시, 강제 푸시(force-push), 머지를 금지합니다. 그리고 "만약 작업 내용, CLAUDE.md, 또는 메모리에 사용자가 직접 커밋이나 푸시를 처리한다고 명시되어 있다면, Claude는 git 작업을 사용자에게 맡깁니다."

각 세션은 수행한 작업과 작업 위치에 대한 보고와 함께 종료됩니다.

Agent view에서 세션을 삭제하면 목록에서 사라지지만, "대화 기록(transcript)은 claude --resume을 통해 머신에 남아 있습니다." 하지만 Claude가 생성한 worktree는 다릅니다. Agent view는 이를 제거하며, "커밋되지 않은 변경 사항을 포함하므로 유지하고 싶은 내용은 먼저 커밋하십시오." Claude Code는 worktree에 다른 곳에 저장되었는지 확인할 수 없는 커밋이 있는 경우 삭제를 거부하고 진행 방법을 안내합니다.

삭제된 세션은 Agent view에서 /resume을 사용하여 백그라운드 행으로 다시 가져올 수 있으며, 여기에는 삭제한 세션을 포함하여 저장소의 과거 세션들이 나열됩니다. Claude Code 세션 기록 찾기 및 삭제 가이드에서 대화 기록 자체에 대해 다룹니다.

각 행이 서로의 내용을 알고 있을 것이라 기대함. 각 행은 독립된 대화입니다. 디스크의 파일은 공유하지만, 대화 내용은 공유하지 않습니다.

한 세션에 결정을 내리고 다른 세션들이 이를 따를 것이라 생각함. 결정 사항은 CLAUDE.md, 규칙, 또는 메모리에 기록되지 않는 한 해당 대화에만 머뭅니다.

CLAUDE.md를 수정하고 즉시 세션을 할당함. 기본 브랜치 기반의 worktree는 수정 사항이 아닌 커밋된 버전을 가져옵니다.

커밋하기 전에 행을 삭제함. Agent view는 생성된 worktree를 제거하며, 커밋되지 않은 변경 사항도 함께 사라집니다.

컴퓨터가 꺼져도 세션이 계속 실행될 것이라 가정함. 문서는 이를 제한 사항으로 나열합니다. 세션은 로컬에서 실행되며 머신이 종료되면 중지됩니다. 절전 모드(sleep) 중에는 유지됩니다.

1단계: 모든 세션이 읽는 위치에 필요한 컨텍스트 기록하기

모든 병렬 작업에 적용되는 관례와 제약 사항은 프로젝트 루트의 CLAUDE.md 또는 .claude/rules/의 범위 미지정 규칙에 작성하십시오. 각 행에 반복해서 말해야 할 결정 사항도 그곳에 두십시오. Claude가 기억하길 원한다면, 저장소의 모든 세션이 공유하는 자동 메모리에 해당 내용을 저장하도록 요청하십시오.

2단계: 세션을 할당하기 전에 지침 변경 사항 커밋하기

worktree는 기본적으로 기본 브랜치에서 시작하므로, CLAUDE.md와 규칙의 변경 사항을 커밋하고 푸시한 후에 해당 내용에 의존하는 세션을 할당하십시오. 세션에 진행 중인 브랜치가 필요한 경우 worktree.baseRef를 "head"로 설정하고, 작업에 필요한 로컬 파일을 위해 .worktreeinclude를 추가하십시오.

3단계: 각 세션에 학습한 내용 보고 요청하기

프롬프트에 세션이 남겨야 할 내용을 포함하십시오: 브랜치 이름, 발견한 내용의 요약, 그리고 다른 세션에 필요한 결정 사항 등입니다. 행이 완료되면 보고서를 읽고, 다른 세션이 알아야 할 내용을 CLAUDE.md나 메모리로 옮기십시오. 행을 삭제하기 전에 커밋하십시오.

예약된 작업을 실행하는 경우, Claude Code routine이 실행 간에 정보를 전달하는지에 대한 가이드에서 자동으로 시작되는 실행에 대한 동일한 질문을 다룹니다.

Agent view를 사용하면 많은 세션을 쉽게 실행할 수 있으며, 각 세션은 다른 세션이 알면 좋을 내용을 학습합니다. 저장소 내부에서는 CLAUDE.md, 규칙, 자동 메모리가 머신에서 이를 전달합니다. 동일한 결정 사항이 다른 컴퓨터나 다른 도구에서도 중요할 때, 특정 체크아웃에 묶이지 않은 보관 장소가 필요합니다.

MemoryLake는 이러한 종류의 컨텍스트를 사용자가 관리하는 하나의 목록에 유지하고, Claude Code뿐만 아니라 Codex, ChatGPT 등 연결된 다른 어시스턴트에서도 사용할 수 있게 해주는 메모리 레이어입니다.

사용자는 자신의 언어로 직접 항목을 작성합니다. 백그라운드 세션, worktree, CLAUDE.md 파일, 자동 메모리 또는 어떤 벤더의 저장소에서도 내용을 읽거나 쓰거나 삭제하지 않습니다. Agent view는 Anthropic이 설명한 방식 그대로 계속 작동합니다.

1단계: API 키 생성

로그인 후 대시보드에서 키를 생성합니다. 이 키는 MemoryLake 워크스페이스에 속하며 Claude 계정과는 별개입니다.

2단계: 첫 번째 메모리 업로드

해결책의 3단계에서 세션 보고서로부터 추출한 내용으로 시작하십시오: 둘 이상의 세션에 필요했던 결정 사항, 제약 조건, 발견 사항 등입니다. 항목당 하나의 포인트를 작성하고 날짜와 저장소 라벨을 지정합니다.

3단계: AI 및 에이전트 연결

Claude Code와 사용하는 다른 어시스턴트를 연결합니다. 모든 세션은 실행 위치에 관계없이 동일한 결정 사항에서 시작할 수 있습니다.

첫 번째 차이점은 병렬 세션이 더 이상 당신을 놀라게 하지 않는다는 것입니다. 세션들이 대화가 아닌 디스크의 파일과 메모리를 공유한다는 점을 알게 됩니다.

두 번째는 수정 사항이 충돌하지 않는다는 것입니다. 할당된 각 세션은 설정을 변경하지 않는 한 기본 브랜치에서 시작하여 자체 worktree에 기록합니다.

세 번째는 유용한 정보가 행과 함께 사라지지 않는다는 것입니다. 작업은 커밋되고, 발견 사항은 기록되며, 대화 기록은 재개할 수 있도록 남아 있습니다. 컴퓨터를 바꾸는 경우, 다른 머신에서의 Claude Code 가이드에서 자동 메모리가 전달하지 못하는 내용을 확인할 수 있습니다.

각 행을 독립된 대화로 취급하십시오. 프롬프트와 디스크에 필요한 정보를 제공하십시오.

공유 규칙은 CLAUDE.md나 범위 미지정 규칙에 보관하십시오. 모든 세션이 이를 읽습니다.

할당하기 전에 지침 변경 사항을 커밋하십시오. worktree는 기본적으로 커밋된 버전에서 시작합니다.

로컬 파일에는 .worktreeinclude를 사용하십시오. Gitignored 파일은 새로운 worktree에 포함되지 않습니다.

보고서를 요청하십시오. 브랜치, 결과, 그리고 다른 세션이 알아야 할 내용을 포함하게 하십시오.

행을 삭제하기 전에 커밋하십시오. Agent view는 Claude가 생성한 worktree를 제거합니다.

세션은 로컬임을 기억하십시오. 머신이 종료되면 중지됩니다.

Agent view는 여러 백그라운드 Claude Code 세션을 위한 하나의 화면입니다. 각 행은 작업 디렉토리의 CLAUDE.md, 규칙, 공유 자동 메모리와 함께 시작하여 파일을 수정하기 전에 자체 worktree로 이동하는 완전하고 별개인 대화입니다. 세션은 대화 내용이 아닌 디스크의 내용을 공유하며, 포크된 세션은 생성된 시점부터 독립적입니다.

모든 세션에 필요한 컨텍스트는 CLAUDE.md, 규칙 또는 메모리에 넣고, 할당 전에 커밋하며, 각 세션에 학습 내용 보고를 요청하고, 행을 삭제하기 전에 커밋하십시오.