claude-agent-sdk

Category: Development & Coding | Uploader: xiaolai | Downloads: 0 | Version: v1.0（Latest）

Build autonomous AI agents with Claude Agent SDK. TypeScript v0.2.71 | Python v0.1.48.

Changelog: Source: GitHub https://github.com/xiaolai/claude-agent-sdk-skill-autoupdated

Directory Structure

Current level: Root

📁 .claude-plugin/
- 📄 plugin.json 499 B
📁 .github/
- 📁 workflows/
  - 📄 sdk-update-check.yml 19.2 KB
📁 agent/
- 📄 mending-agent.ts 3.8 KB
- 📄 mending-prompt.md 2.7 KB
- 📄 monitor.sh 16.5 KB
- 📄 package.json 479 B
- 📄 report-agent.ts 8.5 KB
- 📄 report-prompt.md 5.4 KB
- 📄 research-agent-py.ts 5.4 KB
- 📄 research-agent-ts.ts 4.9 KB
- 📄 research-prompt-py.md 12.1 KB
- 📄 research-prompt-ts.md 11.6 KB
- 📄 research-report-2026-02-15.md 4.3 KB
- 📄 state.json 25.5 KB
- 📄 system-prompt.md 6.0 KB
- 📄 tsconfig.json 257 B
- 📄 update-agent.ts 3.5 KB
- 📄 verify.sh 13.9 KB
📁 reports/
- 📄 .gitkeep 0 B
- 📄 2026-02-09.md 6.7 KB
- 📄 2026-02-12.md 2.7 KB
- 📄 2026-02-13.md 4.8 KB
- 📄 2026-02-14.md 5.0 KB
- 📄 2026-02-15.md 3.2 KB
- 📄 2026-02-16.md 3.6 KB
- 📄 2026-02-17.md 4.8 KB
- 📄 2026-02-18.md 4.5 KB
- 📄 2026-02-19.md 6.0 KB
- 📄 2026-02-20.md 4.8 KB
- 📄 2026-02-21.md 8.2 KB
- 📄 2026-02-22.md 6.8 KB
- 📄 2026-02-23.md 5.2 KB
- 📄 2026-02-26.md 6.0 KB
- 📄 2026-02-27.md 6.1 KB
- 📄 2026-02-28.md 5.9 KB
- 📄 2026-03-01.md 5.6 KB
- 📄 2026-03-02.md 4.5 KB
- 📄 2026-03-06.md 4.5 KB
- 📄 2026-03-07.md 4.6 KB
- 📄 2026-03-08.md 5.0 KB
- 📄 2026-03-09.md 4.0 KB
📁 rules/
- 📄 claude-agent-sdk-py.md 6.2 KB
- 📄 claude-agent-sdk-ts.md 5.5 KB
📁 scripts/
- 📄 check-versions.sh 1.7 KB
- 📄 typecheck-templates.sh 4.1 KB
📁 templates/
- 📁 python/
  - 📄 basic_query.py 906 B
  - 📄 client_conversation.py 2.7 KB
  - 📄 custom_mcp_server.py 1.5 KB
  - 📄 error_handling.py 1.1 KB
  - 📄 hooks_example.py 3.2 KB
  - 📄 multi_agent_workflow.py 3.5 KB
  - 📄 permission_control.py 1.2 KB
  - 📄 pyproject.toml 303 B
  - 📄 query_with_tools.py 950 B
  - 📄 sandbox_config.py 2.4 KB
  - 📄 session_management.py 1.6 KB
  - 📄 structured_output.py 1.7 KB
  - 📄 subagents_orchestration.py 1.1 KB
- 📁 typescript/
  - 📄 basic-query.ts 1.4 KB
  - 📄 custom-mcp-server.ts 2.0 KB
  - 📄 error-handling.ts 2.0 KB
  - 📄 filesystem-settings.ts 1.9 KB
  - 📄 hooks-example.ts 3.3 KB
  - 📄 multi-agent-workflow.ts 3.5 KB
  - 📄 package.json 982 B
  - 📄 permission-control.ts 2.1 KB
  - 📄 query-with-tools.ts 1.4 KB
  - 📄 sandbox-config.ts 2.4 KB
  - 📄 session-management.ts 1.9 KB
  - 📄 structured-output.ts 2.3 KB
  - 📄 subagents-orchestration.ts 2.2 KB
  - 📄 tsconfig.json 536 B
