anthropics/claude-agent-sdk-python

在 GitHub 查看

星标: 8.1k
派生: 1.3k
开放的新手 issue: 6
已索引 issue: 207
平均合并: 12 小时 14 分钟
30 天内合并 PR: 8

主要语言: Python
许可证: MIT
最近 GitHub push: 2026年9月19日
最近索引: 2026年9月14日
贡献指南: 没有贡献指南
行为准则: 没有行为准则
新手标签: good first issue help wanted

适合新手全部

未关闭全部

PermissionUpdate.to_dict() sends "ruleContent": null; the CLI silently drops the update, so "always allow" never sticks for content-less rules 未关闭

难度 2/5 1-3 小时新手友好度 74/100

anthropics/claude-agent-sdk-python#1308 · 2026年9月24日创建
Control-request failures raise a bare Exception rather than a ClaudeSDKError subclass 未关闭

难度 3/5 1-2 天新手友好度 74/100

anthropics/claude-agent-sdk-python#1304 · 1 条评论 · 2026年9月24日创建
thinking={type: enabled, budget_tokens: N} is sent as the same --max-thinking-tokens flag as the deprecated max_thinking_tokens 未关闭

难度 4/5 3-5 天新手友好度 48/100

anthropics/claude-agent-sdk-python#1303 · 2026年9月24日创建
create_sdk_mcp_server and tool() cannot set the server and tool metadata the TypeScript SDK sends (instructions, alwaysLoad, searchHint) 未关闭

难度 3/5 1-2 天新手友好度 72/100

anthropics/claude-agent-sdk-python#1302 · 2026年9月24日创建
HookEvent names 10 of the CLI's hook events; SessionStartHookSpecificOutput is exported for an event the literal cannot register 未关闭

难度 3/5 1-2 天新手友好度 74/100

anthropics/claude-agent-sdk-python#1301 · 2026年9月24日创建
list_sessions has no includeProgrammatic filter, get_session_messages has no includeSystemMessages, and SessionMessage.type cannot be 'system' 未关闭

难度 3/5 1-2 天新手友好度 75/100

anthropics/claude-agent-sdk-python#1300 · 2026年9月24日创建
rewind_files, interrupt, and get_context_usage discard response fields and options the TypeScript Query exposes 未关闭

难度 3/5 1-2 天新手友好度 74/100

anthropics/claude-agent-sdk-python#1299 · 2026年9月24日创建
sandbox settings are passed through without the failIfUnavailable default the TypeScript SDK applies 未关闭

难度 2/5 1-3 小时新手友好度 78/100

anthropics/claude-agent-sdk-python#1298 · 1 条评论 · 2026年9月24日创建
SdkPluginConfig.skipMcpDiscovery is accepted by the type and ignored by the transport 未关闭

难度 2/5 1-3 小时新手友好度 82/100

anthropics/claude-agent-sdk-python#1297 · 1 条评论 · 2026年9月24日创建
elicitation and request_user_dialog control requests are answered with an error; supportedDialogKinds and perTaskStopAffordance are never sent 未关闭

难度 4/5 3-5 天新手友好度 67/100

anthropics/claude-agent-sdk-python#1296 · 2026年9月24日创建
can_use_tool: the permission request's MCP provenance and decision fields never reach the callback, and the result cannot carry decisionClassification or toolUseID 未关闭

难度 4/5 3-5 天新手友好度 68/100

anthropics/claude-agent-sdk-python#1295 · 2026年9月24日创建
parse_message returns None for five top-level frame types (tool_progress, tool_use_summary, auth_status, active_goal, prompt_suggestion) 未关闭

难度 3/5 1-2 天新手友好度 74/100

anthropics/claude-agent-sdk-python#1294 · 2026年9月24日创建
Resumed and forked sessions never re-announce a skill whose description changed (announcement keyed on name only) 未关闭

难度 4/5 3-5 天新手友好度 52/100

anthropics/claude-agent-sdk-python#1292 · 2026年9月24日创建
No released SDK supports claude-opus-5-5: newest wheel (0.2.157) bundles CLI 2.1.277, model requires 2.1.280+ 未关闭

bug

难度 4/5 3-5 天新手友好度 42/100

anthropics/claude-agent-sdk-python#1281 · 9 个 reaction · 2026年9月22日创建
CI: E2E jobs fail on main with API 400 permission-mode attestation errors 未关闭

bug

难度 4/5 3-5 天新手友好度 52/100

