Claude Code 2.1.290: AI가 AI를 감시한다 — You Should Know 모드와 Managed Agents 온보딩

코딩 중에 가장 위험한 순간은 집중력이 높을 때다. 한 파일을 파고들다 보면 다른 파일에 미치는 영향을 놓치고, 해결책이 좋아 보일수록 처음 목표에서 벗어났는지 알아채기 어렵다. Claude Code 2.1.290은 이 문제를 정면으로 다룬다.

1. "You Should Know" — 옆에서 전체 그림을 보는 감시자

You Should Know는 단순한 플러그인이 아니라 사이드 에이전트다. 사용자가 Claude와 함께 작업하는 동안 별도의 처리를 통해 중요한 정보를 실시간으로 알려준다.

잡아내는 것들:

• 코드 변경으로 인해 의도치 않게 영향을 받을 수 있는 다른 파일
• 작업 방향이 초기 목표에서 벗어나고 있을 때
• 사용자가 지정한 설정이나 패턴에 위배되는 선택

활성화는 한 줄이면 된다:

/plugin enable cc-plugin-you-should-know@builtin

비유하자면, Claude가 코드 작성에 집중하고 있을 때 팀의 다른 개발자가 옆에서 전체 구조를 바라보는 것과 같다. 혼자 개발하는 환경에서도 "검토자의 시선"을 가질 수 있게 된다.

2. Managed Agents 온보딩: 복잡한 에이전트 구조를 명령어 한 줄로

복수의 AI 에이전트가 협업하는 Managed Agents 패턴을 프로젝트에 처음 도입하는 과정은 까다로웠다. 문서를 찾아보고, 설정 파일을 수동으로 작성하고, 구조를 직접 이해해야 했다. 2.1.290은 이 과정을 간단하게 만들었다:

/claude-api managed-agents-onboard <url>
/claude-api managed-agents-onboard <quickstart-name>

예를 들어 deep-researcher 템플릿을 지정하면 연구형 에이전트 구조가 즉시 생성된다. 처음부터 설계하는 것이 아니라 검증된 패턴에서 출발하는 방식이다.

3. VSCode Agent Map: 에이전트 전체를 한 화면에

VS Code에서 Claude Code를 쓴다면 하단에 **"N agents" 필(pill)**이 새로 생긴 것을 확인할 수 있다. 클릭하면 현재 세션에서 실행 중인 모든 서브에이전트를 보여주는 Agent Map이 열린다.

• 각 에이전트의 현재 상태를 개별 카드로 확인
• 특정 에이전트 중지(Stop agent)
• 읽기 전용 대화 내역 확인

복잡한 멀티 에이전트 작업에서 "지금 무슨 에이전트가 어디서 무엇을 하고 있는지" 파악하기 위해 로그를 뒤지던 과정이 사라진다.

4. 세션 관리 명령어

claude attach <name>과 claude logs <name> 명령어가 추가됐다. 세션 ID 전체를 기억하지 않아도 이름의 일부만 입력하면 해당 세션에 접속하거나 로그를 열 수 있다.

활용 팁

You Should Know + 리팩터링: 여러 파일에 걸친 리팩터링 작업을 할 때 이 모드를 켜두면 연계된 파일에서 발생하는 사이드 이펙트를 먼저 알 수 있다. 테스트 파일과 설정 파일이 얽힌 구조에서 특히 효과적이다.

Managed Agents 시작점: deep-researcher 템플릿은 리서치 자동화를 구현하는 출발점으로 좋다. 완성된 시스템을 처음부터 설계하기보다 이 템플릿의 구조를 분석하면서 자신의 프로젝트에 맞게 조정하는 접근이 빠르다.

Sources:

• Claude Code Changelog - Releasebot
• Claude Code Docs Changelog
• Claude Managed Agents Explained 2026