返回使用文档

Claude Code / Linux

Claude Code Linux 使用教程

在 Linux 上安装 Claude Code,并配置 shell 环境或 settings.json。

推荐分组
【Claude】官方渠道 仅限cc
推荐模型
claude-opus-4-8
还没有登录?
去登录

一、安装 Node.js 环境

方法一:NodeSource。

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

方法二:系统包管理器。

sudo apt update
sudo apt install nodejs npm

验证安装:

node --version
npm --version

二、安装 Claude Code

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

如果当前用户没有全局安装权限,可以用 sudo:

sudo npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

验证安装:

claude --version

三、配置 Claude Code

如果你用 bash:

echo 'export ANTHROPIC_BASE_URL="https://bgp.routix.cn"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxxx"' >> ~/.bashrc
source ~/.bashrc

如果你用 zsh:

echo 'export ANTHROPIC_BASE_URL="https://bgp.routix.cn"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxxx"' >> ~/.zshrc
source ~/.zshrc

也可以编辑 ~/.claude/settings.json。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bgp.routix.cn",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxx",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

四、开始使用

claude

第一次建议先输入:

如果你已经接到 RouTix,请只回复:【Claude】官方渠道 仅限cc 已连接

五、常见问题

  • 全局安装报权限错误:优先用 sudo,或者把 npm 全局目录切到用户目录。
  • 环境变量不生效:重新打开终端,或者手动执行 source ~/.bashrc。
  • 鉴权失败:确认 ANTHROPIC_AUTH_TOKEN 里的 Key 没有复制错。
  • Claude 模型请求失败:先去控制台确认当前令牌能否使用 【Claude】官方渠道 仅限cc。
  • 模型不可用:回主站检查你的账户是否已开通对应 Claude 模型。