Claude Code — Linux 安装配置

本指南帮助你在 Linux 上安装并配置 Claude Code，接入 TinyPx API 服务。

前置要求

• Linux 发行版（Ubuntu 20.04+、Debian 11+、Fedora 35+、Arch Linux 等）
• Node.js 18.0 或更高版本
• npm 包管理器
• curl 或 wget

步骤 1：安装 Node.js

Ubuntu / Debian

# 使用 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 或使用 snap
sudo snap install node --classic

Fedora / RHEL / CentOS

# 使用 NodeSource 仓库
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo dnf install -y nodejs

# 或使用 dnf 模块
sudo dnf module install nodejs:20

Arch Linux

sudo pacman -S nodejs npm

通用方法：nvm

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载 shell 配置
source ~/.bashrc  # 或 ~/.zshrc

# 安装 Node.js
nvm install 20
nvm use 20

验证安装：

node --version
npm --version

步骤 2：安装 Claude Code CLI

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

如果用 nvm 管理 Node，不需要 sudo：

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

验证安装：

claude --version

步骤 3：配置 API 端点

mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_API_KEY": "粘贴为 Claude Code 专用分组令牌 key",
    "ANTHROPIC_BASE_URL": "https://ai.tinypx.cn"
  },
  "model": "填写该 Claude Code 分组支持的模型名"
}
EOF

注意端点格式

Claude Code 不带 /v1 后缀 —— 使用 https://ai.tinypx.cn， 而不是 https://ai.tinypx.cn/v1。详见 API 端点说明。

具体可用模型请到 模型广场 查阅对应分组支持的 model。

步骤 4：设置 API 密钥

方法 1：环境变量（推荐）

Bash：

echo 'export ANTHROPIC_API_KEY="你的 TinyPx API 令牌"' >> ~/.bashrc
source ~/.bashrc

Zsh：

echo 'export ANTHROPIC_API_KEY="你的 TinyPx API 令牌"' >> ~/.zshrc
source ~/.zshrc

Fish：

echo 'set -gx ANTHROPIC_API_KEY "你的 TinyPx API 令牌"' >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish

方法 2：写进配置文件

{
  "env": {
    "ANTHROPIC_API_KEY": "你的 TinyPx API 令牌",
    "ANTHROPIC_BASE_URL": "https://ai.tinypx.cn"
  },
  "model": "填写该 Claude Code 分组支持的模型名"
}

设置安全权限：

chmod 600 ~/.claude/settings.json

重要

确保密钥文件权限为 600，防止同机其他用户读取。

步骤 5：验证配置

claude "你好，请介绍一下你自己"

VSCode 集成（可选）

安装 VSCode

Ubuntu / Debian：

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg
sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
sudo apt update
sudo apt install code

Fedora / RHEL：

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo'
sudo dnf install code

Arch Linux：

yay -S visual-studio-code-bin

配置 VSCode

安装 Claude Code 扩展后，继续使用前面的 ~/.claude/settings.json 即可，不需要单独填写 claude.apiBaseUrl 或 claude.apiKey。

常用命令

# 启动交互式会话
claude

# 非交互式输出
claude --print "请审查 src/ 目录并列出主要问题"

# 查看帮助
claude --help

故障排除

权限被拒绝

推荐改用户级 npm 目录，避免 sudo：

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

# 重新安装
npm install -g @anthropic-ai/claude-code

命令未找到

echo $PATH
which claude
export PATH="$PATH:$(npm config get prefix)/bin"

SSL 证书错误

sudo apt update && sudo apt install ca-certificates  # Ubuntu/Debian
sudo dnf install ca-certificates                     # Fedora
sudo pacman -S ca-certificates                       # Arch

网络连接问题

# 测试端点连通性
curl -I https://ai.tinypx.cn

# 配置代理（如需要）
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"

系统服务说明

Claude Code 没有 daemon 服务模式。如果需要自动化任务，请使用 claude --print 配合脚本或 CI。

下一步

• Windows 安装指南
• macOS 安装指南
• Codex 配置
• 常见问题

提示

用包管理器保持工具更新：sudo npm update -g @anthropic-ai/claude-code