[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"article-claude-sonnet-5-shangshou-bushu-yu-pinggu-zh":3,"article-related-claude-sonnet-5-shangshou-bushu-yu-pinggu-zh":31,"series-tools-9568ce15-1e27-450b-8c62-c6c97a94372d":75},{"id":4,"slug":5,"title":6,"content":7,"summary":8,"source":9,"source_url":10,"author":11,"image_url":12,"cover_image":12,"category":13,"language":14,"translated_content":11,"related_article_id":15,"keywords":16,"key_takeaways":23,"views":27,"created_at":28,"published_at":29,"topic_cluster_id":30},"9568ce15-1e27-450b-8c62-c6c97a94372d","claude-sonnet-5-shangshou-bushu-yu-pinggu-zh","Claude Sonnet 5 上手部署与评估","\u003Cp data-speakable=\"summary\">本指南教你申请、接入并评估 \u003Ca href=\"\u002Ftag\u002Fclaude\">Claude\u003C\u002Fa> Sonnet 5 的开发\u003Ca href=\"\u002Fnews\u002Fevaluation-protocols-fine-tuned-llms-2026-zh\">流程\u003C\u002Fa>。\u003C\u002Fp>\u003Cp>这篇指南适合想把 \u003Ca href=\"\u002Ftag\u002Fanthropic\">Anthropic\u003C\u002Fa> 的 Claude Sonnet 5 接到产品、脚本或 Claude \u003Ca href=\"\u002Fnews\u002Fcodex-chat-to-delivery-ai-coding-zh\">Code\u003C\u002Fa> 工作流里的开发者。跟着做完，你会拿到一个可调用的 \u003Ca href=\"\u002Ftag\u002Fapi\">API\u003C\u002Fa> 环境、一段可运行的示例代码，以及一套能判断它是否适合你项目的检查方法。\u003C\u002Fp>\u003Cp>文中会顺带提醒你在国内使用时可能遇到的访问、账号和隐性成本问题，方便你在正式迁移前先做一次小规模验证。\u003C\u002Fp>\u003Ch2>开始之前\u003C\u002Fh2>\u003Cul>\u003Cli>Anthropic 账号，已完成邮箱验证；文档见 \u003Ca href=\"https:\u002F\u002Fdocs.anthropic.com\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">Anthropic Docs\u003C\u002Fa>，仓库见 \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fanthropic-sdk-typescript\" target=\"_blank\" rel=\"noopener noreferrer\">Anthropic GitHub\u003C\u002Fa>\u003C\u002Fli>\u003Cli>Anthropic API key，且已开通计费或可用额度\u003C\u002Fli>\u003Cli>Node 20+ 或 Python 3.10+\u003C\u002Fli>\u003Cli>稳定的网络访问环境，能连到 Anthropic API 端点\u003C\u002Fli>\u003Cli>一个终端工具，例如 macOS Terminal、iTerm2、Windows PowerShell\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>Step 1: 创建 Anthropic API 凭据\u003C\u002Fh2>\u003Cp>目标是拿到一个可用于程序调用的 API key，并确认你的账号已经具备发起请求的权限。没有这一步，后面的代码只能停留在示例层面。\u003C\u002Fp>\n\u003Cfigure class=\"my-6\">\u003Cimg src=\"https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1783125163927-v143.png\" alt=\"Claude Sonnet 5 上手部署与评估\" class=\"rounded-xl w-full\" loading=\"lazy\" \u002F>\u003C\u002Ffigure>\n\u003Cp>登录 Anthropic 控制台，进入 API keys 页面，新建一个密钥后立刻保存到安全位置。不要把 key 直接写进代码仓库，建议先放到本地环境变量里。\u003C\u002Fp>\u003Cpre>\u003Ccode>export ANTHROPIC_API_KEY=\"your_api_key_here\"\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>验证方式是打开新终端执行 \u003Ccode>echo $ANTHROPIC_API_KEY\u003C\u002Fcode>，你应该能看到刚才设置的值，说明环境变量已经生效。\u003C\u002Fp>\u003Ch2>Step 2: 安装 Claude SDK\u003C\u002Fh2>\u003Cp>目标是让你的本地项目具备调用 Claude Sonnet 5 的基础能力。这里以 Node.js 为例，适合大多数前端、后端和脚本项目。\u003C\u002Fp>\n\u003Cfigure class=\"my-6\">\u003Cimg src=\"https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1783125161344-nfg7.png\" alt=\"Claude Sonnet 5 上手部署与评估\" class=\"rounded-xl w-full\" loading=\"lazy\" \u002F>\u003C\u002Ffigure>\n\u003Cp>先创建一个新目录并安装官方 SDK，然后确认依赖能正常解析。\u003C\u002Fp>\u003Cpre>\u003Ccode>mkdir sonnet5-demo\ncd sonnet5-demo\nnpm init -y\nnpm install @anthropic-ai\u002Fsdk\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>验证方式是查看 \u003Ccode>package.json\u003C\u002Fcode> 和 \u003Ccode>node_modules\u003C\u002Fcode> 是否生成成功。你应该还能在终端里看到安装完成且没有报错。\u003C\u002Fp>\u003Ch2>Step 3: 调用 Sonnet 5 示例请求\u003C\u002Fh2>\u003Cp>目标是发出第一条真实请求，确认模型、密钥和网络链路都工作正常。这个步骤会直接告诉你能不能把 Sonnet 5 接进现有应用。\u003C\u002Fp>\u003Cp>创建一个 \u003Ccode>index.js\u003C\u002Fcode>，写入最小可运行代码并指定你账户可用的 Claude Sonnet 5 模型名。\u003C\u002Fp>\u003Cpre>\u003Ccode>import Anthropic from \"@anthropic-ai\u002Fsdk\";\n\nconst client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });\n\nconst msg = await client.messages.create({\n  model: \"claude-sonnet-5\",\n  max_tokens: 200,\n  messages: [\n    { role: \"user\", content: \"用一句话解释 Claude Sonnet 5 的适用场景。\" }\n  ]\n});\n\nconsole.log(msg.content[0].text);\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>验证方式是运行 \u003Ccode>node index.js\u003C\u002Fcode>，你应该看到一段自然语言回复，而不是认证错误、模型不存在错误或网络超时。\u003C\u002Fp>\u003Ch2>Step 4: 对比你的任务负载\u003C\u002Fh2>\u003Cp>目标是判断 Sonnet 5 是否真的适合你的业务，而不是只看一次演示输出。建议用你真实场景里的三类任务做对比，例如代码补全、长文总结和结构化抽取。\u003C\u002Fp>\u003Cp>把同一组提示词分别发给你当前在用的模型和 Sonnet 5，记录输出质量、响应时间和失败率。若你在国内使用 \u003Ca href=\"\u002Ftag\u002Fclaude-code\">Claude Code\u003C\u002Fa>，还要额外记录\u003Ca href=\"\u002Fnews\u002Fornith-1-agent-coding-server-template-zh\">代理\u003C\u002Fa>、转发或中间服务带来的延迟与维护成本。\u003C\u002Fp>\u003Cp>验证方式是得到一份简单的测试表，里面至少包含任务名、结果质量、平均响应时间和人工满意度。你应该能明确说出它在哪些任务上更强，哪些任务上并没有明显优势。\u003C\u002Fp>\u003Ch2>Step 5: 固化生产配置\u003C\u002Fh2>\u003Cp>目标是把验证过的接入方式变成可维护的生产配置，而不是只停留在本地脚本。你需要把模型名、超时、重试和日志策略都写进配置层。\u003C\u002Fp>\u003Cp>建议把 API key 交给密钥管理系统，把模型名放进环境变量，把请求封装成一层服务函数，方便后续切换模型或降级。\u003C\u002Fp>\u003Cpre>\u003Ccode>export ANTHROPIC_MODEL=\"claude-sonnet-5\"\nexport ANTHROPIC_TIMEOUT_MS=\"30000\"\nexport ANTHROPIC_MAX_RETRIES=\"2\"\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>验证方式是重启服务后再次发起请求，确认配置仍然生效，并且日志里能看到模型名、耗时和错误码。\u003C\u002Fp>\u003Ctable>\u003Cthead>\u003Ctr>\u003Cth>指標\u003C\u002Fth>\u003Cth>基準／優化前\u003C\u002Fth>\u003Cth>結果／優化後\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Ctd>接入方式\u003C\u002Ftd>\u003Ctd>手工测试脚本\u003C\u002Ftd>\u003Ctd>环境变量 + 服务封装\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>故障恢复\u003C\u002Ftd>\u003Ctd>每次改动都要手动调整\u003C\u002Ftd>\u003Ctd>可通过配置快速切换模型\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>维护成本\u003C\u002Ftd>\u003Ctd>高，依赖零散\u003C\u002Ftd>\u003Ctd>低，统一管理 key 和超时\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003Ch2>常見錯誤\u003C\u002Fh2>\u003Cul>\u003Cli>把模型名写错。修复方法是先在 Anthropic 文档里核对当前可用的模型标识，再把它放进配置而不是硬编码。\u003C\u002Fli>\u003Cli>把 API key 提交到仓库。修复方法是改用环境变量或密钥管理服务，并立即轮换已泄露的密钥。\u003C\u002Fli>\u003Cli>只在单次演示里判断效果。修复方法是用你自己的真实任务做小样本对比，至少覆盖代码、总结和抽取三类场景。\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>接下來可以看什麼\u003C\u002Fh2>\u003Cp>下一步可以把这套接入流程扩展成自动化评测脚本、提示词模板库和模型路由策略，这样你就能更系统地决定 Sonnet 5 是否进入主生产链路。\u003C\u002Fp>","本指南教你申请、接入并评估 Claude Sonnet 5 的开发流程。","www.zhihu.com","https:\u002F\u002Fwww.zhihu.com\u002Fquestion\u002F2055567821904547893",null,"https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1783125163927-v143.png","tools","zh","f8c5ce9b-047c-42ee-bc74-66efa81c4177",[17,18,19,20,21,22],"Anthropic","Claude Sonnet 5","API key","Node.js 20+","SDK","评估",[24,25,26],"先准备 Anthropic 账号、API key 和 Node 20+ 或 Python 3.10+ 环境，再开始接入。","用官方 SDK 跑通最小请求，先确认网络、鉴权和模型名都正确。","把真实业务任务做小样本对比，最后再把配置、超时和重试固化到生产层。",0,"2026-07-04T00:32:19.271862+00:00","2026-07-04T00:32:19.261+00:00","13637d9f-b9a5-40ff-9d37-af2ab7a697f1",{"tags":32,"relatedLang":35,"relatedPosts":38},[33],{"name":17,"slug":34},"anthropic",{"id":15,"slug":36,"title":6,"language":37},"claude-sonnet-5-shangshou-bushu-yu-pinggu-en","en",[39,45,51,57,63,69],{"id":40,"slug":41,"title":42,"cover_image":43,"image_url":43,"created_at":44,"category":13},"5358fb05-efb5-4238-abc5-fb3933da13e7","gpu-vram-needed-llm-fine-tuning-2026-zh","2026 年 LLM 微調要多少 VRAM","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1783128777725-3n1p.png","2026-07-04T01:32:33.595421+00:00",{"id":46,"slug":47,"title":48,"cover_image":49,"image_url":49,"created_at":50,"category":13},"5de8c9bb-60f5-40f5-93a1-23f524010620","codex-chat-to-delivery-ai-coding-zh","Codex把聊天改成交付","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1783087395827-uztj.png","2026-07-03T14:02:50.287547+00:00",{"id":52,"slug":53,"title":54,"cover_image":55,"image_url":55,"created_at":56,"category":13},"51914b0b-b516-4c9c-818d-ac4ae593d200","mistral-ocr-4-prices-document-ai-enterprise-zh","Mistral OCR 4 把文件 AI 變成採購題","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1783022578850-0p9l.png","2026-07-02T20:02:34.687933+00:00",{"id":58,"slug":59,"title":60,"cover_image":61,"image_url":61,"created_at":62,"category":13},"c518a84d-7aef-4640-8a6b-1fcdeedc0800","cloudflare-policy-turns-crawlers-into-paid-access-zh","Cloudflare 把爬蟲變成付費入口","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782981207350-jf81.png","2026-07-02T08:32:57.692933+00:00",{"id":64,"slug":65,"title":66,"cover_image":67,"image_url":67,"created_at":68,"category":13},"3de93c9c-1714-45c0-a972-eef8240f9bf4","visual-studio-copilot-ide-workflow-zh","Visual Studio 把 Copilot 變工作流","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782957797914-x775.png","2026-07-02T02:02:50.951099+00:00",{"id":70,"slug":71,"title":72,"cover_image":73,"image_url":73,"created_at":74,"category":13},"2ffaf5e5-e155-47dd-80cd-af62c3705516","databricks-ai-gateway-inference-tables-served-models-zh","Databricks 為模型服務加上 AI Gateway 推論表","https:\u002F\u002Fxxdpdyhzhpamafnrdkyq.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fcovers\u002Finline-1782939770301-2a9e.png","2026-07-01T21:02:20.660434+00:00",[76,81,86,91,96,101,106,111,116,121],{"id":77,"slug":78,"title":79,"created_at":80},"855cd52f-6fab-46cc-a7c1-42195e8a0de4","surepath-real-time-mcp-policy-controls-zh","SurePath 推出即時 MCP 政策控管","2026-03-26T07:57:40.77233+00:00",{"id":82,"slug":83,"title":84,"created_at":85},"9b19ab54-edef-4dbd-9ce4-a51e4bae4ebb","mcp-in-2026-the-ai-tool-layer-teams-use-zh","2026 年 MCP：團隊真的在用的 AI 工具層","2026-03-26T08:01:46.589694+00:00",{"id":87,"slug":88,"title":89,"created_at":90},"af9c46c3-7a28-410b-9f04-32b3de30a68c","prompting-in-2026-what-actually-works-zh","2026 提示工程，真正有用的是什麼","2026-03-26T08:08:12.453028+00:00",{"id":92,"slug":93,"title":94,"created_at":95},"05553086-6ed0-4758-81fd-6cab24b575e0","garry-tan-open-sources-claude-code-toolkit-zh","Garry Tan 開源 Claude Code 工具包","2026-03-26T08:26:20.068737+00:00",{"id":97,"slug":98,"title":99,"created_at":100},"042a73a2-18a2-433d-9e8f-9802b9559aac","github-ai-projects-to-watch-in-2026-zh","2026 必看 20 個 GitHub AI 專案","2026-03-26T08:28:09.619964+00:00",{"id":102,"slug":103,"title":104,"created_at":105},"a5f94120-ac0d-4483-9a8b-63590071ac6a","claude-code-vs-cursor-2026-zh","Claude Code 與 Cursor 深度對比：202…","2026-03-26T13:27:14.279193+00:00",{"id":107,"slug":108,"title":109,"created_at":110},"0975afa1-e0c7-4130-a20d-d890eaed995e","practical-github-guide-learning-ml-2026-zh","2026 機器學習入門 GitHub 實用指南","2026-03-27T01:16:49.712576+00:00",{"id":112,"slug":113,"title":114,"created_at":115},"bfdb467a-290f-4a80-b3a9-6f081afb6dff","aiml-2026-student-ai-ml-lab-repo-review-zh","AIML-2026：像課綱的學生實驗 Repo","2026-03-27T01:21:51.467798+00:00",{"id":117,"slug":118,"title":119,"created_at":120},"80cabc3e-09fc-4ff5-8f07-b8d68f5ae545","ai-trending-github-repos-and-research-feeds-zh","AI Trending：把 AI 資源收成一張表","2026-03-27T01:31:35.262183+00:00",{"id":122,"slug":123,"title":124,"created_at":125},"3ce6e6e2-bac5-463e-9f8d-45caabcc61f7","awesome-ai-for-science-research-tools-map-zh","AI 科研工具清單，開始像地圖了","2026-03-27T01:46:50.521945+00:00"]