接入 Claude Code

将 Claude Code 连接到 Puyun AI，通过 Anthropic 协议调用任意大模型。

概述

Claude Code 是 Anthropic 官方的命令行 AI 编程助手，原生使用 Anthropic Messages API 协议。通过 Puyun AI 的协议自动转换功能，你可以在 Claude Code 中调用 OpenAI、Gemini 等其他模型，无需做任何 OpenAI 接口的适配工作。

配置方法

方法一：环境变量

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

bash
export ANTHROPIC_API_KEY="sk-your-api-key"
export ANTHROPIC_BASE_URL="https://ai.tracup.com"

然后直接运行 Claude Code：

bash
claude

方法二：配置文件

在 Claude Code 的配置文件中设置：

编辑 ~/.claude/settings.json，添加：

json
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://ai.tracup.com"
  }
}

方法三：项目级配置

在项目根目录创建 .claude/settings.json：

json
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://ai.tracup.com"
  }
}

使用不同模型

配置完成后，你可以通过 --model 参数指定模型：

bash
# 使用 Claude Sonnet
claude --model claude-sonnet-4-6

# 使用 GPT-4o（协议自动转换）
claude --model gpt-4o

# 使用 Gemini 2.5 Pro（协议自动转换）
claude --model gemini-2.5-pro

# 使用 DeepSeek（协议自动转换）
claude --model deepseek-chat

验证连接

运行以下命令验证配置是否成功：

bash
claude --model claude-sonnet-4-6 -p "Hello, 验证连接"

如果收到正常响应，说明连接配置成功。

服务层级

Claude Code 的调用受你账户的服务层级影响：

层级推荐场景说明
Test功能验证适合验证 Claude Code 能否正常连接
Flex日常开发性价比最优，推荐个人开发者使用
Enterprise团队生产最稳定，推荐团队协作使用

常见问题

连接超时

如果遇到连接超时，请检查：

  1. ANTHROPIC_BASE_URL 是否设置为 https://ai.tracup.com（不含 /v1）
  2. API Key 是否正确
  3. 网络是否能访问 ai.tracup.com

模型不可用

如果返回模型不存在的错误：

  1. 确认模型名称拼写正确
  2. 检查该模型在你当前服务层级下是否可用
  3. 访问首页查看完整的可用模型列表

响应格式异常

如果 Claude Code 无法解析响应：

  1. 确认你使用的模型支持 Anthropic 协议转换
  2. 尝试切换到 Claude 原生模型验证是否为转换问题
  3. 如果问题持续，请联系技术支持