Claude Code 集成教程

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，本文介绍如何将其配置为使用玄州API。

配置步骤

方法一：环境变量（推荐）

在终端中设置以下环境变量：

export ANTHROPIC_BASE_URL=https://xuanzhouapi.top
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxx

配置完成后，直接启动 Claude Code：

claude

方法二：配置文件（项目级）

创建或编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://xuanzhouapi.top",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

方法三：Windows 系统配置

Windows 用户请在系统环境变量中设置：

1. 打开「系统属性」→「高级」→「环境变量」
2. 添加以下用户变量：
   • 变量名：ANTHROPIC_BASE_URL，值：https://xuanzhouapi.top
   • 变量名：ANTHROPIC_AUTH_TOKEN，值：sk-xxxxxxxxxxxxxxxxxxxxxxxx
3. 重新打开终端使其生效

注意：如果之前设置过 ANTHROPIC_API_KEY，请先取消设置（unset ANTHROPIC_API_KEY），它与 ANTHROPIC_AUTH_TOKEN 互斥，同时设置可能导致认证冲突。

支持的模型

配置完成后，在 Claude Code 中可以使用以下模型：

# 使用 Claude Opus 4.7（最强）
claude --model claude-opus-4-7

# 使用 Claude Sonnet 4.6（性价比推荐）
claude --model claude-sonnet-4-6

# 使用 Claude Opus 4.7-S（快速版）
claude --model claude-opus-4-7-s

验证配置

终端输入以下命令，检查是否正确连接：

claude --version

如果能正常启动并显示版本信息，说明配置正确。

也可以在 Claude Code 中直接测试：

> 你好，请用中文回复，确认你已连接成功

常见问题

1. 连接失败 / 认证错误

• 确认环境变量名称为 ANTHROPIC_AUTH_TOKEN（不是 ANTHROPIC_API_KEY）
• 不要同时设置 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY
• 确认 API Key 前缀 sk- 已包含在内
• 确认 ANTHROPIC_BASE_URL 格式正确（不要以 / 结尾）

2. 模型不可用

• 确认你的 API Key 所在分组包含该模型
• 在控制台「模型广场」中查看分组的可用模型列表

3. 环境变量不生效

• 部分版本可能存在此问题，推荐使用 ~/.claude/settings.json 配置文件方式
• 重启终端后重试