Visão Geral
O Claude Code SDK foi renomeado para o Claude Agent SDK e sua documentação foi reorganizada. Esta mudança reflete as capacidades mais amplas do SDK para construir agentes de IA além de apenas tarefas de codificação. Migrando do OpenAI Agents SDK? A receita de migração do OpenAI Agents SDK mapeia cada primitivo para o Claude Agent SDK através de um único exemplo prático.O Que Mudou
Etapas de Migração
Migrar um projeto TypeScript ou JavaScript
1. Desinstale o pacote antigo:@anthropic-ai/claude-code para @anthropic-ai/claude-agent-sdk:
@anthropic-ai/claude-code ainda estiver listado em seu package.json, substitua-o por @anthropic-ai/claude-agent-sdk e atualize também o intervalo de versão, por exemplo de "^0.0.42" para "^0.3.0".
5. Revise mudanças significativas
Faça as alterações de código necessárias para concluir a migração.
Migrar um projeto Python
1. Desinstale o pacote antigo:WARNING: Skipping claude-code-sdk as it is not installed. Isso é esperado e você pode continuar para a próxima etapa.
2. Instale o novo pacote:
claude-code-sdk estiver listado em seu requirements.txt ou pyproject.toml, substitua-o por claude-agent-sdk.
3. Atualize suas importações:
Altere todas as importações de claude_code_sdk para claude_agent_sdk:
Mudanças significativas
Python: ClaudeCodeOptions renomeado para ClaudeAgentOptions
O que mudou: O tipoClaudeCodeOptions do SDK Python foi renomeado para ClaudeAgentOptions.
Migração:
System prompt não é mais padrão
O que mudou: O SDK não usa mais o system prompt do Claude Code por padrão. Migração:Padrão de fontes de configurações
Este padrão foi brevemente alterado em v0.1.0 para não carregar configurações do sistema de arquivos e depois foi revertido, portanto nenhuma ação de migração é necessária. Comportamento atual: OmitirsettingSources em query() carrega as configurações do usuário, projeto e sistema de arquivos local, correspondendo à CLI. Isso inclui ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json, arquivos CLAUDE.md e comandos personalizados.
Para executar isolado das configurações do sistema de arquivos, passe settingSources: [], ou setting_sources=[] em Python. Consulte Controlar configurações do sistema de arquivos com settingSources para saber o que cada fonte carrega.
O isolamento é especialmente importante para pipelines de CI/CD, aplicações implantadas, ambientes de teste e sistemas multi-tenant, onde as personalizações locais não devem vazar.
Python SDK 0.1.59 e anteriores tratavam uma lista vazia da mesma forma que omitir a opção, portanto atualize antes de confiar em
setting_sources=[]. Consulte O que settingSources não controla para entradas que são lidas mesmo quando settingSources é [].Próximas Etapas
- Explore a Visão Geral do Agent SDK para aprender sobre os recursos disponíveis
- Confira a Referência do SDK TypeScript para documentação detalhada da API
- Revise a Referência do SDK Python para documentação específica do Python
- Aprenda sobre Ferramentas Personalizadas e Integração MCP