Skip to main content

개요

Claude Code SDK는 Claude Agent SDK로 이름이 변경되었으며 설명서가 재구성되었습니다. 이 변경은 코딩 작업을 넘어 AI 에이전트를 구축하기 위한 SDK의 더 광범위한 기능을 반영합니다. OpenAI Agents SDK에서 마이그레이션하고 있습니까? OpenAI Agents SDK 마이그레이션 레시피는 단일 작업 예제를 통해 각 기본 요소를 Claude Agent SDK에 매핑합니다.

변경 사항

마이그레이션 단계

TypeScript 또는 JavaScript 프로젝트 마이그레이션

1. 기존 패키지 제거:
2. 새 패키지 설치:
3. 임포트 업데이트: @anthropic-ai/claude-code에서 @anthropic-ai/claude-agent-sdk로 모든 임포트를 변경합니다:
4. package.json 업데이트: package.json에 @anthropic-ai/claude-code가 여전히 나열되어 있으면 @anthropic-ai/claude-agent-sdk로 바꾸고 버전 범위도 업데이트합니다. 예를 들어 "^0.0.42"에서 "^0.3.0"으로 변경합니다. 5. 주요 변경 사항 검토 마이그레이션을 완료하기 위해 필요한 코드 변경을 수행합니다.

Python 프로젝트 마이그레이션

1. 기존 패키지 제거:
기존 패키지가 설치되어 있지 않으면 pip에서 WARNING: Skipping claude-code-sdk as it is not installed.를 출력합니다. 이는 정상이며 다음 단계로 진행할 수 있습니다. 2. 새 패키지 설치:
requirements.txt 또는 pyproject.toml에 claude-code-sdk가 나열되어 있으면 claude-agent-sdk로 바꿉니다. 3. 임포트 업데이트: claude_code_sdk에서 claude_agent_sdk로 모든 임포트를 변경합니다:
4. 주요 변경 사항 검토 마이그레이션을 완료하기 위해 필요한 코드 변경을 수행합니다.

주요 변경 사항

격리 및 명시적 구성을 개선하기 위해 Claude Agent SDK v0.1.0은 Claude Code SDK에서 마이그레이션하는 사용자를 위한 주요 변경 사항을 도입합니다.

Python: ClaudeCodeOptions가 ClaudeAgentOptions로 이름 변경됨

변경 사항: Python SDK 타입 ClaudeCodeOptions가 ClaudeAgentOptions로 이름이 변경되었습니다. 마이그레이션:

시스템 프롬프트가 더 이상 기본값이 아님

변경 사항: SDK는 더 이상 기본적으로 Claude Code의 시스템 프롬프트를 사용하지 않습니다. 마이그레이션:

설정 소스 기본값

이 기본값은 v0.1.0에서 파일 시스템 설정을 로드하지 않도록 잠시 변경되었다가 되돌려졌으므로 마이그레이션 조치가 필요하지 않습니다. 현재 동작: query()에서 settingSources를 생략하면 사용자, 프로젝트 및 로컬 파일 시스템 설정을 로드하며, 이는 CLI와 일치합니다. 여기에는 ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json, CLAUDE.md 파일 및 사용자 정의 명령이 포함됩니다. 파일 시스템 설정에서 격리된 상태로 실행하려면 settingSources: [] 또는 Python에서 setting_sources=[]를 전달하세요. 각 소스가 로드하는 항목에 대해서는 settingSources로 파일 시스템 설정 제어를 참조하세요. 격리는 특히 CI/CD 파이프라인, 배포된 애플리케이션, 테스트 환경 및 로컬 사용자 정의가 유출되지 않아야 하는 다중 테넌트 시스템에서 중요합니다.
Python SDK 0.1.59 이하는 빈 목록을 옵션 생략과 동일하게 처리했으므로 setting_sources=[]에 의존하기 전에 업그레이드하세요. settingSources가 []일 때도 읽혀지는 입력에 대해서는 settingSources가 제어하지 않는 항목을 참조하세요.

다음 단계