anthropics/claude-agent-sdk-python

Stars: 8.1k
Forks: 1.3k
Open beginner issues: 0
Indexed issues: 188
Avg merge: 2d 31m
Merged PRs (30d): 1

Dominant language: Python
License: MIT
Last GitHub push: Sep 12, 2026
Latest indexed: Sep 14, 2026
Contributing guide: No contributing guide
Code of conduct: No code of conduct
Beginner labels: good first issue help wanted

Open All

188 open issues indexed

[Bug] TaskNotificationMessage fires while subagent is still running (premature, not cross-turn leak) Open

anthropics/claude-agent-sdk-python#882 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Windows: SDK should fall back to --system-prompt-file when cmdline overflows (follow-up to #501) Open

anthropics/claude-agent-sdk-python#883 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Query.close(): transport.close() not guarded by try/finally — can be skipped if earlier cleanup raises Open

anthropics/claude-agent-sdk-python#886 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Querying model provider Open

anthropics/claude-agent-sdk-python#888 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Query.close() does not reap MCP subprocess grandchildren Open

anthropics/claude-agent-sdk-python#889 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
subprocess CLI rejects list-form system_prompt (Anthropic API supports it) Open

bug enhancement good first issue

anthropics/claude-agent-sdk-python#899 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Tolaria and Claude Code Open

bug question

anthropics/claude-agent-sdk-python#901 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
MCP server tools fail to register on Windows: server config visible to agent but tools return "No such tool available" Open

bug

anthropics/claude-agent-sdk-python#902 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
fork_session() write is non-atomic; crash mid-write leaves orphan transcript Open

anthropics/claude-agent-sdk-python#906 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
_bundled/claude v2.1.121 protocol-incompatible in container env (silent timeout on control_request:initialize) Open

bug

anthropics/claude-agent-sdk-python#922 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
ClaudeSDKClient Cannot Be Shared Across Async Runtime Contexts Open

bug duplicate

anthropics/claude-agent-sdk-python#925 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Bundled `claude` binary hangs when stdout is not a TTY (pipe / file / launchd / cron / Docker) Open

bug

anthropics/claude-agent-sdk-python#926 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
discussion: ClaudeAgentOptions.env only supports implicit parent-env inheritance with no documented isolated environment mode Open

documentation enhancement question

anthropics/claude-agent-sdk-python#934 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Python Agent SDK docs omit public options/types still present in `claude-agent-sdk==0.1.80` Open

documentation

anthropics/claude-agent-sdk-python#941 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
No way to access the resolved system prompt (from CLAUDE.md and similar files) via the Python SDK Open

enhancement question

anthropics/claude-agent-sdk-python#948 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
MessageParseError: missing signature in thinking block with claude-agent-sdk 0.1.79 and Anthropic-compatible backend Open

bug

anthropics/claude-agent-sdk-python#949 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Bundled CLI silently drops inbound TRACEPARENT on 2nd+ query() call when ~/.claude/ has state from a prior run Open

bug

anthropics/claude-agent-sdk-python#952 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Bug: Autocompact is thrashing due to rapid context refill Open

bug

anthropics/claude-agent-sdk-python#958 · 4 comments · 4 reactions · 0 assignees · Indexed Sep 14, 2026
Expose cache_control TTL as a configurable switch (currently hardcoded to 1h) Open

enhancement

anthropics/claude-agent-sdk-python#964 · 5 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
[Docs] Surface dev-deps install + test/lint commands in README (or add CONTRIBUTING.md) Open

documentation enhancement good first issue

anthropics/claude-agent-sdk-python#966 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Agent SDK: It is recommended to support dynamic tool selection or a vector screening mechanism Open

enhancement

anthropics/claude-agent-sdk-python#969 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
License discrepancy between README.md and LICENSE.md Open

documentation

anthropics/claude-agent-sdk-python#971 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
skills="all" does not add "Skill" to tools Open

bug documentation

anthropics/claude-agent-sdk-python#977 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Support tool aliases similar to the TypeScript SDK's Options.toolAliases Open

enhancement

anthropics/claude-agent-sdk-python#980 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
[FEATURE] : Add set_effort and set_thinking to ClaudeSDKClient Open

