Claude Sonnet 5 上手部署与评估

本指南教你申请、接入并评估 Claude Sonnet 5 的开发流程。

这篇指南适合想把 Anthropic 的 Claude Sonnet 5 接到产品、脚本或 Claude Code 工作流里的开发者。跟着做完，你会拿到一个可调用的 API 环境、一段可运行的示例代码，以及一套能判断它是否适合你项目的检查方法。

文中会顺带提醒你在国内使用时可能遇到的访问、账号和隐性成本问题，方便你在正式迁移前先做一次小规模验证。

开始之前

• Anthropic 账号，已完成邮箱验证；文档见 Anthropic Docs，仓库见 Anthropic GitHub
• Anthropic API key，且已开通计费或可用额度
• Node 20+ 或 Python 3.10+
• 稳定的网络访问环境，能连到 Anthropic API 端点
• 一个终端工具，例如 macOS Terminal、iTerm2、Windows PowerShell

Step 1: 创建 Anthropic API 凭据

目标是拿到一个可用于程序调用的 API key，并确认你的账号已经具备发起请求的权限。没有这一步，后面的代码只能停留在示例层面。

登录 Anthropic 控制台，进入 API keys 页面，新建一个密钥后立刻保存到安全位置。不要把 key 直接写进代码仓库，建议先放到本地环境变量里。

export ANTHROPIC_API_KEY="your_api_key_here"

验证方式是打开新终端执行 echo $ANTHROPIC_API_KEY，你应该能看到刚才设置的值，说明环境变量已经生效。

Step 2: 安装 Claude SDK

目标是让你的本地项目具备调用 Claude Sonnet 5 的基础能力。这里以 Node.js 为例，适合大多数前端、后端和脚本项目。

先创建一个新目录并安装官方 SDK，然后确认依赖能正常解析。

mkdir sonnet5-demo
cd sonnet5-demo
npm init -y
npm install @anthropic-ai/sdk

验证方式是查看 package.json 和 node_modules 是否生成成功。你应该还能在终端里看到安装完成且没有报错。

Step 3: 调用 Sonnet 5 示例请求

目标是发出第一条真实请求，确认模型、密钥和网络链路都工作正常。这个步骤会直接告诉你能不能把 Sonnet 5 接进现有应用。

创建一个 index.js，写入最小可运行代码并指定你账户可用的 Claude Sonnet 5 模型名。

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });

const msg = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 200,
  messages: [
    { role: "user", content: "用一句话解释 Claude Sonnet 5 的适用场景。" }
  ]
});

console.log(msg.content[0].text);

验证方式是运行 node index.js，你应该看到一段自然语言回复，而不是认证错误、模型不存在错误或网络超时。

Step 4: 对比你的任务负载

目标是判断 Sonnet 5 是否真的适合你的业务，而不是只看一次演示输出。建议用你真实场景里的三类任务做对比，例如代码补全、长文总结和结构化抽取。

把同一组提示词分别发给你当前在用的模型和 Sonnet 5，记录输出质量、响应时间和失败率。若你在国内使用 Claude Code，还要额外记录代理、转发或中间服务带来的延迟与维护成本。

验证方式是得到一份简单的测试表，里面至少包含任务名、结果质量、平均响应时间和人工满意度。你应该能明确说出它在哪些任务上更强，哪些任务上并没有明显优势。

Step 5: 固化生产配置

目标是把验证过的接入方式变成可维护的生产配置，而不是只停留在本地脚本。你需要把模型名、超时、重试和日志策略都写进配置层。

建议把 API key 交给密钥管理系统，把模型名放进环境变量，把请求封装成一层服务函数，方便后续切换模型或降级。

export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_TIMEOUT_MS="30000"
export ANTHROPIC_MAX_RETRIES="2"

验证方式是重启服务后再次发起请求，确认配置仍然生效，并且日志里能看到模型名、耗时和错误码。

常見錯誤

• 把模型名写错。修复方法是先在 Anthropic 文档里核对当前可用的模型标识，再把它放进配置而不是硬编码。
• 把 API key 提交到仓库。修复方法是改用环境变量或密钥管理服务，并立即轮换已泄露的密钥。
• 只在单次演示里判断效果。修复方法是用你自己的真实任务做小样本对比，至少覆盖代码、总结和抽取三类场景。

接下來可以看什麼

下一步可以把这套接入流程扩展成自动化评测脚本、提示词模板库和模型路由策略，这样你就能更系统地决定 Sonnet 5 是否进入主生产链路。