跳到主要内容

Claude Code

Anthropic 官方 CLI。通过 Anthropic 兼容协议接入 TokenRoute，可调用 Claude 系列及其他兼容模型。

Base URL 不带 /v1

Claude Code 走 Anthropic 协议，Base URL 是 https://api.smartwan.com，不要加 /v1。

安装​

系统推荐方式备选
Windowsirm https://claude.ai/install.ps1 | iex（PowerShell，无需管理员权限）winget install Anthropic.ClaudeCode
macOScurl -fsSL https://claude.ai/install.sh | bashbrew install --cask claude-code
Linuxcurl -fsSL https://claude.ai/install.sh | bash—

npm 安装三平台通用，但要求 Node.js 22+：npm install -g @anthropic-ai/claude-code

系统要求：Windows 10 1809+ / Windows Server 2019+（也可跑在 WSL 2）、Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+。Alpine 还需装 bash、curl、libgcc、libstdc++、ripgrep。

配置​

两种方式任选。

方式一：CC-Switch（图形界面）​

从 sourceforge.net/projects/cc-switch.mirror 下载安装并运行。

  1. 点顶部导航栏的 Claude

  2. 点右上角 + 添加

  3. 填写：

    字段填什么
    供应商名称TokenRoute（可自定义）
    官网链接https://www.tokenroute.com/
    API Key你的 API Key
    API 请求地址https://api.smartwan.com

  4. 点 保存

命令行端和桌面端共用这一份配置。

方式二：手写 settings.json​

mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.smartwan.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Token",
    "ANTHROPIC_MODEL": "claude-haiku-4-5"
  }
}
EOF

Windows 用 mkdir %USERPROFILE%\.claude 建目录，配置文件同样放 .claude/settings.json。

凭证必须放在 env 对象里

写在 JSON 顶层不生效，Claude Code 启动后仍会要求登录。

另外 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 不要同时设置——前者发送 Authorization: Bearer，后者发送 x-api-key。TokenRoute 用 Bearer 方式，即 ANTHROPIC_AUTH_TOKEN。

验证​

claude --version
claude doctor
claude

进入会话后执行 /status，确认两件事：

  • Anthropic base URL 指向 https://api.smartwan.com
  • 认证来源是 ANTHROPIC_AUTH_TOKEN

然后发条测试消息。

切换模型​

会话里输入 /model 回车，方向键选择，回车确认，自动返回对话界面并生效。

可用的 Claude 系列：

claude-opus-5
claude-sonnet-5
claude-haiku-4-5
claude-fable-5

手写配置的话改 env.ANTHROPIC_MODEL 后重启。模型名以模型列表为准。

常用命令​

命令用途
/clear清空上下文，开始新对话
/model切换模型
/compact压缩会话历史，省上下文
/usage、/cost查看当前会话 token 消耗
/help所有命令说明
/弹出命令自动补全列表

也可以直接在对话里描述需求，Claude Code 会自行读取和编辑仓库文件。

自定义命令放这两个位置：项目级 .claude/commands/，个人级 ~/.claude/commands/。更复杂的可复用能力用 Skills（.claude/skills/<name>/SKILL.md）。

完整命令参考见官方文档。

桌面端​

claude.com/download 下载安装。

桌面端需要配合 CC-Switch 的本地路由：

  1. CC-Switch 点顶部 Claude，在按钮左侧启用本地路由
  2. 回到 Claude，左上角菜单 → Gateway → Inference configuration
  3. 切到 Connection 页，看右上角 CC Switch 状态标识——绿色正常，红色异常
  4. 点 Test Connection 测连通
  5. 下滑点 Test model discovery 测模型读取
  6. 两项都绿后点 Save & Apply Changes

回对话首页，输入框下方下拉选模型，发条消息验证。

连接测试一直红、发消息无响应：先关 Claude 再关 CC-Switch，然后按顺序重启，重做第 3 步。

遇到问题​

现象处理
找不到 .claude 目录或 settings.json手动 mkdir，或先启动一次客户端
启动后仍要求登录凭证没放在 env 对象里，或 JSON 结构有误
认证失败Key 是否以 sk- 开头、是否过期；地址是否为 https://api.smartwan.com（不带 /v1）；有没有同时设了两个 token 变量

更多见常见问题。