本文说明如何安装 Claude Code，并把卡特 Token 站创建的 API Key 配置到 Claude Code 中。
Claude Code 的 Base URL 使用 https://api.cutaihub.com，不要追加 /v1。API Key 请使用支持 Claude Code 的令牌分组，不要选择「GPT生图专用」分组。

​
前置准备

开始前请先完成：
  • 已安装 Node.js 和 npm。
  • 已在卡特 Token 站创建 API Key。
  • API Key 分组支持 Claude Code 或 Claude 兼容请求。
如果还没有完成，可以先查看「Node.js和Git环境配置」和「创建和使用 APIKEY」。

​
安装 Claude Code

三系统都可以使用 npm 安装： 
npm install -g @anthropic-ai/claude-code
安装完成后验证： 
claude -v
能输出版本号就说明安装成功。

​
安装常见问题

​
permission denied 或 EACCES

macOS / Linux 不建议直接加 sudo 安装。可以把 npm 全局目录改到用户目录： 
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
如果使用 zsh，把 ~/.bashrc 换成 ~/.zshrc。 Windows 可以用管理员身份打开 PowerShell 后执行： 
npm config set prefix "$env:APPDATA\npm"
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

​
command not found: claude

通常是 npm 全局 bin 目录没有加入 PATH。先执行： 
npm config get prefix
确认该目录下的 bin 路径已经加入系统 PATH，然后重新打开终端。

​
配置 API Key

Claude Code 通过环境变量读取 Claude 兼容接口地址和鉴权 Token。

​
Windows

以管理员身份打开 PowerShell，执行： 
setx ANTHROPIC_BASE_URL "https://api.cutaihub.com"
setx ANTHROPIC_AUTH_TOKEN "你的API Key"
关闭并重新打开终端后验证： 
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

​
macOS / Linux

根据你使用的 shell，把下面配置写入 ~/.zshrc、~/.bashrc 或 ~/.bash_profile： 
export ANTHROPIC_BASE_URL="https://api.cutaihub.com"
export ANTHROPIC_AUTH_TOKEN="你的API Key"
让配置生效并验证： 
source ~/.zshrc
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
如果你写入的是 ~/.bashrc 或 ~/.bash_profile，source 对应文件即可。

​
开始使用

进入你的项目目录后启动 Claude Code： 
cd 你的项目目录
claude
首次启动可能会要求选择主题、确认是否信任当前目录或选择登录方式。看到输入框后，可以直接输入需求，例如： 
帮我阅读当前项目结构，并总结主要模块和启动方式。
常用命令：
  • /help：查看可用命令。
  • /clear：清空当前会话。
  • /exit：退出 Claude Code。

​
排查清单

如果请求失败，优先检查：
  • ANTHROPIC_BASE_URL 是否是 https://api.cutaihub.com。
  • ANTHROPIC_AUTH_TOKEN 是否是完整 API Key。
  • API Key 是否选择了支持 Claude Code 的分组。
  • 账号余额是否充足。
  • 终端是否在设置环境变量后重新打开过。