Claude Code와 AI 비서, 왜 내 명령을 거부할까? 사실과 오해 바로잡기

최근 개발자들 사이에서 흥미로운 루머가 하나 돌고 있습니다. “AI 개발 도구인 Claude Code가 특정 모델(Opus 5)에게 ‘Subagent(하위 에이전트)’ 기능을 사용하지 말라고 하드코딩된 명령을 내려두었다”는 이야기입니다.

AI가 코딩을 할 때 복잡한 작업을 자신의 분신인 Subagent에게 나눠 맡기지 못한다면, 그 효율성은 크게 떨어질 수밖에 없습니다. 개발자분들이 우려하는 것도 당연합니다. 하지만 과연 이 소문은 사실일까요? 결론부터 말씀드리면, 현재까지 확인된 기술 정보들을 종합할 때 이러한 하드코딩 제한은 사실이 아닙니다.

이게 왜 중요한가요?

일상적인 코딩 작업에서 AI는 단순한 ‘자동 완성’ 도구를 넘어, 전체 프로젝트를 파악하고 스스로 판단하는 ‘에이전트’로 진화했습니다. 이때 가장 중요한 기술이 바로 Subagent입니다.

쉽게 말해, AI가 전체 코드를 수정해야 할 때 ‘파일 탐색’이나 ‘코드 리뷰’처럼 전문적인 작업은 별도의 전담 에이전트에게 일을 맡기는 방식입니다. 만약 이 기능이 막혀 있다면, 개발자는 AI가 스스로 해결할 일을 일일이 수동으로 입력해야 하는 번거로움을 겪게 됩니다. 다행히도 우리는 이 기술을 마음껏 활용할 수 있습니다.

쉽게 이해하기: ‘총괄 매니저’와 ‘보조 요원’

Subagent를 더 쉽게 이해하기 위해 비유를 하나 들어볼게요. 여러분이 대규모 프로젝트를 이끄는 ‘총괄 매니저(Claude Opus 5)’라고 상상해보세요.

매니저인 여러분이 수천 개의 문서 파일을 하나하나 직접 열어보는 것보다, ‘문서 담당 대리(Explorer)’나 ‘검수 담당 팀장(Reviewer)’에게 업무를 위임하는 것이 훨씬 빠르고 정확하겠죠?

Claude Code 시스템도 이와 같습니다. 시스템은 스스로 “이 작업은 리리뷰 팀장에게 맡기는 게 좋겠다”라고 판단하도록 설계되어 있습니다(Claude Code Docs). 이 과정이 하드코딩으로 강제로 막혀 있는 것이 아닙니다. 오히려 Anthropic의 공식 가이드를 보면, 사용자가 프롬프트에 “이런 작업은 이렇게 위임해”라고 명시적으로 작성하여 Subagent를 더 효과적으로 제어할 수 있는 방법까지 제시하고 있습니다(Claude Platform Docs).

현재 상황: 제한이 아니라 최적화의 문제

Claude Code는 터미널 기반의 강력한 에이전트 도구로, 개발자가 코드를 빠르게 구현하도록 돕습니다(Anthropic 공식 소개). Opus 5 모델을 사용할 때, 사용자는 .claude/agents/ 디렉토리에 있는 설정 파일을 통해 에이전트가 어떻게 움직일지 직접 관리할 수 있습니다(Claude Code Subagents Guide).

혹시 “내 AI는 Subagent를 잘 안 쓰는데?”라고 느끼셨다면, 이는 하드코딩된 제한 때문이 아니라 이전 모델(Opus 4.8)에 맞춰진 오래된 설정들이 최신 모델의 판단을 방해하고 있을 가능성이 큽니다(Claude Opus 5 Context Engineering). 전문가들은 구버전 프롬프트를 삭제하고 시스템 설정을 최신 상태로 새로 다듬을 것을 권장합니다.

앞으로 어떻게 될까?

Claude Code와 Subagent 생태계는 매우 빠르게 확장되고 있습니다. 전 세계 개발자들은 이미 자신들만의 유용한 ‘기술(Skills)’을 공유하고 있으며, 이를 통해 특정 작업에 최적화된 에이전트 조합을 쉽게 구성할 수 있습니다(ClaudeSkills Marketplace).

앞으로는 AI가 더 똑똑하게 업무를 자동 위임하고, 사용자는 자신의 코딩 스타일에 딱 맞는 맞춤형 에이전트를 더 간편하게 세팅할 수 있게 될 것입니다. 루머에 너무 흔들리기보다는, 공식 문서를 차근차근 확인하며 자신의 프로젝트에 맞는 에이전트 전략을 세워보시는 건 어떨까요?

MindTickleBytes의 AI 기자 시선

AI가 스스로 업무를 분담하는 ‘에이전트 시대’가 열리면서, 모델의 내부 로직에 대한 오해가 루머로 번지는 경우가 잦아지고 있습니다. 중요한 것은 ‘AI가 무엇을 할 수 없는가’를 추측하는 것보다, ‘설정을 통해 능력을 어떻게 극대화할 수 있는가’를 배우는 것입니다. 우리는 도구를 의심하기보다, 도구를 제대로 다루는 법을 익히는 단계에 와 있습니다.

참고자료

1. Create custom subagents - Claude Code Docs
2. Prompting Claude Opus 5 - Claude Platform Docs

3. [Claude Code Subagents: The Complete Guide

   ComputingForGeeks](https://computingforgeeks.com/claude-code-subagents-guide/)

4. Anthropic Deleted 80% of Claude Code’s System Prompt. Here’s …
5. Claude Code overview - Anthropic
6. Claude Skills Marketplace - Discover & Download Claude Code Skills