anthropics/claude-agent-sdk-python#1280 · 1 条评论 · 1 个 reaction · 2026年9月22日创建
parse_message silently drops image content blocks from user messages 未关闭

bug

难度 3/5 1-2 天新手友好度 25/100

anthropics/claude-agent-sdk-python#1275 · 1 条评论 · 2026年9月19日创建
Claude Code CLI: --max-budget-usd 未关闭

bug

难度 4/5 3-5 天新手友好度 48/100

anthropics/claude-agent-sdk-python#1273 · 2026年9月19日创建
Python SDK parity: expose user-message attribution and queued-turn fields 未关闭

enhancement

难度 3/5 1-2 天新手友好度 74/100

anthropics/claude-agent-sdk-python#1270 · 2026年9月17日创建
tests/test_example_postgres_session_store.py: sync tests depend on async fixtures, so the module errors at setup on pytest 9 未关闭

bug

难度 2/5 1-3 小时新手友好度 76/100

anthropics/claude-agent-sdk-python#1264 · 2026年9月14日创建
`allowed_tools=None` raises `TypeError` deep in the transport instead of being treated as unset 未关闭

bug

难度 3/5 1-2 天新手友好度 35/100

anthropics/claude-agent-sdk-python#1255 · 2026年9月9日创建
Bedrock logs are not capturing trace info even when requests are blocked by the configured Guardrail. 未关闭

bug

难度 4/5 3-5 天新手友好度 45/100

anthropics/claude-agent-sdk-python#1252 · 2026年9月7日创建
Use of SDK is governed by Anthropic's Commercial terms ? but it also says MIT license in github. 未关闭

documentation duplicate question

难度 4/5 3-5 天新手友好度 35/100

anthropics/claude-agent-sdk-python#1245 · 1 条评论 · 2026年9月2日创建
Effort fallback (xhigh -> high off Opus 4.7) is silent and unobservable: expose effective effort or a strict mode 未关闭

enhancement

难度 5/5 一周以上新手友好度 35/100

anthropics/claude-agent-sdk-python#1244 · 1 条评论 · 2026年9月1日创建
create_sdk_mcp_server tools cannot opt into strict tool use: tools/list reconstruction drops the field 未关闭

enhancement

难度 3/5 1-2 天新手友好度 72/100

anthropics/claude-agent-sdk-python#1243 · 4 条评论 · 2026年9月1日创建
Multi-turn headless resume falls back to the system+tools cache floor past ~82k tokens (CLI 2.1.228+, Bedrock) — same fingerprint as #974 / #1120 未关闭

bug

难度 5/5 一周以上新手友好度 35/100

anthropics/claude-agent-sdk-python#1241 · 2026年9月1日创建
Claude Agent SDK import hangs under `tsx watch` + `concurrently` on Windows 未关闭

invalid question

难度 4/5 3-5 天新手友好度 45/100

anthropics/claude-agent-sdk-python#1239 · 2026年8月30日创建
Example: use HOL Guard from PreToolUse for Bash command safety 未关闭

documentation enhancement

难度 4/5 3-5 天新手友好度 55/100

anthropics/claude-agent-sdk-python#1235 · 2026年8月25日创建
Bug: claude-agent-sdk 0.2.144 is a partial publish 未关闭

bug

难度 4/5 3-5 天新手友好度 42/100

anthropics/claude-agent-sdk-python#1234 · 2 条评论 · 2026年8月24日创建
to_openeval()/from_openeval(): portable eval dataset conversion for ResultMessage / AssistantMessage 未关闭

enhancement

难度 5/5 一周以上新手友好度 35/100

anthropics/claude-agent-sdk-python#1231 · 2026年8月23日创建
SDK MCP tools unavailable when resuming with empty streaming input (regression in 0.2.140) 未关闭

bug

难度 4/5 3-5 天新手友好度 48/100

anthropics/claude-agent-sdk-python#1226 · 1 条评论 · 2026年8月21日创建
Claude Code SDK permission system is a complete mess 未关闭

documentation enhancement

难度 5/5 一周以上新手友好度 32/100

anthropics/claude-agent-sdk-python#1220 · 1 条评论 · 2026年8月17日创建
A single JSONL record larger than the 64 KiB lite window silently drops first_prompt and cwd, and makes list_sessions_from_store() disagree with itself 未关闭

bug

难度 4/5 3-5 天新手友好度 52/100

anthropics/claude-agent-sdk-python#1200 · 2 条评论 · 2026年8月11日创建
rename_session() and tag_session() are silently lost once the session grows: list_sessions() only scans the first and last 64 KiB 未关闭

