Claude Code

2026-09-22 已用 Claude Code 2.1.278、claude-haiku-4-5 及本页的 ANTHROPIC_AUTH_TOKEN 配置完成最小真实调用。Messages 的 Bearer 与 x-api-key 均可使用，按客户端选择配置，见认证与 Base URL。

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

Base URL 不带 /v1

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

开始之前

需要一个 API Key 和账户可用额度，模型名从模型列表复制（大小写敏感）。

Windows 一键配置

不想手动安装 CLI 和编辑 settings.json？可使用 GSS Deploy（Windows 一键配置） 自动完成。仅支持 Windows；macOS / Linux 请继续按下方步骤操作。

安装

系统	推荐方式	备选
Windows	irm https://claude.ai/install.ps1 | iex（PowerShell，无需管理员权限）	winget install Anthropic.ClaudeCode
macOS	curl -fsSL https://claude.ai/install.sh | bash	brew install --cask claude-code
Linux	curl -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 CMD 可用 mkdir %USERPROFILE%\.claude；PowerShell 可用 New-Item -ItemType Directory -Force "$env: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 变量

更多见常见问题。