Claude Code

Claude Code 是 Anthropic 官方推出的编程 Agent。接入 ShuYou 后，可使用远比 Claude 官方 lineup 更丰富的模型。例如，可在 Claude Code 中通过 ShuYou 调用 GPT、Claude、Gemini 等支持 Anthropic Messages 协议的模型。完整列表见 ShuYou 模型列表。ShuYou 完整支持 Anthropic Messages API，可无缝集成 Claude Code、Cursor 等工具，只需修改两个参数即可开始。Anthropic 协议 Base URL：https://api.shuyou.ai

配置

安装 Claude Code

Claude Code 的 npm/pnpm 安装方式已弃用，不再推荐。若曾通过 npm/pnpm 安装，请先卸载旧版本，再使用原生安装方式。卸载旧版本（如适用）：

npm uninstall -g @anthropic-ai/claude-code
# 或
pnpm uninstall -g @anthropic-ai/claude-code

# 若已是原生安装，可直接运行迁移命令
claude install

推荐安装方式（原生安装）：

macOS / Linux / WSL
Windows PowerShell
Windows CMD
Homebrew (macOS)
WinGet (Windows)

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

brew install --cask claude-code
# Homebrew 安装不会自动更新，需手动执行：
# brew upgrade claude-code

winget install Anthropic.ClaudeCode
# WinGet 安装不会自动更新，需手动执行：
# winget upgrade Anthropic.ClaudeCode

原生安装（推荐）：macOS/Linux/WSL 与 Windows 脚本安装支持自动更新。
包管理器安装：Homebrew 与 WinGet 需手动执行升级命令。
完整安装文档：见 Claude Code 官方安装文档。
验证安装：安装后运行 claude doctor。

配置 Claude Code

配置原理

Claude Code 默认连接 Anthropic 官方服务。通过设置环境变量，可将请求转发到 ShuYou：

无需修改 Claude Code 本身：纯环境变量切换端点。
使用 ShuYou API Key 鉴权：替代官方 Anthropic API Key。
访问更多模型：除 Claude 外，还可使用 GPT、Gemini 等 ShuYou 上支持 Anthropic 协议的模型。

核心是两个环境变量：ANTHROPIC_BASE_URL（https://api.shuyou.ai）与 ANTHROPIC_AUTH_TOKEN（你的 ShuYou API Key）。

自 Claude Code v2.0.7x 起，环境变量加载逻辑已变更：~/.claude/settings.json 中的 env 配置在以下场景可能无法可靠读取：

首次登录 Claude Code 时
登出后再次登录时

因此接入 ShuYou 时，建议通过 Shell 配置文件环境变量 完成全部配置，确保登录与请求均走 ShuYou Anthropic 兼容端点。

Step 0：获取 ShuYou API Key

配置前请先获取 ShuYou API Key。ShuYou 提供两种计费方案，请按场景选择：

订阅 API Key（推荐个人开发）
Pay As You Go API Key

适用： 个人开发、学习、Vibe Coding特点：固定月费、成本可预期获取步骤：

前往订阅管理页
选择合适套餐并订阅
在管理页创建订阅 API Key

个人开发 / 学习 → 使用 订阅 API Key，价格更优。
生产 / 商业项目 → 使用 Pay As You Go API Key，稳定性更高、无限制。

订阅 Key 不得用于生产环境，违规可能导致账户限制。

Step 1：配置 Shell 环境变量（推荐）

将 ShuYou 连接配置写入 Shell 配置文件，每次打开终端自动生效。

macOS / Linux
Windows PowerShell

# 1. 确认 Shell 类型（bash 或 zsh）：
#    bash → 编辑 ~/.bashrc
#    zsh  → 编辑 ~/.zshrc
#    运行 echo $SHELL 查看

# 2. 追加以下内容（替换 YOUR_SHUYOU_API_KEY）

# ========= ShuYou + Claude Code 配置 =========
export ANTHROPIC_BASE_URL="https://api.shuyou.ai"
export ANTHROPIC_AUTH_TOKEN="YOUR_SHUYOU_API_KEY"
export ANTHROPIC_API_KEY=""

export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"
export CLAUDE_CODE_ATTRIBUTION_HEADER="0"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

export API_TIMEOUT_MS="30000000"

# 3. 使配置生效
source ~/.bashrc   # 或 source ~/.zshrc
# 或重启终端

# 1. 检查 Profile 是否存在
Test-Path $PROFILE

# 2. 若返回 False，创建 Profile
if (!(Test-Path $PROFILE)) {
    New-Item -Path $PROFILE -ItemType File -Force
}

# 3. 编辑 Profile：notepad $PROFILE  （或 code $PROFILE）

# 4. 追加以下内容（替换 YOUR_SHUYOU_API_KEY）

