Claude Code 2.1.140 Agent View goal: 코딩 에이전트가 '끝날 때까지' 일하는 방식

 

Claude Code Agent View와 /goal: 코딩 에이전트가 '끝날 때까지' 일하는 방식

2.1.139의 기능 추가와 2.1.140의 안정화 수정까지 한 번에 보는 실무 도입 메모

 

Claude Code 2.1.140 Agent View goal 요약

 

Claude Code 2.1.140 Agent View goal 업데이트는 새 모델 발표가 아니라 Claude Code CLI의 에이전트형 작업 흐름을 다듬은 업데이트입니다. 2.1.139에서 Agent View와 /goal이 들어왔고, 2.1.140은 /goal hang처럼 보이던 상황과 background 실행 문제를 보완했습니다.

Claude Code 2.1.140 Agent View goal을 한 문장으로 줄이면, 코딩 에이전트를 한 번 부르고 끝내는 방식에서 여러 세션을 보고, 완료 조건을 걸고, 필요한 곳에 다시 붙는 방식으로 이동했다는 뜻입니다.

Agent View는 `claude agents`로 여는 세션 보드에 가깝습니다. 실행 중인 작업, 사용자 입력을 기다리는 작업, 완료된 작업을 한 화면에서 보고 필요한 세션에 attach합니다. `/goal`은 한 번의 프롬프트가 아니라 세션에 완료 조건을 걸어 조건이 만족될 때까지 여러 turn을 이어가게 하는 명령입니다.

한국 사용자 입장에서는 이 업데이트가 화려한 데모보다 실무 습관에 더 가깝습니다. 여러 이슈를 동시에 조사하거나, 테스트가 통과될 때까지 고치게 하거나, PR 리뷰와 flaky test 조사를 나눠 맡길 때 의미가 생깁니다. 다만 Agent View는 Research Preview이고 `/goal`은 hooks와 trusted workspace 조건을 탑니다. 처음부터 핵심 배포 경로에 넣기보다 작은 저장소에서 먼저 손에 익히는 편이 현실적입니다.

 

 

업데이트 타임라인: 2.1.139 추가, 2.1.140 안정화

 

2026년 5월 11일의 2.1.139는 기능 추가에 가깝고, 2026년 5월 12일의 2.1.140은 그 기능을 실제로 돌릴 때 만날 수 있는 안정성 문제를 줄인 업데이트입니다.

이 흐름은 날짜를 나눠 봐야 이해가 쉽습니다.

날짜	버전	성격	확인할 내용
2026-05-11	2.1.139	기능 추가	Agent View Research Preview, `/goal` 명령
2026-05-12	2.1.140	안정화	`/goal` 관련 hang 안내, background service, `/loop`, Windows 이벤트 루프 수정

제가 보기에는 2.1.140만 떼어 볼 업데이트가 아닙니다. Agent View와 `/goal`은 모두 오래 실행되는 코딩 에이전트 흐름과 연결됩니다. 그래서 바로 다음 날 나온 2.1.140의 수정 항목도 단순 버그 패치라기보다, 에이전트가 오래 돌 때 필요한 기초 안정성 보강으로 읽는 편이 자연스럽습니다.

주의할 점도 있습니다. 이 글의 Claude Code 2.1.140 Agent View goal은 Claude의 foundation model이 새로 나온 이야기와 다릅니다. 모델 성능 벤치마크가 아니라 Claude Code라는 개발 도구의 실행 방식, 세션 관리, 자동 반복 조건에 관한 업데이트입니다.

 

Agent View란 무엇이고 어떤 세션을 보여주나

 

Agent View는 `claude agents`로 여는 Research Preview 화면이며, 여러 Claude Code background session을 실행 중·입력 대기·완료 상태로 관리하게 해줍니다.

Agent View를 가장 단순하게 설명하면 `tmux`나 작업 큐처럼 여러 Claude Code 세션을 한 화면에서 보는 방식입니다. 새 프롬프트를 입력하면 기존 대화의 후속 질문이 아니라 별도의 background session이 시작됩니다. 필요한 세션은 peek로 들여다보고, attach로 들어가 답변하거나 이어서 지시합니다.

실제로 확인할 부분은 worktree 동작입니다. 공식 문서에 따르면 git repository 안에서 Agent View로 시작한 background session이 파일을 수정하기 전 `.claude/worktrees/` 아래 isolated git worktree로 이동할 수 있습니다. 이 설계는 병렬 세션 간 충돌을 줄이는 데 유용합니다. 반대로 git repository 밖에서 작업하거나 외부 경로를 건드리는 작업은 같은 working directory를 직접 수정할 수 있으므로 조심해야 합니다.

