---
title: "Claude Code SDK, now the Claude Agent SDK | Bombos"
description: "The Claude Code SDK is now the Claude Agent SDK: Claude Code's tools, agent loop and context management as a Python or TypeScript library for your own agents."
image: "https://bombos.ai/assets/og-en-v2.png"
---

# What is the Claude Code SDK, now the Claude Agent SDK?

Short answer

The Claude Code SDK was renamed the Claude Agent SDK. It gives you the same tools, agent loop and context management that power Claude Code, as a library in Python (claude-agent-sdk) and TypeScript (@anthropic-ai/claude-agent-sdk). Use it to embed an agent in your own application. For scripts and CI in any language, claude -p is the same SDK through the command line.

*Piet Baudoin · published November 17, 2026 · November 17, 2026*

## The rename

Anthropic renamed the Claude Code SDK to the Claude Agent SDK to reflect that it builds agents for more than coding. The packages changed with it:

|  | Old | New |
| --- | --- | --- |
| Python | `claude-code-sdk` | `claude-agent-sdk` |
| TypeScript / JavaScript | `@anthropic-ai/claude-code` | `@anthropic-ai/claude-agent-sdk` |
| Python options class | `ClaudeCodeOptions` | `ClaudeAgentOptions` |

One breaking change matters most when migrating: the SDK no longer uses Claude Code’s system prompt by default. To get the old behavior, set `systemPrompt` to `{ type: "preset", preset: "claude_code" }`.

## What you get

The SDK runs the Claude Code binary as a library, so the agent can do what Claude Code does:

-   **Built-in tools**: read, write and edit files, run commands, search the web.
-   **The agent loop**: Claude plans, calls tools, reads the results and decides the next step. The SDK handles orchestration, tool execution, context management and retries; you consume a stream of messages.
-   **Permissions**: which tools run without approval, which need it.
-   **Hooks, subagents, MCP servers and plugins**, the same building blocks as in the CLI.
-   **Sessions** you can resume or fork.
-   **Skills, commands and memory** loaded from `.claude/` and `~/.claude/`, as in Claude Code.

## A first agent in four steps

1.  **Requirements.** Node.js 18.14+ or Python 3.10+, and an API key from the Claude Console.
2.  **Install.** `pip install claude-agent-sdk` or `npm install @anthropic-ai/claude-agent-sdk`.
3.  **Set the key.** `export ANTHROPIC_API_KEY=...`. The SDK does not load `.env` files itself. For Bedrock, Google Cloud or Foundry, set `CLAUDE_CODE_USE_BEDROCK=1`, `CLAUDE_CODE_USE_VERTEX=1` or `CLAUDE_CODE_USE_FOUNDRY=1` with that provider’s credentials.
4.  **Call `query`.** Shortened from the quickstart:

```
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Review utils.py for bugs that would cause crashes. Fix any issues you find.",
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Edit", "Glob"],
            permission_mode="acceptEdits",
        ),
    ):
        print(message)

asyncio.run(main())
```

`allowed_tools` pre-approves those tools. To limit which built-in tools exist at all, pass them as `tools` instead; with `allowed_tools`, the agent can still call others, subject to the permission mode.

## SDK, CLI with -p, or something else

| You want to | Use |
| --- | --- |
| Work interactively or run a one-off task from a terminal | Claude Code CLI |
| Script Claude Code in CI, a git hook or a shell loop, in any language | `claude -p` with `--output-format json` |
| Embed the agent in your own Python or TypeScript app, with callbacks for tool approval and typed message objects | Agent SDK |
| Call the model directly and write the tool loop yourself | Client SDK (the Claude API) |
| Let Anthropic host the agent and its sandbox | Managed Agents |

Anthropic’s own docs describe `claude -p` as “the Agent SDK via the CLI”. The difference is control: the packages give you structured outputs, tool approval callbacks and native message objects. For scripted runs, the docs recommend `--bare`, which skips local hooks, skills, plugins, MCP servers and `CLAUDE.md` so a run behaves the same on every machine.

## The misunderstanding: “the SDK is a thin wrapper around the API”

The Client SDK is that. The Agent SDK is Claude Code itself, packaged: it executes tools directly instead of asking your code to implement them, and by default it picks up the same settings and `CLAUDE.md` files the CLI would find on that machine. That is convenient on a laptop and a surprise on a server, where a stray `~/.claude` can change behavior. Pass an empty `settingSources` when you deploy.

## What this means for a team

