Claude Code

Anthropic 官方 CLI，支持完整 tool use、prompt cache、subagent、1M 上下文等核心能力。

版本说明

本文最后验证：Claude Code v2.1.137（2026-05，旧平台验证）

安装

macOS / Linux

# 推荐：官方 install.sh
curl -fsSL https://claude.ai/install.sh | bash

# 或 npm（无 root 权限场景）
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
npm install -g @anthropic-ai/claude-code

Windows

# 方法 1（推荐 ⭐）：WinGet 一键
winget install Anthropic.ClaudeCode

# 方法 2：官方安装脚本
irm https://claude.ai/install.ps1 | iex

# 方法 3：npm（需 Node.js ≥ 18）
npm install -g @anthropic-ai/claude-code

Windows 必要依赖

Windows 上 Claude Code 依赖 Git for Windows（用于 shell 工具调用）。先装 Git： https://git-scm.com/download/win

不装 Git 即使 claude --version 能跑，实际执行命令时会报 "no shell available"。

curl -fsSL https://claude.ai/install.sh | bash
fish_add_path ~/.local/bin

:::

安装下载失败的坑

若 curl install.sh | bash 显示 ✅ 但 claude 命令找不到 —— 是安装阶段下载失败导致的假成功。 详见 安装下载失败，推荐改用 npm 安装路线。

验证安装

claude --version
# 应输出: 2.1.137 (Claude Code) 或更高

如果 command not found：

# 找 claude 实际位置
find ~ -name claude -type f -o -name claude -type l 2>/dev/null

# 加进 PATH（zsh / bash）
export PATH="$HOME/.local/bin:$PATH"

# 加进 PATH（fish）
fish_add_path ~/.local/bin

配置 Shuro

三种方式，任选其一：

方式 A：~/.claude/settings.json（推荐，客户端最简）

Windows 路径: %USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://shuro.vip",
    "ANTHROPIC_AUTH_TOKEN": "<您的 API Key>"
  }
}

macOS / Linux 路径: ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://shuro.vip",
    "ANTHROPIC_AUTH_TOKEN": "<您的 API Key>"
  }
}

优点：跨 shell 通用，不用动 .zshrc / .bashrc / config.fish。

方式 B：环境变量（持久化到 shell rc）

zsh / bash

echo 'export ANTHROPIC_BASE_URL="https://shuro.vip"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<您的 API Key>"' >> ~/.zshrc
exec $SHELL

Windows PowerShell

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://shuro.vip","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","<您的 API Key>","User")
# 关闭 PowerShell 重开

Fish Shell

set -Ux ANTHROPIC_BASE_URL "https://shuro.vip"
set -Ux ANTHROPIC_AUTH_TOKEN "<您的 API Key>"

方式 C：临时单次

env ANTHROPIC_BASE_URL="https://shuro.vip" \
    ANTHROPIC_AUTH_TOKEN="<您的 API Key>" \
    claude

验证连通

claude -p "Reply with exactly one word: pong"

看到 pong 即可。

日常使用

cd ~/your-project

# 交互模式
claude

# 一次性命令
claude -p "解释这个项目的整体架构"

# 指定模型
claude --model claude-haiku-4-5-20251001   # 最便宜最快
claude --model claude-sonnet-4-6           # 平衡
claude --model claude-opus-4-7             # 最强

# 跳过 git 仓库检查（任意目录都能用）
claude -p "..." --skip-permissions

支持的模型

模型 ID	用途	速度
claude-opus-4-8	最新旗舰，最强推理	中
claude-opus-4-7	上代旗舰，编码稳定	中
claude-opus-4-6	上代旗舰	中
claude-fable-5	高阶推理	中
claude-sonnet-4-6	性价比之选	快
claude-haiku-4-5-20251001	最快、最便宜	极快

交互模式内 /model 即可切换。

没有 -thinking 别名模型

Shuro 不提供 claude-*-thinking 别名。需要显式思维链时，直接在请求中使用 thinking 参数（Claude Code 会按需自动触发扩展思考）。

进阶：自定义子模型

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://shuro.vip",
    "ANTHROPIC_AUTH_TOKEN": "<您的 API Key>",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7"
  },
  "model": "claude-opus-4-7"
}

不要把 Haiku 映射成 Opus

Claude Code 的 subagent / 后台调用（话题命名、todo 摘要等）走 Haiku。如果你把 ANTHROPIC_DEFAULT_HAIKU_MODEL 改成 Opus，每次会话成本翻 5-10 倍。

关于 1M 上下文 opus[1m]

opus[1m] 是 Claude Code 的内部别名，发请求时带 anthropic-beta: context-1m-2025-08-07 头激活 1M 上下文。

Shuro 的模型目录中，Claude 主力模型（Opus / Fable / Sonnet）均标注原生 1M 上下文（Haiku 为 200K），一般无需额外操作。是否仍需要 / 是否透传 [1m] beta 头，尚未在 Shuro 实测。

待验证（TODO/VERIFY）

以下内容基于旧平台实测（2026-06），尚未在 Shuro 复测，仅供参考：旧平台号池中部分账号没有 1M 权限，带 [1m] 头的请求路由到这些账号会返 503/400；当时的解法是改用不带 [1m] 的模型 ID（如 claude-opus-4-7）。

常见错误

现象	跳转
一直 retry / propagating	retry 死循环
401 Invalid token	401 排查
503 No available accounts	503 排查
Opus 慢 / Haiku 通	模型选择

配套：CC Switch

如果你同时用多个 Provider（官方 + Shuro + 其他），用 CC Switch 一键切换比反复改环境变量方便很多。