Claude Code Linux 安装指南

专为 Linux 用户设计的 Claude Code 详细安装教程，包含 Ubuntu、WSL2 等环境。

第一步：安装 Node.js

Claude Code 需要 Node.js 运行环境，请参考详细的安装指南：

👉 Node.js 安装指南 - Linux 部分 - 包含 Ubuntu、CentOS、Arch、WSL2 等多个发行版的安装方法

ℹ️

安装完成后请返回此页面继续后续步骤。

第二步：安装 Claude Code

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

如果遇到权限错误，可以使用以下方法之一：

方法一：使用 sudo（简单但不推荐）

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

方法二：配置 npm 全局目录（推荐）

# 创建全局包目录
mkdir ~/.npm-global
 
# 配置 npm 使用新目录
npm config set prefix '~/.npm-global'
 
# 添加到 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
# 或者对于 zsh 用户
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
 
# 重新加载配置
source ~/.bashrc  # 或 source ~/.zshrc
 
# 现在安装 Claude Code
npm install -g @anthropic-ai/claude-code

验证安装

# 检查 Claude Code 版本
claude --version

第三步：配置环境变量

方法一：使用一键配置工具（推荐）

使用 aihezu 工具快速配置，这是最简单的方法：

sudo npx aihezu ccinstall

执行后会提示输入 API Key，工具会自动在 ~/.claude/settings.json 中配置好所有必需的环境变量。

该工具会自动配置 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL，无需手动设置环境变量。

方法二：手动设置环境变量

临时设置（当前会话）

export ANTHROPIC_BASE_URL="https://cc.aihezu.dev/api"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

永久设置

对于 Bash 用户

# 添加到 .bashrc
echo 'export ANTHROPIC_BASE_URL="https://cc.aihezu.dev/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
 
# 重新加载配置
source ~/.bashrc

对于 Zsh 用户

# 添加到 .zshrc
echo 'export ANTHROPIC_BASE_URL="https://cc.aihezu.dev/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
 
# 重新加载配置
source ~/.zshrc

系统级设置（可选）

# 创建系统级环境文件
sudo tee /etc/environment.d/claude.conf << EOF
ANTHROPIC_BASE_URL="https://cc.aihezu.dev/api"
ANTHROPIC_AUTH_TOKEN="你的API密钥"
EOF
 
# 重启后生效，或重新登录

🔐

重要：请将实际的代理地址和 API 密钥替换到配置中，我们会在购买服务后提供这些信息。

第四步：验证安装

检查环境变量

# 检查环境变量是否设置正确
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

测试 Claude Code

# 测试基本功能
claude "Hello, Claude!"

成功的话，你会看到 Claude 的回复。

第五步：VS Code 集成

详细的 VS Code 集成配置请参考：

👉 VS Code 集成指南 - 完整的编辑器集成教程

高级配置

创建配置文件

# 创建 Claude 配置目录
mkdir -p ~/.claude
 
# 创建配置文件
cat > ~/.claude/config.json << 'EOF'
{
  "editor": "vscode",
  "theme": "auto",
  "autoSave": true,
  "maxTokens": 4096,
  "suggestions": {
    "enabled": true,
    "maxSuggestions": 5
  }
}
EOF

设置代理（如需要）

# 设置 HTTP 代理
claude config set proxy.http http://proxy.example.com:8080
 
# 设置 HTTPS 代理
claude config set proxy.https https://proxy.example.com:8080
 
# 设置 SOCKS 代理
claude config set proxy.socks socks5://proxy.example.com:1080

故障排除

遇到安装或使用问题？查看详细的解决方案：

👉 故障排除指南 - 全面的问题诊断和解决方案

🗑️ 卸载指南

如需卸载 Claude Code，请参考：

👉 卸载指南 - 完整的卸载和清理说明

第一个项目

创建测试项目

# 创建新目录
mkdir ~/my-first-claude-project
cd ~/my-first-claude-project
 
# 初始化项目
claude init
 
# 开始对话
claude "帮我创建一个 Python Hello World 程序"

在 VS Code 中使用

详细的 VS Code 使用请参考 VS Code 集成指南

获取支持

遇到问题？我们提供专业技术支持：

💬 联系客服 - 一对一技术支持
🔍 故障排除 - 查看详细的问题解决方案

🎉

恭喜！ 你已在 Linux 上成功安装 Claude Code，现在可以开始 AI 辅助编程了！