Claude Code（安装与接入 SuperToken）

Claude Code 是 Anthropic 官方推出的终端编程代理，适合在终端中阅读、修改、重构代码，执行命令和代码审查。

这页负责接入

完成安装和网关配置后，继续阅读 Claude Code 中文使用手册；想直接看真实项目流程，可以进入 Claude Code 项目实战。

你需要准备

• 原生安装不需要 Node.js；只有使用 npm 备用安装方式时才需要 Node.js
• 一个 SuperToken 的 API Key（注册并创建）
• 已创建令牌分组（推荐 Claude Max 或 Claude Kiro）

TIP

Claude Code 使用 Anthropic 兼容接口，地址不带 /v1。

1. 安装 Claude Code

打开终端（按 Command + Space，输入 Terminal，回车），使用 Anthropic 官方原生安装程序：

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

验证安装：

claude --version

打开 PowerShell，使用 Anthropic 官方原生安装程序：

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

确认安装成功：

claude --version

打开终端，使用 Anthropic 官方原生安装程序：

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

验证安装：

claude --version

看到版本号即安装成功。

npm 备用安装方式

如果你的环境统一使用 npm，也可以运行：

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

npm 方式需要 Node.js。已经使用 npm 安装的用户可以继续使用，或运行 claude install stable 迁移到原生版本。

后续更新可以运行：

claude update

2. 配置环境变量（接入 SuperToken）

环境变量告诉 Claude Code 去哪里调用 AI 服务、使用哪个密钥。需要配置：

• ANTHROPIC_BASE_URL — SuperToken 网关地址
• ANTHROPIC_AUTH_TOKEN — 你的 SuperToken API Key

不想手动配置？

推荐使用 CC-Switch，图形界面填入 Key 即可，无需编辑任何配置文件。以下步骤适合习惯命令行操作的用户。

macOS 默认使用 Zsh，写入 Zsh 配置文件即可永久生效。

~/.zshrc 是 macOS 的 Shell 配置文件，每次打开终端都会自动加载。下面的命令会自动创建（如果不存在）并追加配置，直接复制粘贴到终端运行即可。

写入环境变量配置（请替换 API Key）：

{
  echo ''
  echo '# SuperToken'
  echo 'export ANTHROPIC_BASE_URL="https://api.supertoken.cc"'
  echo 'export ANTHROPIC_AUTH_TOKEN="你的SuperToken API Key"'
} >> ~/.zshrc

立即生效：

source ~/.zshrc

验证：

echo "$ANTHROPIC_BASE_URL"

应显示：https://api.supertoken.cc

以下命令将配置永久保存到用户级环境变量，重启不丢失。

设置网关地址：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.supertoken.cc","User")

设置 API Key（请替换占位符）：

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","你的SuperToken API Key","User")

关闭 PowerShell，重新打开一个新窗口，然后验证：

echo $env:ANTHROPIC_BASE_URL

应显示：https://api.supertoken.cc

根据你使用的 Shell 写入对应的配置文件。

不确定自己用的是哪个 Shell？运行 echo $SHELL，看到 /bin/bash 就是 Bash，看到 /bin/zsh 就是 Zsh。

~/.bashrc（Bash）和 ~/.zshrc（Zsh）是 Shell 配置文件，每次打开终端都会自动加载。下面的命令会自动创建（如果不存在）并追加配置，直接复制粘贴运行即可。

Bash 用户（大部分 Linux 默认）：

{
  echo ''
  echo '# SuperToken'
  echo 'export ANTHROPIC_BASE_URL="https://api.supertoken.cc"'
  echo 'export ANTHROPIC_AUTH_TOKEN="你的SuperToken API Key"'
} >> ~/.bashrc

Zsh 用户：

{
  echo ''
  echo '# SuperToken'
  echo 'export ANTHROPIC_BASE_URL="https://api.supertoken.cc"'
  echo 'export ANTHROPIC_AUTH_TOKEN="你的SuperToken API Key"'
} >> ~/.zshrc

使配置生效：

source ~/.bashrc  # Bash 用户
# 或
source ~/.zshrc   # Zsh 用户

验证：

echo "$ANTHROPIC_BASE_URL"

应显示：https://api.supertoken.cc

你必须将 你的SuperToken API Key 替换为从 SuperToken 控制台 复制的真实 Key。

3. 启动并验证

进入你的项目目录，启动 Claude Code：

claude

可选：先做一次环境检查：

claude doctor

正常对话只能证明当前会话拿到了回复。关闭并重新打开终端，再启动一次 Claude Code；同时在 SuperToken 控制台核对请求时间和模型，才算确认配置已保存且客户端确实走 SuperToken。遇到 401、403、404 或 429 时查看 统一错误决策表。

4. 下一步

• Claude Code 中文使用手册
• Claude Code 项目实战
• CLAUDE.md、设置与权限