跳到主要内容

Claude Code 本地安装指南

以Ubuntu 24.04 LTS实例

图片

修改为阿里云源

备份源

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

编辑：

sudo vim /etc/apt/sources.list

替换：

deb https://mirrors.aliyun.com/ubuntu/ noble main restricted universe multiverse
deb https://mirrors.aliyun.com/ubuntu/ noble-updates main restricted universe multiverse
deb https://mirrors.aliyun.com/ubuntu/ noble-backports main restricted universe multiverse
deb https://mirrors.aliyun.com/ubuntu/ noble-security main restricted universe multiverse

保存：

:wq

图片

更新：

sudo apt update
sudo apt upgrade -y

安装基础工具

sudo apt install -y \
curl \
wget \
git \
vim \
build-essential \
ca-certificates

检查：

git --version

图片

国内安装 Node.js（推荐）

Claude Code npm 方式需要 Node.js 18+。

Ubuntu 自带版本可能旧，推荐 nvm。

1. 安装 nvm（国内优化）

执行：

curl -fsSL -o- https://gitee.com/mirrors/nvm/raw/v0.40.1/install.sh | bash

图片

加载：

source ~/.bashrc

检查：

nvm -v

图片

设置国内 Node 镜像

  1. 写入镜像配置
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.bashrc
  1. 生效
source ~/.bashrc
  1. 加载 nvm（如果还没加载）
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
  1. 安装 Node.js（会走国内镜像）
nvm install 22
  1. 验证
node -v
npm -v

图片

配置 npm 国内源

查看：

npm config get registry

修改：

npm config set registry https://registry.npmmirror.com

验证：

npm config get registry

结果：

https://registry.npmmirror.com

图片

安装 Claude Code

npm安装:

官方支持：

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

安装完成：

claude --version

图片

启动：

claude

图片

国内连不上 Anthropic 官方

方案一：你有 HTTP 代理（如 clash/v2ray）

export HTTP_PROXY="http://你的代理IP:端口"
export HTTPS_PROXY="http://你的代理IP:端口"
export ANTHROPIC_API_KEY="sk-你的官方Key"
claude

方案二：你有 Anthropic 中转 API（推荐，无需代理）

export ANTHROPIC_API_KEY="sk-你的中转Key"
export ANTHROPIC_BASE_URL="https://你的中转地址"  # 不要带 /v1 后缀
claude

快速验证网络

测试能否连上 Anthropic（国内会超时）

curl -I --connect-timeout 5 https://api.anthropic.com

测试你的中转地址（应该能通）

curl -I --connect-timeout 5 https://你的中转地址

Claude Code 官方文档：

https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview

安装指南：https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/install

设置指南：https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/settings

命令参考：https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/commands

故障排除：https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/troubleshooting