$env:ANTHROPIC_BASE_URL = "https://api.shuyou.ai"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_SHUYOU_API_KEY"
$env:ANTHROPIC_API_KEY = ""

$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = "1"
$env:CLAUDE_CODE_ATTRIBUTION_HEADER = "0"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"
$env:API_TIMEOUT_MS = "30000000"

# 5. 重启 PowerShell，或运行：. $PROFILE

Write-Host "ANTHROPIC_BASE_URL: $env:ANTHROPIC_BASE_URL"
Write-Host "ANTHROPIC_AUTH_TOKEN: $env:ANTHROPIC_AUTH_TOKEN"

请将 YOUR_SHUYOU_API_KEY 替换为 ShuYou 控制台中的真实 API Key。

变量	必填	用途	说明
`ANTHROPIC_BASE_URL`	是	服务端点	将 Claude Code 请求转发至 ShuYou
`ANTHROPIC_AUTH_TOKEN`	是	鉴权 Key	你的 ShuYou API Key
`ANTHROPIC_API_KEY`	是	避免冲突	设为 `""`，清除旧 Anthropic 配置
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`	推荐	性能	关闭实验性 Beta，避免长路由
`CLAUDE_CODE_ATTRIBUTION_HEADER`	推荐	性能	关闭 Attribution 头
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	推荐	流量	关闭非必要上报
`API_TIMEOUT_MS`	可选	超时	请求超时（毫秒）
`ANTHROPIC_DEFAULT_*_MODEL`	可选	模型映射	Haiku/Sonnet/Opus 档位；不设置则用 Claude Code 默认

在非 Anthropic 官方网关下，实验性 Beta 功能会显著增加延迟。建议设置以下三个变量以提升 ShuYou 上的速度与稳定性：

export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"
export CLAUDE_CODE_ATTRIBUTION_HEADER="0"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

Step 2：启动 Claude Code 并完成鉴权

环境变量配置完成后即可启动 Claude Code，首次启动将通过 ShuYou 自动鉴权。

打开新的终端窗口（确保环境变量已加载）。
进入项目目录：

cd /path/to/your/project

启动 Claude Code：

claude

首次启动时 Claude Code 将：
- 从环境变量读取 ANTHROPIC_AUTH_TOKEN
- 通过 ANTHROPIC_BASE_URL 指向的 ShuYou 服务鉴权
- 无需额外登录步骤即可使用

若提示找不到 claude 命令，请确认已按上文完成安装。

Step 3：验证连接

在 Claude Code 提示符下输入 /status：

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://api.shuyou.ai

检查项：

Auth token 应显示 ANTHROPIC_AUTH_TOKEN
Anthropic base URL 应显示 https://api.shuyou.ai

若与上述一致，则配置成功。

更改 / 指定默认模型

配置默认模型为可选。不设置 ANTHROPIC_DEFAULT_*_MODEL 时，Claude Code 使用内置默认模型。

使用官方 Claude 模型（推荐：别名）

官方 Claude 模型建议使用 Claude 模型别名（如 claude-opus-4-7、claude-sonnet-4-6、claude-haiku-4-5），而非完整 ShuYou slug（如 anthropic/claude-sonnet-4.5）：

export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-7"

Claude Code 通过硬编码字符串校验模型名以启用 1M 上下文、Effort 推理控制 等功能。校验通过 claude-sonnet-4-6 时功能正常；使用 anthropic/claude-sonnet-4.5 时可能校验失败，功能静默失效。请在模型详情页确认可用别名；否则使用模型列表中的完整 slug。

使用非 Claude 模型

切换至 GPT、Gemini 等非 Claude 模型时，须使用 完整 ShuYou 模型 slug：

export ANTHROPIC_DEFAULT_SONNET_MODEL="openai/gpt-4o"
export ANTHROPIC_DEFAULT_OPUS_MODEL="google/gemini-3.1-pro-preview"

修改后执行 source ~/.bashrc / source ~/.zshrc 或重启终端。交互中可用 /model 切换模型。

支持的模型

Anthropic 协议支持分批上线。在 ShuYou 模型列表筛选 Anthropic API Compatible： anthropic-support

也可在模型详情页查看： anthropic-support

在 VSCode 中使用 Claude Code 扩展

除命令行外，Claude Code 还提供 VSCode 扩展，可在编辑器内使用。

Step 1：安装 Claude Code 扩展

在 VSCode 扩展市场搜索并安装 Claude Code。

Step 2：打开设置

安装后点击扩展设置图标，选择 Edit in settings.json。

Step 3：配置模型与环境变量

{
  "claudeCode.selectedModel": "claude-sonnet-4-6",
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.shuyou.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "YOUR_SHUYOU_API_KEY" },
    { "name": "API_TIMEOUT_MS", "value": "3000000" },
    { "name": "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS", "value": "1" },
    { "name": "CLAUDE_CODE_ATTRIBUTION_HEADER", "value": "0" },
    { "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "value": "1" }
  ]
}

替换 API Key 为你的 ShuYou API Key。
配置优先级：VSCode 扩展优先使用 settings.json，建议在扩展中仅在此配置环境变量，避免与 Shell Profile 冲突。
模型选择：claudeCode.selectedModel 设置当前模型；对话中可用 /model 切换。

Step 4：开始使用

点击 VSCode 侧栏 Claude Code 图标。
在聊天界面输入问题或任务。
首次使用时点击 Trust This Folder 信任工作区。

切换模型：对话中输入 /model。
查看状态：输入 /status 查看连接状态。
环境变量冲突：确保系统级变量未覆盖 ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_BASE_URL。

故障排查

API Key 错误或鉴权失败

问题： API Key 无效、未授权或鉴权失败。解决方案：

在 ShuYou 控制台确认 Key 有效。
检查订阅配额或 Pay As You Go 余额。
确认环境变量已加载：

# macOS/Linux
echo $ANTHROPIC_AUTH_TOKEN

# Windows PowerShell
echo $env:ANTHROPIC_AUTH_TOKEN

确认 Key 处于启用状态且未被删除。

从其他平台切换到 ShuYou 后鉴权失败

问题： 曾使用官方 Claude Code 或其他平台，切换 ShuYou 后出现冲突。解决方案：

删除旧配置文件：

# macOS/Linux
rm -rf ~/.claude/settings.json

# Windows PowerShell
Remove-Item -Path "$env:USERPROFILE\.claude\settings.json" -Force

重新应用 Step 1 中的 ShuYou 环境变量。
重新加载：source ~/.zshrc 或 . $PROFILE
验证：

echo $ANTHROPIC_BASE_URL    # 应输出：https://api.shuyou.ai
echo $ANTHROPIC_AUTH_TOKEN  # 应输出你的 ShuYou API Key
echo $ANTHROPIC_API_KEY     # 应无输出

重启 Claude Code 并运行 /status。

模型不支持 Anthropic 协议

在 ShuYou 模型列表筛选 Anthropic API Compatible，或查看各模型详情页。

连接失败

检查网络连接。
确认 ANTHROPIC_BASE_URL 为 https://api.shuyou.ai。
确认防火墙未阻止出站连接。

VSCode Claude Code 扩展配置问题

打开 VSCode 设置 → 搜索「Claude Code」→ Edit in settings.json。
确认 claudeCode.environmentVariables 中 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 正确。
Claude 模型使用别名（如 claude-sonnet-4-6）；其他模型使用完整 ShuYou slug。
修改后完全重启 VSCode。
查看 View → Output → Claude Code 错误日志。
在扩展聊天中运行 /status。

Windows PowerShell 脚本执行策略问题

以管理员身份运行 PowerShell：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 后重新打开 PowerShell。

如何启用 1M 上下文窗口

原因： Claude Code 对模型名做硬编码校验，带 anthropic/ 前缀的 ID 可能无法启用 1M 上下文。解决方案： 使用别名形式：

# 无法启用 1M 上下文
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.5"

# 可正确启用 1M 上下文
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"

重新加载 Shell 配置并重启 Claude Code。

Opus 4.7 无法使用时怎么办

将 Claude Code 升级至最新版（Opus 4.7 需 v2.1.111+）。运行 claude --version 检查。
设置 export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-7"，或移除 ANTHROPIC_DEFAULT_*_MODEL 使用默认映射。
重新加载配置并重启 Claude Code。

查看 ShuYou 模型列表获取全部可用模型。

请在专门的项目目录中使用 Claude Code，避免在系统目录或含密钥的目录中运行。

​Claude Code

​配置

​安装 Claude Code

​配置 Claude Code

​配置原理

​Step 0：获取 ShuYou API Key

​Step 1：配置 Shell 环境变量（推荐）

​Step 2：启动 Claude Code 并完成鉴权

​Step 3：验证连接

​更改 / 指定默认模型

​使用官方 Claude 模型（推荐：别名）

​使用非 Claude 模型

​支持的模型

​在 VSCode 中使用 Claude Code 扩展

​Step 1：安装 Claude Code 扩展

​Step 2：打开设置

​Step 3：配置模型与环境变量

​Step 4：开始使用

​故障排查

Claude Code

配置

安装 Claude Code

配置 Claude Code

配置原理

Step 0：获取 ShuYou API Key

Step 1：配置 Shell 环境变量（推荐）

Step 2：启动 Claude Code 并完成鉴权

Step 3：验证连接

更改 / 指定默认模型

使用官方 Claude 模型（推荐：别名）

使用非 Claude 模型

支持的模型

在 VSCode 中使用 Claude Code 扩展

Step 1：安装 Claude Code 扩展

Step 2：打开设置

Step 3：配置模型与环境变量

Step 4：开始使用

故障排查