Claude Code 配置使用胜算云

通过胜算云的 Claude 兼容 API 运行官方 Claude Code CLI，无需官方 Anthropic 账号或订阅。走 /v1/messages 原生接口，比 OpenAI 兼容接口更稳定。本文从安装 CLI → 三种配置方式（Web to Agent / CC-Switch / 手动改配置）→ 测试与换模型，一步步带完。

一、安装 Claude Code CLI

官方提供原生安装脚本（推荐）和 npm 两种方式，任选其一。

方式 1：原生安装脚本（推荐）

macOS / Linux / WSL：打开终端执行

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

Windows PowerShell（以管理员身份运行）：

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

Windows CMD：

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

方式 2：npm 安装（备选）

已装 Node.js 18+ 的，可全局安装：

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

方式 A · Web to Agent 一键写入（推荐，浏览器内完成）

无需手动编辑配置文件：在下面这个卡片里输入胜算云 Key，组件自动拉取全部可用模型，授权配置目录后一键写入 ~/.claude/settings.json（原文件自动 .bak 备份）。

1. 在上方卡片输入胜算云 Key（旁边「🗝 控制台获取 Key」可直达密钥页）。
2. 组件自动拉取模型列表，下拉选择默认模型（推荐 anthropic/claude-sonnet-4.6）。
3. 点「写入配置」，授权访问 .claude 目录（Win: C:\Users\<你>\.claude；mac/linux: ~/.claude）。
4. 写入完成会自动备份原文件为 settings.json.bak，回到终端运行 claude 即可使用。

方式 B · CC-Switch 桌面工具配置

CC-Switch 是一个桌面 GUI 工具，可管理多套供应商配置并一键切换，适合同时用多个模型供应商的开发者。

1. 下载安装 CC-Switch

按你的系统选择推荐安装包，点击直接下载（均为 v3.18.0 稳定版）：

• Windows：推荐 CC-Switch-v3.18.0-Windows.msi（MSI 安装包，支持自动更新）；或 便携版 zip（解压即用，不写注册表）。Windows ARM64 设备请选文件名带 arm64 的对应制品。
• macOS：推荐 CC-Switch-v3.18.0-macOS.dmg（拖入 Applications 即可）；或 zip 版（Universal Binary），tar.gz 用于 Homebrew 安装与自动更新。
• Linux / 其他平台 / 历史版本：前往 Releases v3.18.0 页面 查看全部制品。

2. 配置胜算云（详细步骤）

1. 打开 CC-Switch，进入「供应商」管理页，点「新增供应商」。

   

2. 在供应商列表中选择「胜算云」（或手动选 Anthropic Messages 原生格式）。

   

3. 填入胜算云 API Key，Base URL 填 https://router.shengsuanyun.com/api（不要带 /v1）。

   

4. 认证字段选 ANTHROPIC_AUTH_TOKEN（默认值，不要改成 API_KEY）。

5. 选择默认模型（用下拉列表）。

   

6. 勾选「写入通用配置」——这一步会用胜算云配置覆盖已有的 ~/.claude/settings.json。

   

7. 点「启用 / 保存」，重启 Claude Code（关掉再重开终端运行 claude）即可使用。

   

3. CC-Switch 配置注意事项

五、方式 C · 手动修改配置文件

不想装工具、想完全掌控配置的，可直接编辑 Claude Code 的配置文件 settings.json。配置文件位置：

• macOS / Linux：~/.claude/settings.json
• Windows：C:\Users\<你>\.claude\settings.json

1. 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-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  },
  "permissions": { "allow": ["Bash(*)"] }
}
EOF

2. Windows 写入配置

先创建目录：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"

再在 C:\Users\<你>\.claude\settings.json 写入以下内容（记事本另存为 UTF-8）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://router.shengsuanyun.com/api",
    "ANTHROPIC_AUTH_TOKEN": "你的胜算云API_Key",
    "ANTHROPIC_MODEL": "anthropic/claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  },
  "permissions": { "allow": ["Bash(*)"] }
}

3. 配置项详细解析：为什么这么改 & 这样改有什么用

Claude Code 启动时会读 settings.json 里的 env，把这些值当作环境变量注入到它的请求逻辑里。每个字段的作用与「为什么要设」如下：

ANTHROPIC_BASE_URL — 填 https://router.shengsuanyun.com/api。
作用：把 Claude Code 的请求目标从官方 api.anthropic.com 改发到胜算云。
为什么：改了它才能走胜算云统一入口，免官方账号/订阅，享受多供应商自动选路和高可用切换。不带 /v1，因为 Claude Code 会自己拼 /v1/messages。

