Skip to content

Claude Code Linux 安装教程

系统支持

  • Windows
  • macOS
  • Linux / WSL2

1. 安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

Linux 安装方法

方法一:使用官方仓库(推荐)

bash
# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

方法二:使用系统包管理器

虽然版本可能不是最新的,但对于基本使用已经足够:

Ubuntu/Debian:

bash
sudo apt update
sudo apt install nodejs npm

CentOS/RHEL/Fedora:

bash
sudo dnf install nodejs npm

验证安装是否成功

bash
node --version
npm --version

如果显示版本号,说明安装成功了!

2. 安装 Claude Code

全局安装

打开终端,运行以下命令:

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

如果遇到权限问题,可以使用 sudo:

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

验证 Claude Code 安装

bash
claude --version

如果显示版本号,恭喜你!Claude Code 已经成功安装了。

3. 设置环境变量

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:

方法一:临时设置(当前会话)

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

方法二:永久设置

对于 bash (默认):

bash
echo 'export ANTHROPIC_BASE_URL="https://mycoding.cc/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc

对于 zsh:

bash
echo 'export ANTHROPIC_BASE_URL="https://mycoding.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

💡 记得将 "你的API密钥" 替换为实际密钥。

4. 开始使用 Claude Code

现在你可以开始使用 Claude Code 了!

启动 Claude Code

bash
claude

在特定项目中使用

bash
# 进入你的项目目录
cd /path/to/your/project

# 启动 Claude Code
claude

Linux 常见问题解决

安装时提示权限错误

尝试以下解决方法:

  • 使用 sudo 安装:sudo npm install -g @anthropic-ai/claude-code
  • 或者配置 npm 使用用户目录:npm config set prefix ~/.npm-global
  • 然后添加到 PATH:export PATH=~/.npm-global/bin:$PATH

缺少依赖库

某些 Linux 发行版需要安装额外依赖:

Ubuntu/Debian:

bash
sudo apt install build-essential

CentOS/RHEL:

bash
sudo dnf groupinstall "Development Tools"

环境变量不生效

检查以下几点:

  • 确认修改了正确的配置文件(.bashrc 或 .zshrc)
  • 重新启动终端或运行 source ~/.bashrc
  • 验证设置:echo $ANTHROPIC_BASE_URL

Linux 注意事项

  • 某些发行版可能需要安装额外的依赖
  • 如果遇到权限问题,使用 sudo
  • 确保你的用户在 npm 的全局目录有写权限

🎉 恭喜你!你已经成功安装并配置了 Claude Code,现在可以开始享受 AI 编程助手带来的便利了。

如果在使用过程中遇到任何问题,添加客服微信,寻求客服协助。