An agent built on the SDK has the same memory model as Claude Code: what is in the working directory, `CLAUDE.md`, and the session. Two agents built by two developers do not share what either learned, and an agent running for customers should usually not read a developer’s personal settings at all. See [Claude Code memory](https://bombos.ai/en/questions/claude-code/claude-code-memory/), [plugins and memory](https://bombos.ai/en/questions/claude-code/claude-code-plugins-memory/), and [shared memory across coding agents](https://bombos.ai/en/knowledge-base/shared-memory-across-coding-agents/).

## Where Bombos fits

When a team builds its own agents on the SDK, each one starts with only the context someone passes in. Bombos is a plugin that gives those agents, Claude Code and the team’s other AI tools one shared memory: team knowledge, rules the team learned, and what already lives in mail, documents and repos, traceable to its source, in the cloud or on your own server. One developer can try it on their own agents first.

## Related questions

Can I use my Claude Pro or Max login with the Agent SDK?

For your own use, the SDK authenticates with an API key from the Claude Console or with Bedrock, Google Cloud's Agent Platform or Microsoft Foundry credentials. Anthropic does not allow third-party developers to offer claude.ai login or rate limits in products built on the SDK unless previously approved.

Do I have to install Claude Code separately?

Usually not. Both the Python and TypeScript packages bundle a native Claude Code binary. Exceptions are a Python source install, for example on ARM64 Windows, and npm installs that skip optional dependencies.

Does the SDK read CLAUDE.md and .claude/settings.json?

Yes, by default. Leaving out settingSources loads user, project and local settings, CLAUDE.md files and custom commands, like the CLI. Pass an empty list to run isolated, which the docs recommend for CI, deployed apps and multi-tenant systems.

What changed in the rename besides the name?

The packages moved to claude-agent-sdk and @anthropic-ai/claude-agent-sdk, ClaudeCodeOptions became ClaudeAgentOptions in Python, and the SDK no longer uses Claude Code's system prompt by default. Ask for it with systemPrompt set to the claude\_code preset.

Can I call my agent Claude Code?

No. Anthropic's branding guidelines allow names like Claude Agent or YourAgent Powered by Claude, and do not permit Claude Code or Claude Code Agent, or visuals that mimic Claude Code.

## Sources

1.  [Claude Code docs: Agent SDK overview](https://code.claude.com/docs/en/agent-sdk/overview)
2.  [Claude Code docs: Agent SDK quickstart](https://code.claude.com/docs/en/agent-sdk/quickstart)
3.  [Claude Code docs: Migrate to Claude Agent SDK](https://code.claude.com/docs/en/agent-sdk/migration-guide)
4.  [Claude Code docs: Run Claude Code programmatically](https://code.claude.com/docs/en/headless)

## What does your AI forget?

1.  01You tell us which AI you use and where it keeps starting over.
2.  02We show what a shared memory changes there, on your own examples.
3.  03You keep the plan, with or without Bombos.

![Piet Baudoin](https://bombos.ai/assets/team/piet-klein.jpg)

**Piet Baudoin**You talk to Piet, from the Bombos teamDutch team from Utrecht and Nijmegen · data in Europe

## More questions about Claude Code

-   [What are agent teams in Claude Code and how do you turn them on?](https://bombos.ai/en/questions/claude-code/claude-code-agent-teams/)
-   [OpenCode vs Claude Code: which coding agent should I use?](https://bombos.ai/en/questions/claude-code/opencode-vs-claude-code/)
-   [What are Claude Code hooks and how do I set them up?](https://bombos.ai/en/questions/claude-code/claude-code-hooks/)
-   [How do I use Claude Code in VS Code and JetBrains?](https://bombos.ai/en/questions/claude-code/claude-code-in-vs-code-and-jetbrains/)
-   [What is Claude Code Remote Control and how do I use it?](https://bombos.ai/en/questions/claude-code/claude-code-remote-control/)
-   [What are Claude Code skills and how do you write one?](https://bombos.ai/en/questions/claude-code/claude-code-skills/)
-   [What are subagents in Claude Code and when should you use them?](https://bombos.ai/en/questions/claude-code/claude-code-subagents/)
-   [How much does Claude Code cost per developer per month in tokens?](https://bombos.ai/en/questions/claude-code/claude-code-token-cost-per-developer/)

[All questions about Claude Code →](https://bombos.ai/en/questions/claude-code/)


---

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","url":"https://bombos.ai/","logo":"https://bombos.ai/assets/bombos-bee.png","description":"Bombos is the memory layer under every AI your team uses. One shared memory for Claude, ChatGPT, Copilot, Cursor and your own agents, that learns how you work.","sameAs":["https://www.linkedin.com/company/bombos-ai","https://www.youtube.com/@truebombos","https://www.instagram.com/truebombos/","https://bsky.app/profile/bombostrue.bsky.social","https://www.threads.com/@truebombos","https://mastodon.social/@Bombos","https://www.tiktok.com/@truebombos","https://t.me/truebombos","https://www.pinterest.com/truebombos/","https://github.com/bombos-ai","https://linktr.ee/bombos.ai","https://bombosai.substack.com","https://hashnode.com/@bombosai","https://hackernoon.com/u/bombos","https://dev.to/bombos"],"email":"info@bombos.ai","areaServed":["NL","Europe"],"knowsLanguage":["nl","en"],"contactPoint":{"@type":"ContactPoint","email":"info@bombos.ai","contactType":"sales","url":"https://bombos.ai/en/contact/","availableLanguage":["nl","en"]}},{"@type":"WebSite","@id":"https://bombos.ai/#website","name":"Bombos","url":"https://bombos.ai/","inLanguage":["nl-NL","en"],"publisher":{"@id":"https://bombos.ai/#organization"}}]}

{"@context":"https://schema.org","@type":"Article","headline":"What is the Claude Code SDK, now the Claude Agent SDK?","description":"The Claude Code SDK is now the Claude Agent SDK: Claude Code's tools, agent loop and context management as a Python or TypeScript library for your own agents.","abstract":"The Claude Code SDK was renamed the Claude Agent SDK. It gives you the same tools, agent loop and context management that power Claude Code, as a library in Python (claude-agent-sdk) and TypeScript (@anthropic-ai/claude-agent-sdk). Use it to embed an agent in your own application. For scripts and CI in any language, claude -p is the same SDK through the command line.","datePublished":"2026-11-17T00:00:00.000Z","dateModified":"2026-11-17T00:00:00.000Z","author":{"@type":"Person","name":"Piet Baudoin"},"publisher":{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","logo":{"@type":"ImageObject","url":"https://bombos.ai/assets/bombos-bee.png"}},"image":"https://bombos.ai/assets/og-en-v2.png","mainEntityOfPage":"https://bombos.ai/en/questions/claude-code/claude-code-sdk/","inLanguage":"en-US","isPartOf":{"@type":"CollectionPage","name":"Claude Code","url":"https://bombos.ai/en/questions/claude-code/"},"citation":[{"@type":"CreativeWork","name":"Claude Code docs: Agent SDK overview","url":"https://code.claude.com/docs/en/agent-sdk/overview"},{"@type":"CreativeWork","name":"Claude Code docs: Agent SDK quickstart","url":"https://code.claude.com/docs/en/agent-sdk/quickstart"},{"@type":"CreativeWork","name":"Claude Code docs: Migrate to Claude Agent SDK","url":"https://code.claude.com/docs/en/agent-sdk/migration-guide"},{"@type":"CreativeWork","name":"Claude Code docs: Run Claude Code programmatically","url":"https://code.claude.com/docs/en/headless"}]}

{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Bombos","item":"https://bombos.ai/en/"},{"@type":"ListItem","position":2,"name":"Questions","item":"https://bombos.ai/en/questions/"},{"@type":"ListItem","position":3,"name":"Claude Code","item":"https://bombos.ai/en/questions/claude-code/"},{"@type":"ListItem","position":4,"name":"What is the Claude Code SDK, now the Claude Agent SDK?","item":"https://bombos.ai/en/questions/claude-code/claude-code-sdk/"}]}

{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Can I use my Claude Pro or Max login with the Agent SDK?","acceptedAnswer":{"@type":"Answer","text":"For your own use, the SDK authenticates with an API key from the Claude Console or with Bedrock, Google Cloud's Agent Platform or Microsoft Foundry credentials. Anthropic does not allow third-party developers to offer claude.ai login or rate limits in products built on the SDK unless previously approved."}},{"@type":"Question","name":"Do I have to install Claude Code separately?","acceptedAnswer":{"@type":"Answer","text":"Usually not. Both the Python and TypeScript packages bundle a native Claude Code binary. Exceptions are a Python source install, for example on ARM64 Windows, and npm installs that skip optional dependencies."}},{"@type":"Question","name":"Does the SDK read CLAUDE.md and .claude/settings.json?","acceptedAnswer":{"@type":"Answer","text":"Yes, by default. Leaving out settingSources loads user, project and local settings, CLAUDE.md files and custom commands, like the CLI. Pass an empty list to run isolated, which the docs recommend for CI, deployed apps and multi-tenant systems."}},{"@type":"Question","name":"What changed in the rename besides the name?","acceptedAnswer":{"@type":"Answer","text":"The packages moved to claude-agent-sdk and @anthropic-ai/claude-agent-sdk, ClaudeCodeOptions became ClaudeAgentOptions in Python, and the SDK no longer uses Claude Code's system prompt by default. Ask for it with systemPrompt set to the claude_code preset."}},{"@type":"Question","name":"Can I call my agent Claude Code?","acceptedAnswer":{"@type":"Answer","text":"No. Anthropic's branding guidelines allow names like Claude Agent or YourAgent Powered by Claude, and do not permit Claude Code or Claude Code Agent, or visuals that mimic Claude Code."}}]}
```
