Skip to main content

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:
2. Instale o novo pacote:
3. Atualize suas importações: Altere todas as importações de @anthropic-ai/claude-code para @anthropic-ai/claude-agent-sdk:
4. Atualize package.json: Se @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:
Se o pacote antigo não estiver instalado, pip imprime 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:
Se 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:
4. Revise mudanças significativas Faça as alterações de código necessárias para concluir a migração.

Mudanças significativas

Para melhorar o isolamento e a configuração explícita, Claude Agent SDK v0.1.0 introduz mudanças significativas para usuários que migram do Claude Code SDK.

Python: ClaudeCodeOptions renomeado para ClaudeAgentOptions

O que mudou: O tipo ClaudeCodeOptions 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: Omitir settingSources 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