또 하나는 로컬 실행의 한계입니다. background session은 supervisor process가 관리하지만, 로컬 머신이 sleep 또는 shutdown되면 실행 중 세션은 멈춥니다. 장시간 작업을 맡긴다면 `claude respawn --all`, `claude logs <id>`, `claude attach <id>` 같은 복구·확인 흐름까지 같이 익혀야 합니다.

 

 

/goal 명령은 일반 프롬프트와 무엇이 다른가

 

`/goal`은 한 번 답을 받는 프롬프트가 아니라 세션 단위 완료 조건입니다. 조건이 충족되지 않았다고 평가되면 Claude가 다음 turn을 이어가고, 충족되면 goal이 자동으로 정리됩니다.

`/goal`의 핵심은 질문을 길게 쓰는 데 있지 않습니다. 무엇을 끝으로 볼지를 세션에 걸어두는 데 있습니다. 예를 들면 `npm test exits 0 and git status is clean, stop after 3 turns`처럼 테스트 결과, 저장소 상태, 반복 제한을 같이 넣는 방식이 더 안전합니다.

다만 여기서 조심할 점은 evaluator의 범위입니다. 공식 문서 설명상 `/goal`의 조건 평가는 각 turn 뒤에 빠른 작은 모델이 대화에 드러난 정보를 보고 판단합니다. evaluator가 독립적으로 파일을 열거나 명령을 실행하는 구조가 아니므로, Claude가 `npm test` 결과나 build exit code를 transcript에 남기도록 지시해야 합니다.

`/goal`은 `/loop`, Stop hooks, Auto mode와도 역할이 다릅니다. `/loop`는 반복 실행 흐름에 가깝고, Stop hooks는 설정 범위에서 더 구조적인 종료 판단을 붙이는 쪽입니다. Auto mode는 주로 한 turn 안의 tool approval 부담과 연결됩니다. 반면 Claude Code 2.1.140 Agent View goal에서의 `/goal`은 세션이 여러 turn을 지나도 완료 조건을 계속 추적하게 만드는 장치에 가깝습니다.

 

도입 시뮬레이션: 설치 확인부터 첫 테스트까지

 

첫 테스트는 `claude --version`으로 버전을 확인한 뒤 `claude agents`에서 작은 background session을 만들고, 별도 세션에서 `/goal`을 측정 가능한 조건으로 짧게 걸어보는 순서가 안전합니다.

처음부터 큰 migration을 맡기면 실패 원인이 기능인지, 프롬프트인지, 저장소 상태인지 구분하기 어렵습니다. 저는 다음처럼 작게 시작하는 편이 낫다고 봅니다.

1. `claude --version`으로 Claude Code가 2.1.139 이상인지 확인합니다.
2. git repository 루트에서 `claude agents`를 실행합니다.
3. 입력창에 `find one small documentation typo and propose the patch`처럼 작은 읽기·수정 작업을 넣습니다.
4. Space로 peek, Enter 또는 오른쪽 화살표로 attach, 왼쪽 화살표로 detach 흐름을 확인합니다.
5. 다른 터미널에서는 `claude --bg "investigate one failing test and report the command output"`로 session id를 받고 `claude logs <id>`, `claude attach <id>`, `claude stop <id>`를 확인합니다.
6. trusted workspace에서 `/goal npm test exits 0 and git status is clean, stop after 3 turns`처럼 종료 조건과 반복 제한을 함께 둡니다.

이 테스트의 목적은 기능을 많이 쓰는 데 있지 않습니다. Agent View가 세션을 제대로 분리하는지, `/goal`이 멈춰야 할 조건을 이해하는지, 테스트 결과가 대화에 남는지, quota가 예상보다 빠르게 소모되지 않는지를 보는 과정입니다.

 

 

 

운영 모델: 어떤 작업을 Agent View와 /goal에 맡길까

 

Agent View는 여러 독립 작업을 상태 보드처럼 보는 데 강하고, `/goal`은 테스트 통과나 파일 정리처럼 완료 조건을 검증할 수 있는 한 세션 작업에 적합합니다.

