Claude Code SDK는 Claude Agent SDK로 이름이 바뀌었어

이름이 넓어진 쓰임을 드러내

Anthropic은 2025년 후반 Claude Code SDK를 Claude Agent SDK로 바꿨어. 코드 작성에만 쓰는 도구가 아니라 Claude Code의 능력을 바탕으로 여러 자율 에이전트를 만드는 실행 장치라는 뜻을 이름에 반영한 거야. 새 패키지는 PyPI의 claude-agent-sdk와 npm의 @anthropic-ai/claude-agent-sdk야.

뼈대는 남고 옵션 계약이 바뀌었어

Claude 서브프로세스를 감싸고 도구·세션·MCP·훅을 연결하는 구조는 그대로야. Python의 ClaudeCodeOptions는 ClaudeAgentOptions가 됐고, Claude Code 시스템 프롬프트는 더 이상 자동으로 들어가지 않아. 코드 편집 성격이 필요할 때만 system_prompt={"type": "preset", "preset": "claude_code"}로 선택해.

기계적 교체 뒤에 의도 하나를 결정해

기존 코드는 패키지 이름과 옵션 타입을 바꾸는 작업이 대부분이야. 다만 Claude Code 프리셋을 계속 쓸지는 에이전트 역할에 따라 명시적으로 골라야 해. 코드 편집 에이전트에는 맞을 수 있고, 새 페르소나를 가진 에이전트에는 불필요할 수 있어. 버전을 고정한 뒤 현재 문서와 시험으로 확인해.

원칙: 패키지 이름 변경은 옛 튜토리얼이 낡았다는 강한 신호야. 현재 문서와 설치된 소스로 다시 검증해.

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())

이름이 넓어진 쓰임을 드러내

뼈대는 남고 옵션 계약이 바뀌었어

기계적 교체 뒤에 의도 하나를 결정해

Code

External links

Exercise

Progress

댓글 0