Claude Code Linux 安装

Linux 上的流程和 macOS 基本一样，区别只在于大多数发行版默认用 bash，配置文件是 ~/.bashrc 而不是 ~/.zshrc。

0. 前置：Node.js 22+

node -v
npm -v

版本不够请回到 Node.js Linux 安装。如果 npm 全局安装一直报权限错误，强烈建议先装 nvm，把 Node 放进用户目录。

1. 安装 Claude Code

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

2. 配置环境变量

2.1 为什么要写进 shell 配置文件

每次开新终端，shell 会重新加载它的启动文件。我们把 export 语句写进去，就能保证 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 对后续所有命令都可见。

2.2 写入配置文件

先确认你用的是 bash 还是 zsh：

echo $SHELL

bash 分支：编辑 ~/.bashrc，在末尾追加：

export ANTHROPIC_BASE_URL="https://aitongdao.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

zsh 分支：编辑 ~/.zshrc，追加相同的两行。

2.3 让配置生效并验证

# bash
source ~/.bashrc

# zsh
source ~/.zshrc

然后：

echo "$ANTHROPIC_BASE_URL"
echo "$ANTHROPIC_AUTH_TOKEN"

两行都要有正确输出。

3. 启动并验证

claude doctor
claude

claude doctor 确认环境变量、网络可达性、认证结果。全通过后 claude 启动，随便发一句话确认模型返回正常。

常见问题

1）npm 全局安装权限错误

不要 sudo npm install -g。正确做法是装 nvm 把 Node.js 放到 ~/.nvm，或者用 npm config set prefix ~/.npm-global 把全局目录换成用户目录，然后把 ~/.npm-global/bin 加到 PATH。

2）source ~/.bashrc 之后还是读不到变量

检查是不是把 export 写错了（比如多了空格 export ANTHROPIC_BASE_URL = "..." 是错的，等号两边不能有空格）。另外有些桌面环境登录后用的是 .profile 而不是 .bashrc，实在排错不过来就把两份都加上。

3）claude: command not found

跑：

npm config get prefix

看输出的路径，比如 /home/you/.nvm/versions/node/v22.11.0。把 <prefix>/bin 加到 PATH：

export PATH="$HOME/.nvm/versions/node/v22.11.0/bin:$PATH"

（具体路径按你的实际输出换）。如果你用 nvm，通常 nvm 的初始化脚本会自动处理。

4）curl / fetch 报 SSL 错误

部分老版本 Linux 的 CA 根证书过期会导致 HTTPS 握手失败。更新系统的 ca-certificates 包即可：

sudo apt-get install --reinstall ca-certificates   # Debian/Ubuntu
sudo dnf reinstall ca-certificates                 # Fedora/RHEL