📄 .gitignore 55 B
📄 .nvmrc 3 B
📄 CHANGELOG.md 3.2 KB
📄 README.md 11.2 KB
📄 SKILL-python.md 61.2 KB
📄 SKILL-typescript.md 64.9 KB
📄 SKILL.md 2.9 KB

SKILL.md

---
name: claude-agent-sdk
description: |
  Build autonomous AI agents with Claude Agent SDK.
  TypeScript v0.2.71 | Python v0.1.48.
  Covers: query(), hooks, subagents, MCP, permissions, sandbox,
  structured outputs, and sessions.

  Use when: building AI agents, configuring MCP servers, setting up
  permissions/hooks, using structured outputs, troubleshooting SDK errors,
  or working with subagents.
user-invocable: true
---

# Claude Agent SDK Reference

| | TypeScript | Python |
|---|---|---|
| **Version** | v0.2.71 | v0.1.48 |
| **Package** | `@anthropic-ai/claude-agent-sdk` | `claude-agent-sdk` (PyPI) |
| **Docs** | [TypeScript SDK](https://platform.claude.com/docs/en/agent-sdk/typescript) | [Python SDK](https://platform.claude.com/docs/en/agent-sdk/python) |
| **Repo** | [claude-agent-sdk-typescript](https://github.com/anthropics/claude-agent-sdk-typescript) | [claude-agent-sdk-python](https://github.com/anthropics/claude-agent-sdk-python) |
| **Full reference** | [SKILL-typescript.md](SKILL-typescript.md) | [SKILL-python.md](SKILL-python.md) |

## When you detect the user's language

- Working with `.ts` files, TypeScript imports, or `npm`/`node` → read `SKILL-typescript.md`
- Working with `.py` files, Python imports, or `pip`/`python` → read `SKILL-python.md`
- Ambiguous or multi-language → read both as needed

## Cross-Language Naming Map

| Concept | TypeScript | Python |
|---------|-----------|--------|
| One-shot query | `query(options)` | `query(options)` |
| Stateful client | N/A (query manages state) | `ClaudeSDKClient` |
| Options type | `Options` interface | `ClaudeAgentOptions` dataclass |
| Tool definition | `tool(name, schema, handler)` | `@tool(name, desc, schema)` decorator |
| MCP server factory | `createSdkMcpServer()` | `create_sdk_mcp_server()` |
| Permission callback | `canUseTool` | `can_use_tool` |
| Permission mode | `permissionMode: "..."` | `permission_mode="..."` |
| Hook registration | `hooks: { PreToolUse: [...] }` | `hooks={"PreToolUse": [...]}` |
| System prompt | `systemPrompt` | `system_prompt` |
| Max turns | `maxTurns` | `max_turns` |
| Allowed tools | `allowedTools` | `allowed_tools` |
| MCP servers | `mcpServers` | `mcp_servers` |
| Subagent def | `AgentDefinition` | `AgentDefinition` dataclass |

## Shared Concepts (both languages)

Both SDKs wrap the Claude Code CLI and share these concepts:
- **Hooks**: Pre/PostToolUse, Stop, SubagentStop, Notification, etc.
- **Permissions**: default, acceptEdits, plan, bypassPermissions, etc.
- **MCP Servers**: stdio, HTTP, SSE, SDK (in-process) configurations
- **Subagents**: Delegate tasks to child agents with scoped tools/permissions
- **Structured Outputs**: JSON Schema validation on agent output
- **Sandbox**: Container-based isolation (Docker/Kubernetes)
- **Sessions**: Capture, resume, and fork conversation state

For API details, code examples, options tables, and known issues,
read the language-specific reference file.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

claude-agent-sdk

Directory Structure

SKILL.md

Report

Notice