Claude Agent SDK 공식 통합
Xcode 26.3 Claude Agent,
구독 있어도 따로 냅니다
Claude Pro나 Max를 이미 쓰고 있다면 “Xcode에서 그냥 쓰면 되겠지”라고 생각하기 쉽습니다. 막상 설정을 열어보면 다릅니다. API 키 입력 화면이 먼저 뜹니다. 공식 문서에 조용히 박혀 있는 청구 분리 구조, 그리고 모델 선택 하나가 비용을 5배로 바꾸는 실제 구조까지 정리했습니다.
(입력/출력 per MTok)
(입력/출력 per MTok)
단일 요청 생성 코드량
Xcode 26.3 Claude Agent — 실제로 어떻게 작동하나
2026년 2월 3일, Apple은 Xcode 26.3을 공개하면서 Anthropic의 Claude Agent SDK와 OpenAI Codex를 IDE 안에 직접 통합했습니다. 이전 Xcode 26에서 Claude Sonnet 4를 쓸 수 있었지만, 그건 코드 한 줄씩 제안받는 수준이었습니다. 이번은 다릅니다. (출처: Anthropic 공식 블로그, 2026.02.03)
Apple의 공식 데모에서 개발자 Ken은 “SwiftUI로 사진 갤러리 뷰를 추가하고 PhotosUI를 연동해줘”라고 자연어로 한 번 입력했습니다. Claude Agent는 프로젝트 파일 구조를 스스로 파악하고, WeatherKit 엔타이틀먼트를 추가하고, 날씨 서비스 클래스를 작성하고, Liquid Glass 7일 예보 뷰를 만들고, 빌드 오류까지 혼자 고쳤습니다. 결과물은 400줄 이상의 신규 코드였고, 시간은 “몇 분”이었습니다. (출처: Apple Developer Tech Talks, 2026.02.04)
에이전트가 IDE 안에서 실제로 할 수 있는 것들
빌드를 직접 돌리고, 에러 목록을 확인하고, 수정 후 다시 빌드합니다. SwiftUI 프리뷰를 캡처해서 화면이 의도한 디자인과 맞는지까지 스스로 검증합니다. 단순히 코드를 던져주는 게 아니라 “동작할 때까지” 루프를 돌린다는 게 핵심입니다.
Apple의 최신 개발자 문서도 실시간으로 조회합니다. “Liquid Glass API를 어떻게 쓰는지”를 검색하고, 최신 베스트 프랙티스로 코드를 작성합니다. 오래된 deprecated API를 쓰는 실수가 줄어드는 구조입니다.
Pro·Max 구독자가 처음 마주치는 화면
⚠️ 이 부분이 기존 블로그에 거의 안 나옵니다
공식 발표문과 실제 설정 화면을 같이 놓고 보니 이런 차이가 보였습니다.
Xcode 26.3 Intelligence Settings를 열면 Claude Agent 다운로드 버튼이 나옵니다. 다운로드가 끝나면 곧바로 “Anthropic 계정으로 로그인하거나 API 키를 입력하세요”라는 화면이 뜹니다. claude.ai Pro 계정으로 로그인은 됩니다. 그런데 여기서 문제가 시작됩니다.
Reddit의 r/Xcode 커뮤니티에서 가장 많이 공유된 스레드 제목이 “아야! Xcode는 Claude Code 구독을 사용하지 않아요(Ouch! Xcode does NOT use Claude Code subscriptions)”였습니다. 실제 사용자들이 Pro나 Max 구독으로 로그인해도 에이전트가 정상 작동하지 않거나, 작동하더라도 claude.ai 구독 한도가 아닌 별도 API 청구로 빠져나간다는 사실을 직접 발견한 것입니다. (출처: Reddit r/Xcode, 2026.02.08)
Claude Code CLI와 다른 점
터미널에서 claude -p 명령으로 Claude Code를 CLI 방식으로 쓰면 Pro·Max 구독 한도가 적용됩니다. 그런데 Claude Agent SDK를 프로그래밍 방식으로 호출하는 순간, 즉 Xcode가 내부적으로 SDK를 호출하는 방식에서는 API 전용 청구가 강제됩니다. GitHub의 Claude Agent SDK 공식 이슈 트래커에 올라온 Issue #559에 이 구조가 명확하게 설명되어 있습니다. “Agent SDK는 API 키 인증을 요구하며 claude.ai 구독 청구(Pro/Max)를 명시적으로 허용하지 않습니다.” (출처: GitHub anthropics/claude-agent-sdk-python Issue #559, 2026.02.09)
API 청구와 구독 청구, 완전히 다른 이유
Anthropic은 공식 지원 문서에서 이 구분을 명확하게 설명합니다. “Claude 유료 구독과 Claude Console은 서로 다른 목적을 위해 설계된 별개의 제품입니다. 유료 구독은 claude.ai 채팅 경험을 강화하며, Console은 애플리케이션 구축을 위한 API 키와 모델 접근을 제공하는 개발자 플랫폼입니다.” 두 상품은 겹치지 않습니다. 구독이 있어도 API는 따로 결제해야 합니다. (출처: Anthropic 공식 지원 문서, support.claude.com)
💡 공식 문서와 실제 설정 흐름을 같이 놓고 보니 이런 구조가 보였습니다
Claude Code CLI(claude -p)는 Pro·Max 구독 한도로 동작합니다. Xcode가 내부적으로 호출하는 Claude Agent SDK는 API 전용 청구입니다. 같은 Claude 모델을 쓰지만 요금이 나오는 경로가 다릅니다. Max 플랜($100~200/월)을 이미 쓰고 있는 개발자가 Xcode 에이전트를 쓰면 두 청구서를 동시에 받게 됩니다.
그럼 얼마나 나오나
API 청구는 토큰 사용량에 따라 달라집니다. Opus 4.6 기준으로 입력 토큰은 백만 개당 $5, 출력 토큰은 백만 개당 $25입니다. Apple의 데모에서처럼 400줄 이상의 코드를 생성하는 단일 세션을 Opus 4.6으로 돌리면, 출력 토큰만 약 15,000~20,000개로 추정됩니다. 이 경우 출력 비용만 약 $0.375~$0.50이 나옵니다. 하루에 5~10번 이런 세션을 돌리면 월간 API 비용이 $50~150 수준에 이를 수 있습니다. (출처: Anthropic API 공식 가격표, platform.claude.com)
Sonnet vs Opus — 모델 선택이 비용을 바꾸는 방식
Xcode 26.3 설정에서 Claude Agent를 활성화하면 Opus 4.6과 Sonnet 4.6 중 하나를 선택할 수 있습니다. 많은 개발자들이 “더 좋은 모델을 써야지”라며 Opus를 고릅니다. 이 선택이 비용 구조에서 어떤 의미인지는 짚고 넘어가야 합니다.
| 항목 | Sonnet 4.6 | Opus 4.6 |
|---|---|---|
| 입력 단가 | $3 / MTok | $5 / MTok |
| 출력 단가 | $15 / MTok | $25 / MTok |
| 출력 배수 차이 | 기준 | 약 1.67배 비쌈 |
| 컨텍스트 윈도우 | 200k 토큰 | 1M 토큰 (beta) |
| 1M 토큰 초과 시 추가 요금 | 해당 없음 | $10/$37.50 per MTok |
(출처: Anthropic API 공식 가격표, platform.claude.com/docs/en/about-claude/pricing)
출력 토큰 기준으로 Opus가 Sonnet보다 약 1.67배 비쌉니다. 에이전틱 세션은 출력 토큰을 많이 씁니다. 코드를 생성하고, 에러를 수정하고, 요약을 출력하는 모든 과정이 출력 토큰입니다. 하루에 10번 세션을 돌릴 때 Sonnet을 쓰면 월간 비용이 $X라면, Opus를 쓰면 $1.6X~$1.7X에 달합니다. 단순한 요금 차이가 아니라, 대형 프로젝트를 오래 쓸수록 벌어지는 차이입니다.
💡 발표문 수치와 실제 청구 흐름을 교차해보니 보이는 것
Opus 4.6의 1M 토큰 컨텍스트는 “베타”이며 200k 초과분은 입력 단가가 2배($10)로 뜁니다. 대형 코드베이스를 한 세션에 통째로 올릴 때 예상보다 큰 비용이 나올 수 있습니다. Sonnet 4.6은 200k 토큰까지이지만, 일반적인 iOS 앱 코드베이스 규모에서는 이 한도가 충분한 경우가 많습니다. 성능이 필요한 작업에만 Opus를 쓰고 나머지는 Sonnet으로 두는 전략이 현실적입니다.
MCP 아키텍처가 만든 진짜 가능성
Xcode 26.3 Claude Agent 통합에서 기술적으로 가장 주목할 부분은 MCP(Model Context Protocol)입니다. Xcode가 자신의 기능들을 MCP 서버로 노출하고, AI 에이전트는 MCP 클라이언트로 붙는 구조입니다. 쉽게 말하면 Xcode가 API 서버가 된 것입니다. (출처: Anthropic 공식 블로그, 2026.02.03)
이 구조의 의미는 두 가지입니다. 첫째, Claude가 아니어도 MCP 호환 에이전트라면 Xcode에 붙을 수 있습니다. Apple이 특정 AI 공급사에 종속되지 않겠다는 선언입니다. 둘째, CLI에서 Claude Code를 쓰는 개발자는 MCP를 통해 Xcode와 연동하면서 SwiftUI 프리뷰를 캡처하는 것도 가능합니다. Xcode 앱 안에서만 에이전트를 써야 하는 게 아닙니다.
Claude Code CLI + Xcode MCP 연동은 구독으로 가능한가
CLI 방식의 Claude Code(claude 명령어)는 Pro·Max 구독으로 동작합니다. Xcode를 MCP 서버로 연결하는 건 Claude Code CLI가 수행하기 때문에, 이 경로로 쓰면 API 청구가 아닌 구독 한도 내에서 처리됩니다. Anthropic이 공식 블로그에서 “Claude Code를 사용하는 개발자는 MCP를 통해 Xcode와 통합하고 CLI를 떠나지 않고도 시각적 프리뷰를 캡처할 수 있다”고 밝혔습니다. Pro·Max 구독자에게 실용적인 대안입니다. (출처: Anthropic 공식 블로그, 2026.02.03)
AI가 쓴 코드, 리뷰 없이 믿으면 생기는 일
에이전틱 코딩의 편의성에 가려진 부분이 있습니다. Xcode 에이전트가 자율적으로 파일을 수정하고 빌드를 돌리는 동안, 개발자가 놓치기 쉬운 보안 이슈가 함께 생성될 수 있습니다. 연구에 따르면 AI 코드 생성기는 인증·암호화·SQL 쿼리 같은 보안 민감 영역에서 30~40% 확률로 취약한 코드를 생성합니다. (출처: Microsoft AI Security Research, 2026.02)
Xcode 26.3은 에이전트가 변경을 가할 때마다 마일스톤을 자동 생성합니다. 언제든 원하는 시점으로 되돌릴 수 있는 구조입니다. 다만 이 되돌리기 기능이 있다고 해서 리뷰를 건너뛰는 건 다른 문제입니다. 에이전트가 빌드까지 통과시킨 코드도 보안 관점에서는 별도 검토가 필요합니다.
지출 통제도 미리 설정해야 합니다
Anthropic Console에서 API 키를 발급할 때 월간 지출 한도를 설정할 수 있습니다. 에이전트가 자율적으로 작업하는 동안 예상보다 많은 토큰을 소비하는 경우가 생깁니다. 특히 빌드 오류를 반복적으로 수정하는 루프에서 토큰이 빠르게 줄어듭니다. 처음 쓸 때는 낮은 한도를 먼저 설정하고, 실제 사용 패턴을 파악한 뒤 올리는 방식이 안전합니다.
자주 묻는 것들
Q. Claude Pro 구독이 있는데 Xcode에서 Claude Agent를 쓸 수 없나요?
로그인 자체는 됩니다. 다만 Xcode가 내부적으로 Claude Agent SDK를 호출하는 방식에서는 API 키 청구가 적용됩니다. Pro 구독 한도 내에서 작동하지 않습니다. 대안은 CLI 방식의 Claude Code를 Xcode MCP 서버와 연결하는 것입니다. 이 경우 Pro·Max 구독 한도가 적용됩니다.
Q. Opus 4.6와 Sonnet 4.6 중 어떤 모델을 쓰는 게 좋나요?
복잡한 리팩토링이나 처음 보는 대형 코드베이스를 분석할 때는 Opus 4.6이 유리합니다. 반복적인 기능 추가나 작은 버그 수정 루프에서는 Sonnet 4.6으로도 충분합니다. 출력 단가 기준 Opus가 약 1.67배 비싸므로, 용도에 따라 구분해서 쓰는 편이 합리적입니다.
Q. Xcode 26.3은 언제부터 쓸 수 있나요?
2026년 2월 3일 기준으로 Apple Developer Program 회원에게 Release Candidate가 배포되었습니다. App Store 정식 배포는 RC 이후 진행됩니다. Apple Developer 사이트에서 다운로드할 수 있습니다.
Q. API 사용 비용에 상한선을 설정할 수 있나요?
Anthropic Console에서 API 키 발급 시 월간 지출 한도(Spending Limit)를 설정할 수 있습니다. 한도 초과 시 API 호출이 중단됩니다. 처음 쓸 때는 낮게 시작해서 실제 사용 패턴을 파악하는 것을 권장합니다.
Q. Claude Agent 외에 다른 에이전트도 Xcode 26.3에서 쓸 수 있나요?
Xcode 26.3은 MCP(Model Context Protocol) 기반 아키텍처를 사용합니다. MCP 호환 에이전트라면 이론적으로 Xcode와 연동할 수 있습니다. 현재 공식 지원은 Claude Agent와 OpenAI Codex 두 가지입니다. 앞으로 추가될 가능성이 있지만, Apple이 공식 일정을 밝히지 않은 상태입니다.
마치며
Xcode 26.3 Claude Agent는 분명 달라진 경험입니다. 단일 요청으로 400줄 코드를 생성하고, 빌드 오류까지 혼자 고치는 것을 직접 보면 생산성 격차가 느껴집니다. 다만 “구독 있으면 그냥 쓰면 된다”는 기대는 설정 화면 앞에서 멈춥니다.
Claude Pro·Max 구독과 Anthropic API는 별개입니다. 이건 Anthropic이 공식 지원 문서에 명시한 구조입니다. Xcode 에이전트는 API 청구가 기본이고, CLI로 Claude Code를 쓰면서 Xcode MCP 서버에 연결하면 구독 한도 내에서 같은 기능을 일부 활용할 수 있습니다.
모델 선택도 단순한 성능 문제가 아닙니다. Opus 4.6과 Sonnet 4.6의 출력 단가 차이가 1.67배입니다. 에이전틱 작업에서 출력 토큰은 많이 나옵니다. 용도를 구분해서 쓰는 것이 비용 효율적입니다. 처음 쓸 때 Console에서 월 지출 한도를 설정하고 시작하는 것을 권장합니다.
본 포스팅 참고 자료
- Apple 공식 뉴스룸 — Xcode 26.3 에이전틱 코딩 발표 (apple.com/kr/newsroom)
- Anthropic 공식 블로그 — Apple Xcode Claude Agent SDK 통합 (anthropic.com/news)
- Anthropic 공식 지원 문서 — 구독과 API 청구의 차이 (support.claude.com)
- Anthropic 공식 API 가격표 — Opus 4.6 / Sonnet 4.6 토큰 단가 (platform.claude.com)
- Anthropic GitHub — Claude Agent SDK Issue #559, Max 플랜 청구 요청 (github.com/anthropics)
- Apple Developer Tech Talks — Xcode 에이전틱 코딩 소개 영상 (developer.apple.com)
본 포스팅은 2026년 2월 3일 Xcode 26.3 RC 기준으로 작성되었습니다. 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. API 가격·구독 정책은 Anthropic의 정책에 따라 사전 예고 없이 변경될 수 있으며, 최신 정보는 공식 사이트에서 직접 확인하시기 바랍니다.
댓글 남기기