​
SDK Options

The Claude Code SDK is available in multiple forms to suit different use cases:

​
Why use the Claude Code SDK?

Built on top of the agent harness that powers Claude Code, the Claude Code SDK provides all the building blocks you need to build production-ready agents:

  • Optimized Claude integration: Automatic prompt caching and performance optimizations
  • Rich tool ecosystem: File operations, code execution, web search, and MCP extensibility
  • Advanced permissions: Fine-grained control over agent capabilities
  • Production essentials: Built-in error handling, session management, and monitoring

​
What can you build with the SDK?

Here are some example agent types you can create:

Coding agents:

  • SRE agents that diagnose and fix production issues
  • Security review bots that audit code for vulnerabilities
  • Oncall engineering assistants that triage incidents
  • Code review agents that enforce style and best practices

Business agents:

  • Legal assistants that review contracts and compliance
  • Finance advisors that analyze reports and forecasts
  • Customer support agents that resolve technical issues
  • Content creation assistants for marketing teams

​
Core Concepts

​
Authentication

For basic authentication, retrieve an Anthropic API key from the Anthropic Console and set the ANTHROPIC_API_KEY environment variable.

The SDK also supports authentication via third-party API providers:

  • Amazon Bedrock: Set CLAUDE_CODE_USE_BEDROCK=1 environment variable and configure AWS credentials
  • Google Vertex AI: Set CLAUDE_CODE_USE_VERTEX=1 environment variable and configure Google Cloud credentials

For detailed configuration instructions for third-party providers, see the Amazon Bedrock and Google Vertex AI documentation.

​
Full Claude Code Feature Support

The SDK provides access to all the default features available in Claude Code, leveraging the same file system-based configuration:

  • Subagents: Launch specialized agents stored as Markdown files in ./.claude/agents/
  • Hooks: Execute custom commands configured in ./.claude/settings.json that respond to tool events
  • Slash Commands: Use custom commands defined as Markdown files in ./.claude/commands/
  • Memory (CLAUDE.md): Maintain project context through CLAUDE.md files that provide persistent instructions and context

These features work identically to their Claude Code counterparts by reading from the same file system locations.

​
System Prompts

System prompts define your agent’s role, expertise, and behavior. This is where you specify what kind of agent you’re building.

​
Tool Permissions

Control which tools your agent can use with fine-grained permissions:

  • allowedTools - Explicitly allow specific tools
  • disallowedTools - Block specific tools
  • permissionMode - Set overall permission strategy

​
Model Context Protocol (MCP)

Extend your agents with custom tools and integrations through MCP servers. This allows you to connect to databases, APIs, and other external services.