enhancement

anthropics/claude-agent-sdk-python#981 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Query.close() raises 'Attempted to exit cancel scope in a different task' during async-generator teardown Open

bug

anthropics/claude-agent-sdk-python#983 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
AgentBoundary v0.1 conformance evaluation of Claude Agent SDK permission_policy — pre-publication review Open

question

anthropics/claude-agent-sdk-python#986 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
[Feature Request] Streaming per-subagent token usage events during execution Open

enhancement

anthropics/claude-agent-sdk-python#987 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
[BUG] --include-hook-events flag not emitting hook lifecycle events to message stream Open

bug

anthropics/claude-agent-sdk-python#991 · 2 comments · 1 reaction · 0 assignees · Indexed Sep 14, 2026
Deferred tool resume executes pending tool without re-running Python SDK callback PreToolUse hook Open

bug

anthropics/claude-agent-sdk-python#993 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Agent not effective Open

bug

anthropics/claude-agent-sdk-python#994 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
[FEATURE] Native Bedrock Guardrail body wrapping for InvokeModel / InvokeModelWithResponseStream Open

enhancement

anthropics/claude-agent-sdk-python#999 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Expose subprocess PID as public property on `SubprocessCLITransport` Open

enhancement

anthropics/claude-agent-sdk-python#1001 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
[Feature] Background Agents stream back through stream-json with ownership information Open

enhancement

anthropics/claude-agent-sdk-python#1002 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Structured output tool has a required response. Open

enhancement

anthropics/claude-agent-sdk-python#1013 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
feat: governance hook integration for deterministic tool call authorization (TealTiger) Open

enhancement

anthropics/claude-agent-sdk-python#1022 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
parse_message silently drops newer CLI wire fields (ttft_ms, terminal_reason, stop_details, …) with no escape hatch Open

bug enhancement

anthropics/claude-agent-sdk-python#1026 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Background processes reaped at turn boundary; no re-ping when long-running work completes Open

enhancement

anthropics/claude-agent-sdk-python#1030 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
OTel log events from bundled CLI have empty trace_id/span_id (upstream: claude-code#63074) Open

bug

anthropics/claude-agent-sdk-python#1034 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 13, 2026
Feature request: `clear()` and runtime `resume` for warm subprocess reuse Open

enhancement

anthropics/claude-agent-sdk-python#1035 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 13, 2026
some suggestions Open

enhancement

anthropics/claude-agent-sdk-python#1057 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 13, 2026
PreToolUse "defer" does not end the query Open

bug

anthropics/claude-agent-sdk-python#1060 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 13, 2026
Streaming is required for operations that may take longer than 10 minutes Open

bug

anthropics/claude-agent-sdk-python#1065 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 13, 2026
Memory is not loaded automatically Open

question

anthropics/claude-agent-sdk-python#1066 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 13, 2026
Vertex/Bedrock: empty ThinkingBlock.thinking on Opus 4.8/4.7 — bundled CLI drops thinking.display (post-#831, root cause anthropics/claude-code#71599) Open

bug documentation

anthropics/claude-agent-sdk-python#1068 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 13, 2026
Release new versions - CI pipeline failing Open

bug

anthropics/claude-agent-sdk-python#1079 · 2 comments · 1 reaction · 0 assignees · Indexed Sep 13, 2026
Pending outgoing control requests (interrupt, set_permission_mode, etc.) hang for the full 60s timeout after close()/disconnect() instead of failing fast Open

bug

anthropics/claude-agent-sdk-python#1094 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 13, 2026
system_prompt over 131,071 bytes dies with 'Argument list too long' before any API request Open

bug documentation enhancement good first issue

anthropics/claude-agent-sdk-python#1096 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 13, 2026
Exception in the prompt AsyncIterable is swallowed at debug level and query() hangs forever Open

bug

anthropics/claude-agent-sdk-python#1108 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 13, 2026
query() stream hangs forever (never raises) when the CLI process dies mid-run Open

bug

anthropics/claude-agent-sdk-python#1110 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 13, 2026

A short digest of beginner-friendly GitHub issues.