Claude Code - Linux 系统安装教程

前置准备

在开始之前，请确保：

1. 已安装 Node.js 18 或更高版本
   • 如果尚未安装，请查看 Node.js 安装教程
2. 已在 https://ai.gaoxiao888.com 注册账号并获取 API Key

第一步：安装 Claude Code

打开终端，执行以下命令：

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

安装完成后，验证安装：

claude --version

第二步：配置环境变量

Linux 系统有三种配置方式，推荐使用方法 3。

方法 1：临时设置（仅当前终端有效）

在终端中执行：

export ANTHROPIC_BASE_URL="https://ai.gaoxiao888.com/claude"
export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"

方法 2：永久设置

根据你使用的 shell 类型选择：

如果使用 bash：

echo 'export ANTHROPIC_BASE_URL="https://ai.gaoxiao888.com/claude"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"' >> ~/.bashrc
source ~/.bashrc

如果使用 zsh：

echo 'export ANTHROPIC_BASE_URL="https://ai.gaoxiao888.com/claude"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"' >> ~/.zshrc
source ~/.zshrc

方法 3：配置 settings.json（推荐）

1. 创建配置文件：

mkdir -p ~/.claude
nano ~/.claude/settings.json

2. 输入以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换为您的API Key",
    "ANTHROPIC_BASE_URL": "https://ai.gaoxiao888.com/claude",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

3. 按 Ctrl + O 保存，按 Ctrl + X 退出

注意：将 替换为您的API Key 改为你在官网生成的实际 API Key

第三步：验证配置

在终端中执行：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

如果显示正确的值，说明配置成功。

第四步：启动 Claude Code

在终端中执行：

claude

首次启动会进入交互模式，你可以开始与 Claude Code 对话了！

常见问题

1. 提示找不到 claude 命令

确保 Node.js 的全局包路径已添加到系统 PATH 中：

echo $PATH
npm config get prefix

2. 权限问题

如果遇到权限错误，可以：

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

或者配置 npm 使用用户目录：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

3. 401 认证错误

检查 API Key 是否正确配置，确保没有多余的空格或引号。

下一步

• IDE 集成教程 - 在 VSCode 或 JetBrains 中使用
• 功能详解 - 了解更多强大功能