{
  "path": "/tutorials/claude-agent-sdk-tokenba",
  "reviewedAt": "2026-10-23",
  "version": "@anthropic-ai/claude-agent-sdk 0.3.309 / native CLI2.1.177",
  "status": "blocked-native-sdk-no-valid-result",
  "sourceURLs": [
    "https://code.claude.com/docs/en/agent-sdk/quickstart",
    "https://code.claude.com/docs/en/agent-sdk/overview"
  ],
  "validationScope": "真实Agent SDK0.3.309 query→原生CLI2.1.177；本地第一方登录小请求90秒无result，网关单次小请求exit1，Node源码式错误输出被截断，未恢复有效SDK result或底层HTTP状态。不能认定模型成功、HTTP429或零费用；同批独立CLI确有当前网关分组429，但不能替代本次SDK状态。",
  "bodySteps": [
    "创建独立目录，npm install @anthropic-ai/claude-agent-sdk，并保留package-lock。",
    "读取SDK query官方接口；本题只提交原创17+25计数输入，tools:[]，不授予文件或终端工具。",
    "执行 node run.mjs；保存assistant/result事件与进程退出码。",
    "将本地个人第一方登录实验与提供给第三方用户的产品认证分开；产品需按官方允许方式用独立API凭据。",
    "本次SDK超时，没有有效result，不能展示42作为模型产物。",
    "若SDK异步迭代抛错，先把已收到的assistant/result逐项落盘，再保存短error.message；不要仅在迭代完成后统一打印，避免异常时丢失已收到的事件。本次没有恢复有效result，保留为未通过，不补造答案。"
  ],
  "files": [
    {
      "file": "README.md",
      "bytes": 1470,
      "sha256": "f60df23a29b7b0370400d4fad841b3518127c28e72dcbe290557100c3c7e869d"
    },
    {
      "file": "claude-help.txt",
      "bytes": 15388,
      "sha256": "a9c896f9a7b2d119508b6ab906b8fb5eb25e2f9c26dac2544610903fb69ac8a3"
    },
    {
      "file": "claude-version.txt",
      "bytes": 22,
      "sha256": "df977b261604a77e626a28caba2d36f3cc26f7653b1ed3284bfd175e55451849"
    },
    {
      "file": "execution.json",
      "bytes": 98,
      "sha256": "11e3cf5110619df70b1d36ac3505f31b6312d79f95fd77c6971efd2e452066ec"
    },
    {
      "file": "input.json",
      "bytes": 21,
      "sha256": "895af70cd0327c15bae4ea96be0b6c417de32076c95a45f5359e8db386406ed1"
    },
    {
      "file": "package.json",
      "bytes": 114,
      "sha256": "91302e893f881a7b04ed422aeddf8df2ba311930ad1ff75496f7decf0570cea1"
    },
    {
      "file": "tokenba-execution.json",
      "bytes": 678,
      "sha256": "65373105fd23dffec0a890134f1b93c67c828fb1e074f200c362e8fe6d40478b"
    },
    {
      "file": "recorded-run-tokenba.mjs",
      "bytes": 594,
      "sha256": "79e1811bdf1085cba44964513d9ccd8f81aa2b1f5497418c649724a6f48b946a"
    },
    {
      "file": "recorded-run.mjs",
      "bytes": 709,
      "sha256": "2c368dd4f6dbf6847c2b65ada18a62f19568a12f15483cc221ecb1128b785a95"
    },
    {
      "file": "run-tokenba.mjs",
      "bytes": 570,
      "sha256": "c1b79ba06af7d8437393ba67319c099d728b759e20bf9e2f6c8be5f0f9fbfbc8"
    },
    {
      "file": "run.mjs",
      "bytes": 685,
      "sha256": "e5e47712075b52f36421cf01eaee909a51c0a01685fb94dfa847ffbc069b406f"
    }
  ],
  "privateCredentialsPublished": false,
  "commands": [
    "npm install @anthropic-ai/claude-agent-sdk",
    "node run.mjs"
  ],
  "observations": [
    "真实SDK0.3.309→原生CLI2.1.177，未用自制检查器替代。",
    "最初小输入90秒超时；网关单次尝试exit1，未恢复有效result或HTTP状态。",
    "SDK异常时统一末尾打印会丢事件；本次已保留原始截断stderr和明确失败。"
  ],
  "limits": [
    "不能把同批另一CLI的429当成本次SDK已确认状态。",
    "模型结果和用量未知，没有补造42，没有按超时推断零费用。"
  ],
  "tokenbaTestKeyUsed": true,
  "timeoutInferenceUsage": "未收到服务端结果的Claude请求用量未知，不能按超时推断为零。",
  "gatewayAttemptScope": "仅当前测试Key的Gemini分组；model gemini-2.5-flash；BaseURL HTTPS api.apizt.com。仅认证到该HTTPS域名，未改全局配置，无重投。不能扩成全站/所有分组/所有模型不可用。"
}