Claude Code 配置​

Claude Code 可以通过环境变量接入 yuyuflow 的 Claude 兼容接口。配置前请先完成 快速开始，准备好 Node.js、Git、API Key 和可用模型名。

推荐使用 CC-Switch

推荐先阅读 CC-Switch 配置，使用 CC-Switch 管理 Claude Code 配置、API Key 和模型切换。建议为不同环境单独命名 provider，切换后立即验证一次请求；不使用 CC-Switch 时，也可以直接维护下面的 settings.json。

前置条件​

确认 Node.js 和 Git 已安装：

powershell
node --version
npm --version
git --version

在 控制台 创建专用 API Key，并确认目标模型可以通过 Claude 兼容接口调用。

安装 Claude Code​

powershell
npm install -g @anthropic-ai/claude-code

配置 Claude Code​

Claude Code 可以在项目目录或用户配置目录中读取 .claude/settings.json。写入以下内容，并将占位符替换为真实值：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://art-api.yuyuflow.com",
    "ANTHROPIC_MODEL": "YOUR_MODEL"
  }
}

Claude 兼容接口的 Base URL 通常不带 OpenAI /v1 后缀；如果控制台明确提供了带版本号的地址，请以控制台地址为准，不要重复拼接路径。

API Key 安全要求

不要把包含 ANTHROPIC_AUTH_TOKEN 的配置提交到公开仓库或前端资源中。生产环境建议使用环境变量或密钥管理服务，并为不同项目使用不同令牌。

验证 Claude Code​

在项目目录运行：

powershell
claude

发送一个简单问题，确认返回内容正常。使用 CC-Switch 时，先切换到目标 provider，再执行验证。

常见问题​

模型名不可用

确认 ANTHROPIC_MODEL 使用控制台中的完整模型名，并检查 API Key 所属令牌分组是否允许访问该模型。

连接超时

检查网络、Base URL 和客户端超时设置。先回到快速开始使用 cURL 验证基础连通性。

鉴权失败

确认 ANTHROPIC_AUTH_TOKEN 是原始 API Key，不要额外拼接 Bearer；同时确认令牌未过期且没有多余空格。

下一步可阅读 LLM 配置、快速开始 或 Codex 配置。