먼저 결론

• Microsoft Agent Framework에 Claude Code와 GitHub Copilot을 에이전트의 "부하"로 호출하는 공식 커넥터가 등장했다. 7/15(미국 시간) Azure Updates를 통해 발표되었다.
• Claude Code 커넥터의 실체는 **Claude Agent SDK의 래퍼 (Wrapper)**이다. Claude Code의 permission mode, hooks, sandbox, skills까지 옵션으로 거의 그대로 다룰 수 있다.
• 발표문에는 "generally available (GA)"라고 되어 있지만, PyPI 패키지는 beta / rc 단계이며, .NET 버전의 Claude Code 커넥터는 존재하지 않고, Learn의 프로바이더 목록에도 미게재된 상태이다 (2026-07-17 기준). 도입 판단은 이러한 차이점을 고려해야 한다.

무엇이 발표되었는가

7/15 Azure Updates에는 Microsoft Agent Framework 관련 공지가 하루 만에 9건이나 한꺼번에 올라왔다. Magentic을 포함한 오케스트레이션 패턴, Agent Harness, 트레이싱 (Tracing), CodeAct와 Hyperlight 컨테이너 등 내용이 매우 방대하지만, 내가 가장 먼저 눈여겨본 것은 이것이다.

Microsoft Agent Framework now ships generally available connectors for GitHub Copilot and Claude Code, so developers can build .NET and Python agents that delegate coding tasks to either system without writing custom adapter code.

요컨대, Agent Framework로 구축한 에이전트가 코딩 태스크를 GitHub Copilot이나 Claude Code에 위임할 수 있는 공식 어댑터(Adapter)가 나왔다는 이야기다. 발표문에는 이어 "기존의 session, middleware, telemetry 설정을 변경하지 않고 추가할 수 있으며, 코딩 에이전트의 트래픽도 다른 에이전트와 동일한 트레이스(Trace)나 대시보드에 포함된다"라고 명시되어 있다.

흥미로운 점은, 이 발표에 대응하는 기사가 Agent Framework 공식 블로그에는 아직 없다는 것이다 (2026-07-17 기준. 최근 기사는 7/15의 Agent Skills for Python). Azure Updates를 통한 단발적인 조용한 발표다.

구성 방식은 다음과 같다.

Claude Code 커넥터의 내부를 읽다

패키지는 agent-framework-claude이다. 구현부를 살펴보면, ClaudeAgent 클래스가 Claude Agent SDK의 ClaudeSDKClient를 래핑하여 Agent Framework 표준인 BaseAgent 인터페이스로 변환하고 있다. 즉, 배후에서 동작하는 것은 로컬에 설치된 Claude Code CLI 그 자체이며, 샘플 코드의 전제 조건에도 "Claude Code CLI must be installed and configured"라고 명시되어 있다.

사용법은 다른 프로바이더와 다르지 않다.

from agent_framework import tool
from agent_framework.anthropic import ClaudeAgent
@tool
...

읽으면서 감탄한 부분은 옵션의 망라성이다. ClaudeAgentOptions에는 Claude Code 사용자들에게 친숙한 개념들이 거의 전부 나열되어 있다.

~/.claude에 쌓아온 설정, skills, hooks 자산을 업무용 에이전트의 워크플로우에서 그대로 사용할 수 있도록 설계되어 있다. 어제 작성한 Agent Skills의 standalone 대응과 함께 보면, Microsoft가 "Claude Code 생태계와의 상호 운용성"에 진심으로 다가오고 있음을 알 수 있다.

구현 측면에서 짚고 넘어가야 할 동작이 두 가지 있다.

1. 커스텀 도구는 in-process MCP 서버를 통해 전달된다

Claude Code CLI는 외부 도구를 MCP를 통해서만 받아들이기 때문에, 커넥터는 @tool로 전달된 Python 함수를 SDK의 MCP 도구로 변환하여 _agent_framework_tools라는 이름의 인프로세스 (in-process) MCP 서버로서 Claude 측에 보여준다. 소스 코드의 주석에 그 이유까지 적혀 있어 읽기 편하다.

2. 승인 필수 도구는 기본적으로 거부된다

