anthropic-sdk-go

环境要求

• 已安装 Go 工具链（README 未注明最低版本，可用 go version 检查）
• 一个可用的 Anthropic API Key
• 能正常访问 Anthropic API 的网络环境

安装与启动步骤

1. 1检查 Go 环境

   在终端确认 go 命令可用，能打印版本号即可继续。

   go version

   复制

2. 2初始化 Go 模块

   新建项目目录并初始化模块，作为引入 SDK 的基础。

   mkdir -p claude-demo && cd claude-demo && go mod init example.com/claude-demo

   复制

3. 3添加 SDK 依赖

   按 README 指定版本拉取 SDK，导入路径为 v2 版本。

   go get -u 'github.com/anthropics/anthropic-sdk-go/v2@v2.3.0'

   复制

4. 4配置 API Key

   README 说明客户端默认读取环境变量 ANTHROPIC_API_KEY。

   export ANTHROPIC_API_KEY=sk-ant-xxxxxxxx

   复制

5. 5编写示例程序

   把 README 的 Getting started 代码写入 main.go，可直接构建运行。

   cat > main.go <<'EOF'
   package main
   
   import (
   	"context"
   	"fmt"
   
   	"github.com/anthropics/anthropic-sdk-go/v2"
   	"github.com/anthropics/anthropic-sdk-go/v2/option"
   )
   
   func main() {
   	client := anthropic.NewClient(
   		option.WithAPIKey("my-anthropic-api-key"),
   	)
   	message, err := client.Messages.New(context.TODO(), anthropic.MessageNewParams{
   		MaxTokens: 1024,
   		Messages: []anthropic.MessageParam{
   			anthropic.NewUserMessage(anthropic.NewTextBlock("What is a quaternion?")),
   		},
   		Model: anthropic.ModelClaudeOpus5_5,
   	})
   	if err != nil {
   		panic(err.Error())
   	}
   	fmt.Printf("%+v
   ", message.Content)
   }
   EOF

   复制

6. 6运行并验证

   执行程序，向 Messages 接口发一次请求并打印返回内容块。

   go run main.go

   复制

关键配置

如何确认成功

执行 go run main.go 后正常打印出消息内容块，没有 panic 报错即表示调用成功。

常见问题

注意事项

• README 未声明 Go 最低版本，建议使用较新的 Go 稳定版以避免模块解析问题。
• 示例中的 API Key 是占位值，请替换为真实密钥，且不要提交到代码仓库。
• 该库仅提供客户端封装，实际调用仍依赖 Anthropic API 服务可用。