잘 맞는 작업은 서로 독립적인 단위입니다. 예를 들면 PR review 초안, flaky test 원인 조사, dependency migration의 영향 범위 확인, lint/test cleanup, 문서 changelog 정리처럼 결과 확인 방법이 있는 작업입니다. 한 세션은 테스트 실패 원인을 찾고, 다른 세션은 문서 누락을 찾고, 또 다른 세션은 작은 refactor 후보를 정리하는 식입니다.

운영 중에는 세 가지를 기록해야 합니다. 첫째, 각 background session이 어떤 branch 또는 `.claude/worktrees/` 경로에서 움직이는지입니다. 둘째, `/goal` 조건에 어떤 검증 명령이 들어갔는지입니다. 셋째, `claude logs <id>`나 attach 화면에 실제 command output이 남았는지입니다.

> 완료했다는 말보다, 무엇을 근거로 완료라고 봤는지가 더 중요합니다.

Claude Code 2.1.140 Agent View goal 흐름은 사람을 빼는 자동화라기보다, 사람이 확인할 단위를 더 잘 나누는 도구에 가깝습니다. 실제 팀에서는 "에이전트가 완료했다고 말한 것"보다 "어떤 테스트와 git 상태를 근거로 완료라고 판단했는지"를 리뷰 기준으로 삼아야 합니다.

 

도입을 미뤄야 하는 조건

 

hooks를 금지한 조직, Research Preview를 production-critical workflow에 넣기 어려운 팀, 로컬 sleep/shutdown이 잦은 환경, 완료 조건을 측정 가능하게 쓰기 어려운 작업은 보류하는 편이 낫습니다.

가장 먼저 볼 것은 hooks와 workspace trust입니다. `/goal`은 hooks system을 사용하므로 trusted workspace가 필요하고, `disableAllHooks` 또는 managed settings의 `allowManagedHooksOnly`가 걸린 환경에서는 쓸 수 없습니다. 2.1.140은 이런 상황에서 조용히 멈춘 것처럼 보이던 문제를 명확한 메시지로 처리하도록 고친 업데이트입니다.

두 번째는 비용과 quota입니다. Agent View row summary와 `/goal` 평가에는 추가 모델 요청이 들어갑니다. 병렬 session을 많이 띄우면 subscription quota도 그만큼 빨리 줄어듭니다. 이 부분은 기능이 나쁘다는 뜻이 아니라, 운영 규칙 없이 켜두면 예산과 사용량을 예측하기 어렵다는 뜻입니다.

마지막은 완료 조건의 품질입니다. "코드를 더 좋게 만들어줘" 같은 열린 조건은 반복 비용을 키웁니다. "`npm test`가 0으로 끝나고 `git status`가 clean이며, 3 turn 안에 안 되면 원인만 보고"처럼 관찰 가능한 기준과 stop 조건을 같이 쓰는 습관이 필요합니다.

 

 

 

왜 중요한가: 코딩 에이전트가 끝날 때까지 일하는 방식

 

이번 업데이트의 의미는 Claude Code가 단일 대화형 도구에서 병렬 세션을 관찰하고 완료 조건을 추적하는 에이전트 운영 도구 쪽으로 움직인다는 점입니다.

개인적으로 흥미로운 지점은 "AI가 코드를 더 잘 짠다"가 아닙니다. 이번에는 더 실무적인 질문, 즉 오래 도는 AI 작업을 어떻게 관찰하고 멈출 것인가에 답을 붙이고 있습니다.

Agent View는 여러 작업을 펼쳐놓고 상태를 보는 쪽이고, `/goal`은 한 작업이 끝났는지 판단하는 기준을 세션에 붙이는 쪽입니다. 둘을 같이 쓰면 코딩 에이전트가 막연히 오래 도는 문제가 조금 더 관리 가능한 형태가 됩니다.

그렇다고 과장할 필요는 없습니다. Claude Code 2.1.140 Agent View goal은 모든 일을 승인 없이 끝내는 기능이 아닙니다. 권한 승인, hooks 설정, quota, 로컬 머신 상태, git 충돌 가능성은 여전히 사람이 설계해야 합니다. 다만 작은 유지보수 작업을 여러 개 굴리는 사람에게는 꽤 직접적인 생산성 변화로 이어질 여지가 있습니다.

 

자주 묻는 질문

 

Q. Claude Code Agent View는 어떤 세션을 보여주나?
A. `claude agents`로 시작한 Claude Code background session을 실행 중, 사용자 입력 대기, 완료 상태로 보여줍니다. 새 프롬프트를 입력하면 기존 대화 후속 메시지가 아니라 별도 background session이 시작됩니다.

