이름 바뀜: Claude Code SDK는 이제 Claude Agent SDK

이름 바뀜 한 단락

2025년 후반 Anthropic이 Claude Code SDK를 Claude Agent SDK로 rename — 이제 코드 작성 전용 아니라 Claude Code 능력 기반의 일반 자율-에이전트 하니스란 걸 반영. 새 패키지 이름 — PyPI의 claude-agent-sdk, npm의 @anthropic-ai/claude-agent-sdk. 옛 claude-code-sdk 패키지는 마이그레이션 history.

살아남은 거, 바뀐 거

아키텍처 같음 — Claude 서브프로세스가 transport에 wrap, 도구·세션·MCP·hooks 함께. Python 옵션 타입이 ClaudeCodeOptions에서 ClaudeAgentOptions로. 디폴트 시스템 프롬프트 가정 바뀜 — SDK가 이제 Claude Code 시스템 프롬프트 자동 주입 X; system_prompt={"type": "preset", "preset": "claude_code"}로 opt-in.

Search-and-replace로서 마이그레이션

옛 SDK에서 돌던 코드면 마이그레이션이 대부분 mechanical — 패키지 이름 교체, ClaudeCodeOptions를 ClaudeAgentOptions로, Claude Code preset 원하는지 결정(코드 편집 에이전트면 yes, fresh-페르소나 에이전트면 no). 새 버전 핀하고 테스트 run.

원칙: SDK가 자기 이름 바꾸면 그게 옛 튜토리얼 stale의 가장 큰 신호. 모든 거 현재 docs와 현재 설치 소스 대비 verify.

Code

Renamed SDK 설치·bash

# Python
pip install -U claude-agent-sdk
python -c "import claude_agent_sdk; print(claude_agent_sdk.__version__)"

# TypeScript
npm install @anthropic-ai/claude-agent-sdk
node -e "console.log(require('@anthropic-ai/claude-agent-sdk/package.json').version)"

마이그레이션 grep·bash

# 옛 이름 아직 사용하는 모든 사이트 찾기
rg "claude-code-sdk|@anthropic-ai/claude-code-sdk|ClaudeCodeOptions|claude_code_sdk" .

# 새 거로 교체, 그다음 테스트 re-run.

새 패키지로 첫 호출·python

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        cwd="/tmp",
        # Code 스타일 행동 위해 Claude Code preset에 opt INTO:
        system_prompt={"type": "preset", "preset": "claude_code"},
    )
    async for event in query(prompt="Say hi.", options=options):
        print(event)

asyncio.run(main())

이름 바뀜: Claude Code SDK는 이제 Claude Agent SDK

이름 바뀜 한 단락

살아남은 거, 바뀐 거

Search-and-replace로서 마이그레이션

Code

External links

Exercise

Progress

댓글 0