MacOS/Linux ClaudeCode安装指南

在 MacOS 或 Linux 系统上安装官方 Claude Code CLI

系统要求

MacOS 10.15+ 或 Ubuntu 20.04+/Debian 10+ 等 Linux 系统，Node.js 18+，并已准备 apirelay.aiserverapp.com 的 API Key

安装步骤

1

打开终端

MacOS 可使用 Cmd+Space 搜索 "Terminal"，Linux 直接打开系统终端

2

检查 Node.js 与 npm

Claude Code 的 npm 安装方式需要 Node.js 18 或更新版本

$ node -v
$ npm -v
3

安装或更新 Claude Code

直接使用 npm 全局安装，不要在命令前添加 sudo

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

获取 apirelay.aiserverapp.com API Key

访问 https://apirelay.aiserverapp.com/console，在令牌管理处，添加令牌并复制密钥出来

5

写入中转 API 环境变量

下面会把中转地址和 API Key 写入当前 Shell 配置文件，重启终端后仍然生效

$ RC_FILE="$HOME/.zshrc"
$ [ -n "$BASH_VERSION" ] && RC_FILE="$HOME/.bashrc"
$ {
  echo ''
  echo 'export ANTHROPIC_BASE_URL="https://apirelay.aiserverapp.com"'
  echo 'export ANTHROPIC_AUTH_TOKEN="你的API_KEY"'
  echo 'export ANTHROPIC_API_KEY="你的API_KEY"'
} >> "$RC_FILE"
$ source "$RC_FILE"
6

验证安装和中转配置

确认环境变量已生效，并用 Claude Code 发起一次最小请求

$ echo $ANTHROPIC_BASE_URL
$ claude -v
$ claude -p "请只回复：配置成功"

开始使用

配置完成后，您可以在任何项目目录中通过中转 API 使用 Claude Code:

# 导航到您的项目
$ cd your-project-folder

# 启动 Claude Code
$ claude