Claude Code 配置使用胜算云
通过胜算云的 Claude 兼容 API 运行官方 Claude Code,无需官方 Anthropic 账号或订阅。使用 /v1/messages 模型,比传统 OpenAI 兼容接口更稳定。
用 CC-Switch 一键接入胜算云
推荐方式。CC-Switch 支持 Claude Code、Codex、OpenCode、OpenClaw、Hermes Agent 等多工具一键配置,自动管理 API Key 和 Base URL,无需手动编辑配置文件。
- 下载并安装 CC-Switch前往 GitHub Releases 下载对应平台安装包。
- 打开供应商设置打开 CC-Switch,点击「供应商」。
- 选择胜算云在供应商列表中选择「胜算云」。
- 填入 API Key输入你的胜算云 API Key。
- 写入通用配置勾选「写入通用配置」以覆盖已有配置。
- 启用并重启点击启用,重启对应工具即可使用。
CC-Switch 关键填写项
| API 地址格式 | 选择 Anthropic Messages(原生),不要选 OpenAI 兼容格式 |
|---|---|
| 认证字段 | ANTHROPIC_AUTH_TOKEN(默认值) |
| Base URL | https://router.shengsuanyun.com/api |
| 模型选择 | 使用下拉列表,推荐 anthropic/claude-opus-4-8、anthropic/claude-sonnet-5、anthropic/claude-haiku-4-5 |
| 通用配置 | 必须勾选「写入通用配置」以覆盖已有配置 |
Base URL 没有 /v1 后缀!Anthropic 原生格式的端点与 OpenAI 兼容格式不同,多写 /v1 会导致请求失败。
下载安装 CC-Switch
| macOS | 支持 brew install 或直接下载 .dmg 安装包 |
|---|---|
| Windows | 下载 .msi 安装包,双击安装 |
| Linux | 提供 .deb 和 .rpm 安装包 |
前提条件
- 操作系统macOS 12+ / Linux / Windows 10/11(推荐 WSL2)。
- 终端工具已安装
curl或 PowerShell。 - 胜算云账号登录 胜算云控制台 获取 API Key。
安装官方 Claude Code
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
macOS / Linux / WSL(最推荐)· Windows PowerShell(以管理员身份运行)· Windows CMD 三选一即可。
验证安装:终端运行
claude --version,能输出版本号即安装成功。
获取胜算云 API Key
- 打开密钥页面浏览器访问 console.shengsuanyun.com/user/keys。
- 创建 Key创建新 Key 或复制已有 Key。
- 妥善保存复制 Key 并保存到安全位置,不要泄露给他人。
配置胜算云(持久化方式)
使用 ~/.claude/settings.json(全局生效,推荐)。macOS / Linux 终端执行:
mkdir -p ~/.claude
cat > ~/.claude/settings.json << EOF
{
"env": {
"ANTHROPIC_BASE_URL": "https://router.shengsuanyun.com/api",
"ANTHROPIC_AUTH_TOKEN": "你的胜算云API_Key",
"ANTHROPIC_MODEL": "anthropic/claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.8",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "anthropic/claude-opus-4.8",
"ENABLE_TOOL_SEARCH": "true"
}
}
EOF
各字段为什么这么写
| ANTHROPIC_BASE_URL | 胜算云 Anthropic 兼容端点(无 /v1 后缀) |
|---|---|
| ANTHROPIC_AUTH_TOKEN | 你的胜算云 API Key |
| ANTHROPIC_MODEL | 默认兜底模型(未匹配到具体角色时用) |
| ANTHROPIC_DEFAULT_*_MODEL | Claude Code 内部分 Haiku / Sonnet / Opus / Fable 四个角色,/model 菜单的每个档位都要指向胜算云模型,否则会回退到官方并报错 |
| ENABLE_TOOL_SEARCH | 允许 Claude 自动搜索调用工具,CC-Switch 默认开启 |
Windows PowerShell 配置
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"
{
"env": {
"ANTHROPIC_BASE_URL": "https://router.shengsuanyun.com/api",
"ANTHROPIC_AUTH_TOKEN": "你的胜算云API_Key",
"ANTHROPIC_MODEL": "anthropic/claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.8",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "anthropic/claude-opus-4.8",
"ENABLE_TOOL_SEARCH": "true"
}
}
模型推荐
| anthropic/claude-opus-4.8 | 最强 |
|---|---|
| anthropic/claude-sonnet-5 | 主力推荐 |
| anthropic/claude-haiku-4.5 | 快速轻量 |
临时环境变量测试
不想写配置文件时,可先在当前终端会话中用环境变量快速验证:
export ANTHROPIC_BASE_URL="https://router.shengsuanyun.com/api"
export ANTHROPIC_AUTH_TOKEN="你的胜算云API_Key"
export ANTHROPIC_MODEL="anthropic/claude-sonnet-5"
$env:ANTHROPIC_BASE_URL = "https://router.shengsuanyun.com/api"
$env:ANTHROPIC_AUTH_TOKEN = "你的胜算云API_Key"
$env:ANTHROPIC_MODEL = "anthropic/claude-sonnet-5"
首次运行与测试
- 进入项目目录
mkdir ~/claude-test && cd ~/claude-test git init - 启动 Claude Code
claude - 记住常用命令
/help查看所有命令 ·/model查看或切换模型 ·/exit退出
如何更换模型
实时切换(进入 Claude Code 后)
/model anthropic/claude-sonnet-5
/model anthropic/claude-opus-4.8
/model bigmodel/glm-5启动时指定
claude --model bigmodel/glm-5永久修改
编辑 settings.json 中的 ANTHROPIC_MODEL 字段。
常见问题排查
| 命令未找到 | 重新打开终端,或运行 hash -r |
|---|---|
| 认证失败(401) | 检查 API Key 是否正确复制(无多余空格) |
| 模型不存在 | 确认模型名称完全一致(带 anthropic/ 前缀) |
| 想禁用遥测 | 在 settings.json 的 "env" 中添加 "DISABLE_TELEMETRY": "1" |
完成:Claude Code 能正常回复即表示胜算云接入生效。遇到其他问题先对照上表排查 Base URL 与模型名。