Skip to content

docs(sdk): claude-agent-sdk vs codex-sdk deep-dive (closes #18)#19

Open
s2agi wants to merge 1 commit into
mainfrom
docs/sdk-deep-dive
Open

docs(sdk): claude-agent-sdk vs codex-sdk deep-dive (closes #18)#19
s2agi wants to merge 1 commit into
mainfrom
docs/sdk-deep-dive

Conversation

@s2agi
Copy link
Copy Markdown
Contributor

@s2agi s2agi commented May 12, 2026

Why

Closes #18

anet 内置 3 个 runtime 但缺 SDK adapter 系统化对比。runtimes.md 是 user how-to,不够深,contributor 想自己接新 SDK 没参考。

What

  • New docs-site/docs/guide/sdk-deep-dive.md + EN mirror — 11-dim comparison table + each SDK integration notes + how anet wrapper converges differences + how to add new runtime (gemini-cli / qwen-code etc.) using existing pattern.
  • .vitepress/config.ts ZH+EN sidebar adds the new entry.
  • runtimes.md end adds pointer to deep-dive (ZH+EN).

How to verify

cd docs-site && npm run build   # no dead link

Navigate Guide sidebar → click "SDK Deep-dive" → page renders.

Test evidence

npm run build (worktree, against origin/main): build complete in 52.63s. — no dead-link errors.

Checklist

Closes #18

11-dim comparison table covering package versions / API entry / session
semantics / tool registration / streaming / token budget / error handling
/ multi-turn / ANTHROPIC_BASE_URL equivalent / settingSources / breaking
change cadence + anet wrapper code locations.

ZH + EN, sidebar wired, runtimes.md links to deep-dive at the bottom.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[docs] Deep-dive: claude-agent-sdk vs codex-sdk adapter comparison

2 participants