客户端接入

Claude Code

终端、VS Code、WSL 与远程环境

接入范围

Claude Code 通过 Anthropic Messages 接入第三方 API。模型填写 Key 有权限的完整 Claude ID，此配置不用于 GPT、Gemini 或图片模型。

settings.json

配置文件为运行用户的 ~/.claude/settings.json，Windows 通常位于 %USERPROFILE%\.claude\settings.json。将以下 env 字段合并到现有文件，保留其他设置。

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.yunqiai.chat",
    "ANTHROPIC_API_KEY": "你的 YunQi API Key",
    "ANTHROPIC_MODEL": "客户选择的完整 Claude 模型 ID"
  }
}

此配置会以明文保存 Key，请限制文件权限并排除在版本控制之外。也可以在运行环境中设置变量。检查是否残留其他服务的 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY，避免客户端读取旧认证。

ANTHROPIC_BASE_URL 不带 /v1 或 /messages。保存后完全退出并重新启动 Claude Code，确认使用的模型。出现登录选项时选择 API Key 方式；YunQi 账户密码仅用于本站控制台。

VS Code、WSL 与远程环境

在扩展实际运行的环境中配置用户目录和变量。Windows、WSL、SSH、Dev Container 各有自己的 HOME、代理、证书和 settings.json；Windows 终端的设置不会自动同步到远程环境。

修改后重新加载 VS Code 窗口或重启扩展进程。如配置未生效，检查项目设置、用户设置、启动终端变量及 CC Switch 的覆盖关系。Key 应保存在私有配置或环境变量中，不写入仓库共享的 .vscode/settings.json。

调用与诊断

先用目标 Key 和模型发送 /v1/messages 请求，再在 Claude Code 中检查对话和一次只读工具调用。这样可以分别确认接口连接与客户端工具处理。

Opus 5.5 等型号的推理和工具限制见Messages。若客户端发送了不兼容的 thinking 或 tool_choice，需升级或调整客户端配置，保留原模型 ID。

Claude 官方网页不能配置第三方 API base URL。本页适用于 Claude Code / Anthropic SDK，YunQi Key 不用于 Claude 网页登录。