CLAUDE CODE

Claude Code - Linux 安装配置

在 Linux 系统安装和配置 Claude Code，并使用千模岛 API 服务。

#前置要求

Linux 系统与管理员或 sudo 权限
稳定的互联网连接
千模岛 API 账户与 Claude Code 专用分组令牌

#步骤 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

# 系统级 Node.js
sudo npm install -g @anthropic-ai/claude-code

# 使用 nvm 时不需要 sudo
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

权限问题

Windows 请使用管理员终端；macOS/Linux 使用系统级 npm 时可加 sudo，使用 nvm 时不需要 sudo。

#步骤 3：配置 API 端点

Claude Code 地址不带 /v1

使用 https://www.qianmodao.com，不要填写 https://www.qianmodao.com/v1。

创建配置目录：

mkdir -p ~/.claude
cd ~/.claude

创建 settings.json：

配置文件位置：~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_API_KEY": "粘贴为Claude Code专用分组令牌key",
    "ANTHROPIC_BASE_URL": "https://www.qianmodao.com"
  },
  "model": "自行选择一个该Claude Code分组支持的model（在模型广场查看）"
}

chmod 600 ~/.claude/settings.json

#步骤 4：设置 API 密钥

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

# Bash
echo 'export ANTHROPIC_API_KEY="你的千模岛_API令牌"' >> ~/.bashrc
source ~/.bashrc

# Zsh
echo 'export ANTHROPIC_API_KEY="你的千模岛_API令牌"' >> ~/.zshrc
source ~/.zshrc

# Fish
echo 'set -gx ANTHROPIC_API_KEY "你的千模岛_API令牌"' >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish

#方法 2：配置文件

也可以直接使用前面的 ~/.claude/settings.json。请妥善保管 API 密钥，不要将配置文件提交到版本控制系统。

#步骤 5：验证配置

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

如果配置正确，Claude Code 会正常响应。

#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

# 代码审查
claude ultrareview

#快捷键（VSCode）

Ctrl+Shift+C：打开 Claude 面板
Ctrl+Shift+A：分析当前文件
Ctrl+Shift+G：生成代码
Ctrl+K Ctrl+C：生成代码注释

#故障排除

#问题：权限被拒绝

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

#问题：命令未找到

npm config get prefix
echo $PATH
which claude

#问题：SSL 证书错误

sudo apt update && sudo apt install ca-certificates
sudo dnf install ca-certificates

#问题：网络连接问题

export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"

#系统服务说明

Claude Code 没有 daemon 服务模式；自动化任务可使用 claude --print 配合脚本或 CI。

#下一步

提示

Linux 用户可使用 npm 保持工具更新：sudo npm update -g @anthropic-ai/claude-code