胜算云 胜算云 文档中心 ↗ 精益社区

Claude Code 配置使用胜算云

通过胜算云的 Claude 兼容 API 运行官方 Claude Code,无需官方 Anthropic 账号或订阅。使用 /v1/messages 模型,比传统 OpenAI 兼容接口更稳定。

官方 Claude Code CLI 两种接入方式 支持 Web to Agent 一键写入

用 CC-Switch 一键接入胜算云

推荐方式。CC-Switch 支持 Claude Code、Codex、OpenCode、OpenClaw、Hermes Agent 等多工具一键配置,自动管理 API Key 和 Base URL,无需手动编辑配置文件。

  1. 下载并安装 CC-Switch前往 GitHub Releases 下载对应平台安装包。
  2. 打开供应商设置打开 CC-Switch,点击「供应商」。
  3. 选择胜算云在供应商列表中选择「胜算云」。
  4. 填入 API Key输入你的胜算云 API Key。
  5. 写入通用配置勾选「写入通用配置」以覆盖已有配置。
  6. 启用并重启点击启用,重启对应工具即可使用。

CC-Switch 关键填写项

API 地址格式选择 Anthropic Messages(原生),不要选 OpenAI 兼容格式
认证字段ANTHROPIC_AUTH_TOKEN(默认值)
Base URLhttps://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 安装包

前提条件

  1. 操作系统macOS 12+ / Linux / Windows 10/11(推荐 WSL2)。
  2. 终端工具已安装 curl 或 PowerShell。
  3. 胜算云账号登录 胜算云控制台 获取 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

  1. 打开密钥页面浏览器访问 console.shengsuanyun.com/user/keys。
  2. 创建 Key创建新 Key 或复制已有 Key。
  3. 妥善保存复制 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_*_MODELClaude 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"

首次运行与测试

  1. 进入项目目录
    mkdir ~/claude-test && cd ~/claude-test
    git init
  2. 启动 Claude Code
    claude
  3. 记住常用命令/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 与模型名。