ANTHROPIC_AUTH_TOKEN — 填你的胜算云 API Key。
作用：请求头里的认证凭证，胜算云用它识别账户、鉴权并计费。
为什么：Claude Code 走 Anthropic 原生 messages 接口，认 ANTHROPIC_AUTH_TOKEN 这个字段名；用 API_KEY 不会生效。

ANTHROPIC_MODEL — 填 anthropic/claude-sonnet-4.6。
作用：启动后的默认模型，省得每次手动 /model 切。
为什么：不设的话会回退到官方模型名（如 claude-3-5-sonnet-...），胜算云没有这个名字会 404。

ANTHROPIC_DEFAULT_OPUS_MODEL / ..._SONNET_MODEL / ..._HAIKU_MODEL — 三档分别映射到胜算云的 opus-4.8 / sonnet-4.6 / haiku-4.5。
作用：Claude Code 内部把任务分 Opus / Sonnet / Haiku 三档——主推理用 Sonnet/Opus，后台轻量任务（摘要、补全、子任务调度）用 Haiku。这三项指定每档映射到胜算云的哪个模型。
为什么：不设的话，后台轻量任务会去请求官方 Haiku 名字导致 404，表现为「主对话正常但某些自动操作报错」。设了三档，所有内部任务都路由到胜算云可用模型，整条链路才稳定。

API_TIMEOUT_MS — 填 3000000（50 分钟）。
作用：单次请求超时上限。
为什么：复杂编码任务单次响应可能很久，默认超时太短会被掐断报错；调大到 50 分钟避免长任务中断。

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS — 填 1。
作用：关闭 Claude Code 的实验性 beta 特性。
为什么：部分 beta 会请求胜算云暂不支持的端点或参数导致报错；关掉更稳，等胜算云支持后再开。

permissions.allow — 填 ["Bash(*)"]。
作用：允许 Claude Code 自动执行 Bash 命令而不每次询问。
为什么：开发时频繁确认很打断节奏；按需开启。安全提示：在敏感项目里可去掉此项，保留每次确认。

4. 临时环境变量（快速测试，不写文件）

只想临时试一次、不改配置文件的，可在终端先 export 再启动：

export ANTHROPIC_BASE_URL="https://router.shengsuanyun.com/api"
export ANTHROPIC_AUTH_TOKEN="你的胜算云API_Key"
export ANTHROPIC_MODEL="anthropic/claude-sonnet-4.6"
claude

$env:ANTHROPIC_BASE_URL = "https://router.shengsuanyun.com/api"
$env:ANTHROPIC_AUTH_TOKEN = "你的胜算云API_Key"
$env:ANTHROPIC_MODEL = "anthropic/claude-sonnet-4.6"
claude

六、首次运行与测试

1. 进入一个项目目录（建议先建测试目录）：
   复制

   mkdir ~/claude-test && cd ~/claude-test
   git init

2. 启动 Claude Code：
   复制

   claude

3. 常用命令：
   • /help → 查看所有命令
   • /model → 查看或切换当前模型
   • /exit → 退出

七、如何更换模型

• 实时切换（进入 Claude Code 后）：
  复制

  /model anthropic/claude-sonnet-4.6
  /model anthropic/claude-opus-4.8
  /model bigmodel/glm-5

• 启动时指定：
  复制

  claude --model anthropic/claude-opus-4.8

• 永久修改：编辑 settings.json 中 ANTHROPIC_MODEL 字段。

八、常见问题排查

• command not found: claude → 重开终端让 PATH 生效，或运行 hash -r；npm 装的确认全局 bin 在 PATH 里。
• 401 认证失败 → API Key 复制时带了多余空格/引号；确认 ANTHROPIC_AUTH_TOKEN 填的是裸 Key。
• 404 模型不存在 → 模型名要带 anthropic/ 前缀且完全一致；或 Base URL 多写了 /v1，去掉。
• 后台任务报错但主对话正常 → 没设 ANTHROPIC_DEFAULT_HAIKU_MODEL，后台 Haiku 档请求了官方模型名；补上三档映射。
• 长任务中途断 → 超时太短，把 API_TIMEOUT_MS 调大（如 3000000）。
• 想关遥测 → 在 env 里加 "DISABLE_TELEMETRY": "1"。