Q. Claude Code 2.1.140 Agent View goal 업데이트에서 실제로 새로 써볼 명령어는 무엇인가?
A. 먼저 `claude --version`으로 버전을 확인하고, `claude agents`로 Agent View를 열어 작은 작업을 dispatch해보는 것이 좋습니다. 별도 확인으로 `claude --bg`, `claude logs <id>`, `claude attach <id>`, `/goal npm test exits 0 and git status is clean, stop after 3 turns`를 차례로 테스트하면 됩니다.

Q. /goal 명령은 일반 프롬프트와 어떻게 다른가?
A. 일반 프롬프트는 한 번의 응답을 요청하지만 `/goal`은 세션에 완료 조건을 붙입니다. 조건이 충족되지 않았다고 평가되면 Claude가 다음 turn을 이어가며, 충족되면 goal이 자동으로 cleared 상태가 됩니다.

Q. Claude Code 2.1.140에서 고쳐진 중요한 버그는 무엇인가?
A. `/goal`이 `disableAllHooks` 또는 managed settings의 `allowManagedHooksOnly` 설정에서 조용히 멈춘 것처럼 보이던 상황을 명확한 메시지로 처리한 점이 중요합니다. 그 밖에 background service idle-exit 근처의 `claude --bg` 실패, 기업 보안 환경의 background service 시작 지연, `/loop` 중복 wakeup, Windows 이벤트 루프 stall 수정도 포함됩니다.

Q. Agent View가 Research Preview라는 점은 실무 도입에 어떤 영향을 주나?
A. production-critical workflow의 필수 경로로 바로 넣기보다 보조 조사, PR review 초안, flaky test 조사처럼 되돌리기 쉬운 작업부터 써야 합니다. 공식 문서상 인터페이스와 단축키가 바뀔 수 있다는 점도 운영 문서에 반영해야 합니다.

Q. /goal 완료 조건은 어떻게 써야 반복 실패를 줄일 수 있나?
A. `npm test exits 0`, `git status is clean`, `no files outside src/ changed`처럼 Claude가 대화에 증거를 남길 수 있는 조건으로 써야 합니다. `stop after 3 turns` 같은 반복 제한을 함께 두면 열린 결말 때문에 token spend가 커지는 문제를 줄입니다.

Q. claude agents와 claude --bg는 어떤 차이로 쓰면 좋은가?
A. `claude agents`는 여러 background session을 화면에서 보고 attach·peek하는 관리 화면에 가깝습니다. `claude --bg`는 shell에서 특정 background session을 시작하고 session id를 받아 `claude logs <id>`나 `claude attach <id>`로 추적하는 흐름에 맞습니다.

Q. 여러 background session을 동시에 실행할 때 quota와 worktree는 무엇을 조심해야 하나?
A. 각 session과 row summary, `/goal` 평가가 추가 모델 요청을 만들 수 있어 subscription quota를 더 빨리 씁니다. git repository 안에서는 `.claude/worktrees/` 격리가 도움을 주지만, git repository 밖이거나 외부 경로를 수정하는 작업은 같은 working directory를 건드릴 수 있습니다.

함께 읽으면 좋은 글

 

• Bing Copilot Answer API 등장: AI 검색 결과를 JSON으로 분석하는 방법 — AI UPDATES
• DALL-E 2·3 API 종료일 도래: GPT Image로 마이그레이션 체크리스트 — AI UPDATES
• Claude 사용량 2배 확대 총정리 + Anthropic 10GW 컴퓨트 파트너십 현황 — AI UPDATES

참조 링크

 

• Changelog - Claude Code Docs — 2.1.139와 2.1.140의 날짜, 추가 기능, 수정 사항을 확인한 원문 업데이트 출처입니다.
• Manage multiple agents with agent view - Claude Code Docs — Agent View의 Research Preview 상태, `claude agents`, background session, worktree isolation, quota와 로컬 실행 제한을 확인한 공식 문서입니다.
• Keep Claude working toward a goal - Claude Code Docs — `/goal`의 완료 조건, evaluator 방식, hooks 요구사항, 상태 확인과 clear 동작을 확인한 공식 문서입니다.
• Agent view in Claude Code — Agent View의 제품 의도와 Research Preview 맥락을 확인한 Anthropic 공식 블로그입니다.
• claude-code CHANGELOG.md — Claude Code 변경 내역을 GitHub에서 교차 확인하기 위한 보조 1차 출처입니다.