approval_mode="always_require"를 설정한 도구는 승인 콜백 (on_function_approval)을 설정하지 않는 한 기본적으로 실행이 거부된다. Claude Agent SDK가 자체적인 도구 실행 루프를 가지고 있기 때문에, Agent Framework 표준의 승인 라운드트립 (round-trip)을 사용할 수 없어 대신 에이전트 레벨의 강제 지점을 둔 것이다. 콜백이 예외를 던지는 경우에도 거부 쪽으로 처리된다. secure-by-default 원칙이 철저히 적용되어 있다.

GitHub Copilot 커넥터도 같은 구조

agent-framework-github-copilot은 github-copilot-sdk (1.0.2 고정)의 래퍼 (wrapper)이며, GitHubCopilotAgent로 사용한다. 이쪽은 의존 패키지의 사정으로 Python 3.11 이상이 필요하다 (커넥터 자체의 requires-python은 3.10+이지만, SDK 의존성이 python_version >= '3.11' 조건부이다).

승인 모델은 Claude 버전과 사상은 같지만 구현은 다르다. Copilot SDK 네이티브의 on_pre_tool_use 훅이 승인 필수 도구에 "ask"를 반환하고, on_permission_request 핸들러에 위임하는 2단계 구조다. README에는 "자체적인 on_pre_tool_use를 전달할 경우 승인의 모든 책임이 사용자에게 넘어간다"는 경고와 함께, 기존 on_function_approval의 비권장 (deprecated) 사항까지 적혀 있다. 이 정도의 문서 밀도를 보니 출시를 향한 정비가 진행되고 있다는 인상을 받았다.

"generally available"의 실체를 확인하기

자, 본론으로 들어가자. 발표문의 "generally available connectors"를 글자 그대로 받아들여도 될지, 패키지 레지스트리와 공식 문서를 하나씩 확인해 보았다.

발표 내용은 ".NET과 Python의 에이전트 모두에서 위임할 수 있다"라고 읽히지만, Claude Code로의 위임을 오늘 할 수 있는 것은 Python뿐이며, 그마저도 --pre가 붙은 프리릴리스 (pre-release) 버전이다.

GitHub Copilot 측은 rc 단계까지 왔으므로 정식 출시가 머지않은 것으로 보인다.

기존 Anthropic 프로바이더와 혼동하기 쉬움

혼란스럽게도, Agent Framework에는 Claude 관련 패키지가 두 계통이 있다. 임포트 경로(import path)가 둘 다 agent_framework.anthropic 하위이므로, 이름만 봐서는 구분이 되지 않는다.

"Claude를 에이전트의 두뇌로 만드는 것"이 anthropic 패키지, "Claude Code를 에이전트의 손발로 만드는 것"이 claude 패키지라고 기억하는 것이 이해하기 쉬울 것이다.

어떻게 받아들였는가

멀티 에이전트 구성 안에 "코딩 담당"으로서 Claude Code를 배치하는 것은 나 자신에게도 필요했던 조각이다. 오케스트레이터(Orchestrator)는 Foundry의 저렴한 모델로 돌리고, 코드 생성 및 리팩토링만 Claude Code에 던지는—식의 역할 분담을 별도의 어댑터 없이 구성할 수 있게 된다. 발표문에 언급된 "텔레메트리(telemetry)에 탑재된다"는 점도 은근히 중요한데, 코딩 에이전트의 동작을 다른 에이전트와 동일한 관측 기반에서 추적할 수 있다는 것은 운영 측면에서 유용하다.

한편으로, beta 패키지인 이상 API는 아직 변동될 가능성이 있고, Claude Code CLI를 호스트에 두는 것을 전제로 하므로 서버 사이드에서 사용하려면 설치 및 인증 설계가 별도로 필요하다. 우선은 로컬 오케스트레이션 실험부터 시도하는 것이 현실적일 것이다. 나도 다음에는 실제로 구동해 보며 위임 관련 동작과 주의해야 할 점(pitfalls)을 확인해 보고 싶다.

참고 링크 (1차 소스)

참고 링크 (1차 소스)

• Announcing: GitHub Copilot and Claude Code connectors in Microsoft Agent Framework (Azure Updates, 2026-07-15)
• agent-framework-claude (PyPI) / agent-framework-github-copilot (PyPI)
• python/packages/claude — 実装とREADME (GitHub)
• python/packages/github_copilot — 実装とREADME (GitHub)
• ClaudeAgent 샘플 코드 (GitHub)
• Providers Overview — Microsoft Learn
• Microsoft.Agents.AI.GitHub.Copilot (NuGet)

논의