bug

难度 5/5 一周以上新手友好度 42/100

anthropics/claude-agent-sdk-python#1191 · 2 条评论 · 2026年8月11日创建
stdin closes after a delegated task settles before Result, dropping a later continuation control response 未关闭

难度 4/5 3-5 天新手友好度 54/100

anthropics/claude-agent-sdk-python#1190 · 2 条评论 · 1 个 reaction · 2026年8月7日创建
Bedrock: AU regions (ap-southeast-2/4) only probe & suggest `apac.*` profiles — no `au.*` branch, steering AU data-residency users to the wrong profile family 未关闭

难度 3/5 1-2 天新手友好度 68/100

anthropics/claude-agent-sdk-python#1189 · 2026年8月7日创建
claude-sonnet-5 overreporting cost 未关闭

难度 3/5 1-2 天新手友好度 64/100

anthropics/claude-agent-sdk-python#1182 · 2026年8月5日创建
query() documentation incorrectly promises send-all-then-receive streaming semantics 未关闭

难度 3/5 1-2 天新手友好度 72/100

anthropics/claude-agent-sdk-python#1169 · 2026年8月3日创建
InMemorySessionStore composite string keys can collide across logical sessions 未关闭

难度 3/5 1-2 天新手友好度 68/100

anthropics/claude-agent-sdk-python#1168 · 3 条评论 · 2026年8月3日创建
list_sessions_from_store exposes invalid session IDs returned by adapters 未关闭

难度 3/5 1-2 天新手友好度 68/100

anthropics/claude-agent-sdk-python#1167 · 2026年8月3日创建
MCP tool schema generation loses Optional, Literal, mapping, and unsupported-type semantics 未关闭

难度 3/5 1-2 天新手友好度 66/100

anthropics/claude-agent-sdk-python#1166 · 2026年8月3日创建
max_buffer_size and import byte limits count characters instead of UTF-8 bytes 未关闭

难度 4/5 3-5 天新手友好度 68/100

anthropics/claude-agent-sdk-python#1165 · 1 条评论 · 2026年8月3日创建
delete_session can report success while leaving subagent transcripts behind 未关闭

难度 2/5 半天新手友好度 78/100

anthropics/claude-agent-sdk-python#1164 · 2026年8月3日创建
SessionStore summary fast path paginates before filtering and can skip sessions 未关闭

难度 4/5 3-5 天新手友好度 68/100

anthropics/claude-agent-sdk-python#1163 · 2026年8月3日创建
CLI version check timeout can hang indefinitely while waiting for termination 未关闭

难度 3/5 1-2 天新手友好度 72/100

anthropics/claude-agent-sdk-python#1162 · 1 条评论 · 2026年8月3日创建
ClaudeSDKClient can leak transports on double connect and pre-Query failures 未关闭

难度 4/5 3-5 天新手友好度 52/100

anthropics/claude-agent-sdk-python#1161 · 2026年8月3日创建
Long project paths can resolve to the wrong session directory 未关闭

难度 4/5 3-5 天新手友好度 55/100

anthropics/claude-agent-sdk-python#1160 · 2026年8月3日创建
get_context_usage() makes uncached API calls that are invisible to the message stream 未关闭

难度 4/5 3-5 天新手友好度 48/100

anthropics/claude-agent-sdk-python#1159 · 1 条评论 · 2026年8月3日创建
query() returns is_error with subtype="success" and api_error_status=400; --print succeeds with identical binary and credentials 未关闭

难度 4/5 3-5 天新手友好度 35/100

anthropics/claude-agent-sdk-python#1156 · 2 条评论 · 2026年8月2日创建
Ollama models emit tool calls as plain text instead of ToolUseBlock when routed through the SDK/CLI (works fine against Ollama's raw API) 未关闭

难度 4/5 3-5 天新手友好度 45/100

anthropics/claude-agent-sdk-python#1154 · 2026年7月31日创建
ClaudeSDKClient.interrupt() is ignored silently when called immediately after query() 未关闭

难度 4/5 3-5 天新手友好度 48/100

anthropics/claude-agent-sdk-python#1153 · 2 条评论 · 1 个 reaction · 2026年7月30日创建

只显示最新的 100 条

这个页面只列出最近收录的部分。完整清单在高级筛选里，可以按语言、难度和预计耗时筛选。

前往高级筛选

精选适合新手参与的 GitHub issue 摘要。