AI 코딩 도구를 처음 도입한 팀이 가장 먼저 부딪히는 문제는 기능이 아니다. 일관성이다. Claude Code가 오늘은 컨벤션을 따르다가 내일은 무시하고, 긴 세션이 이어지면 초반에 설정한 규칙을 흐지부지 잊어버린다. 이 문제를 구조로 푸는 것이 CLAUDE.md다. 그리고 같은 날, Anthropic은 전혀 다른 방향에서 AI를 팀 워크플로우 안으로 밀어 넣었다—Adobe, Blender, Ableton과 직접 연결되는 MCP 커넥터를 공개하면서.
코드베이스 기억을 설계한다는 것
dev.to에 소개된 CLAUDE.md 베스트 프랙티스는 단순한 설정 가이드가 아니다. 이것은 AI에게 건네는 팀의 컨텍스트 설계다. 핵심 통찰은 하나다—Claude Code는 모든 것을 알 필요가 없다. 적시에 적절한 것을 알면 된다.
가장 눈에 띄는 구분은 CLAUDE.md와 훅(hook)의 역할 분리다. "항상 prettier를 실행하라"고 CLAUDE.md에 적어두면, 긴 세션 중반쯤에 조용히 무시된다. 반면 .claude/settings.json의 PostToolUse 훅으로 걸어두면 예외 없이 실행된다. 메모리는 확률적이고, 훅은 결정론적이다. 이 차이를 이해하는 팀과 그렇지 않은 팀의 AI 협업 품질은 시간이 갈수록 벌어진다.
루트 CLAUDE.md는 200줄 이하로 유지하되, 상세 맥락은 ADR(Architecture Decision Records)로 분리해 필요할 때만 참조하게 만드는 '점진적 공개(Progressive Disclosure)' 패턴도 인상적이다. "gRPC를 쓴다"는 사실만 적으면 Claude는 REST로 돌아가자고 제안할 수 있다. 하지만 ADR에 p99 레이턴시 초과라는 맥락과 결정 이유를 남겨두면, Claude는 그 결정을 존중하고 그 안에서 작동한다. AI가 왜(WHY)를 알 때 협업의 밀도가 달라진다.
반복 워크플로우를 '스킬'로 캡슐화하는 것도 실용적이다. 릴리즈 프로세스를 매 세션마다 재설명하는 대신, /release 스킬로 한 번 정의해두면 된다. 10줄짜리 선언형 스킬이 50줄짜리 설명형 스킬보다 낫다—무엇을 할지만 말하고, 어떻게는 Claude에게 맡기는 것이다.
MCP 커넥터—도구 안으로 들어가는 AI
같은 맥락에서 Anthropic이 4월 28일 공개한 Claude 커넥터는 또 다른 방향의 실험이다. CLAUDE.md가 코드베이스가 AI를 이해하도록 구조화한다면, MCP 커넥터는 AI가 창작 도구 안에서 직접 작동하도록 연결한다.
Adobe Creative Cloud와의 연동이 가장 구체적이다. 포토샵, 일러스트레이터, 파이어플라이, 프리미어, 라이트룸을 포함해 50개 이상의 도구를 Claude 대화창 하나에서 자연어로 실행할 수 있다. '조명 보정, 배경 블러, 세로형 크롭'을 요청하면 Claude가 라이트룸과 포토샵 도구를 순서대로 불러와 처리한다. 앱을 전환하지 않아도 된다. AI 매터스 보도에 따르면 어도비 계정 없이도 기본 도구 40여 개를 무료로 쓸 수 있어 진입 장벽도 낮다.
Blender에서는 자연어로 3D 장면을 분석하거나 스크립트를 생성할 수 있고, Autodesk Fusion에서는 대화만으로 3D 모델을 수정할 수 있다. 음악 분야에서는 Ableton이 공식 문서 기반으로 정확한 작업 가이드를 제공하고, Splice는 로열티 프리 샘플을 Claude 내에서 직접 검색할 수 있게 한다. AI 타임스 보도 기준으로 총 9개 커넥터가 동시에 공개됐다.
이 커넥터들은 모두 MCP(Model Context Protocol)라는 개방형 표준 위에서 작동한다. Blender 커넥터는 오픈소스로 공개돼 다른 AI 모델에서도 활용할 수 있다. Anthropic이 Blender 개발 펀드에 직접 참여한 것도 이 생태계를 단순한 파트너십이 아닌 장기 인프라 투자로 보고 있다는 신호다.
두 흐름이 교차하는 지점
표면적으로 CLAUDE.md 패턴과 MCP 커넥터는 다른 이야기처럼 보인다. 하나는 코드베이스 운영의 문제고, 다른 하나는 창작 도구 연동의 이야기다. 하지만 둘이 가리키는 방향은 같다—AI가 임시 조수가 아니라 워크플로우의 구조적 일부가 되는 방식.
CLAUDE.md를 잘 설계한 팀은 AI가 컨텍스트를 잃지 않고 장기 프로젝트를 함께 이어나갈 수 있다. MCP 커넥터가 연결된 창작자는 도구 경계를 넘나드는 반복 작업을 AI에게 위임하고, 판단과 창의에 집중할 수 있다. 전자는 개발팀의 암묵지를 코드화하는 방식이고, 후자는 크리에이티브 워크플로우의 마찰을 제거하는 방식이다.
지금 팀이 물어야 할 질문
Anthropics이 "AI는 창작자의 취향이나 상상력을 대체할 수 없지만, 반복 업무와 기술적 허들을 제거해 더 대담한 아이디어를 실현하도록 돕는 것이 목표"라고 밝힌 문장은, 개발팀에도 그대로 적용된다. AI가 컨벤션을 대신 지키고, 포맷을 자동으로 맞추고, 릴리즈 프로세스를 처음부터 설명 듣지 않아도 되는 구조가 갖춰질 때—개발자는 설계와 판단에 집중할 수 있다.
결국 지금 팀이 물어야 할 질문은 'AI 도구를 쓰고 있는가'가 아니다. 'AI가 우리 팀의 규칙을 알고 있는가'—그리고 'AI가 우리 도구 안에서 실제로 작동하고 있는가'다. CLAUDE.md 패턴과 MCP 커넥터는 이 두 질문에 대한 현재 시점의 가장 구체적인 답이다.