环境搭建与 Claude Code 安装

爱吃油鸡腿

11人浏览 · 2026-06-17 20:46:40

爱吃油鸡腿 · 2026-06-17 20:46:40 发布

创建日期：2026-06-09 系统：Ubuntu 26.04 LTS (Resolute Raccoon) — WSL2

一、系统初始配置

1.1 系统更新与换源

# 更新系统
sudo apt update && sudo apt upgrade -y

# 备份原有源配置
sudo cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak

# 更换为清华镜像源（大幅提升 apt 下载速度）
sudo sed -i 's|http://archive.ubuntu.com/ubuntu/|https://mirrors.tuna.tsinghua.edu.cn/ubuntu/|g' /etc/apt/sources.list.d/ubuntu.sources
sudo sed -i 's|http://ports.ubuntu.com/ubuntu-ports/|https://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/|g' /etc/apt/sources.list.d/ubuntu.sources

# 再次更新
sudo apt update && sudo apt upgrade -y

二、Node.js 环境搭建

2.1 安装 nvm (Node Version Manager)

方式一（首选）：官方安装脚本

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

方式二（备用）：通过 Gitee 镜像安装

git clone https://gitee.com/mirrors/nvm.git ~/.nvm
cd ~/.nvm
bash install.sh

注：由于网络原因，官方 curl 安装可能失败，最终使用的是 Gitee 镜像方式安装。

2.2 环境变量持久化

nvm 配置已自动写入 ~/.bashrc：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"   # 加载 nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # bash 补全

2.3 安装 Node.js

# 查看 nvm 版本
nvm --version

# 安装最新的 LTS 版本
nvm install --lts

# 使用 LTS 版本
nvm use --lts

# 验证安装
node -v   # → v24.16.0
npm -v

三、Claude Code 安装

3.1 通过 npm 全局安装

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

安装位置：

可执行文件：~/.nvm/versions/node/v24.16.0/bin/claude
全局 node_modules：~/.nvm/versions/node/v24.16.0/lib/node_modules/@anthropic-ai/claude-code/

当前版本：v2.1.168

3.3 应用配置

source ~/.bashrc

3.4 验证安装

claude          # 启动 Claude Code
which claude    # → /home/yjb/.nvm/versions/node/v24.16.0/bin/claude

四、项目初始化

4.1 创建工作目录

mkdir ~/ClaudeCodeProjections
cd ~/ClaudeCodeProjections/

4.2 配置 Claude Code 设置

# 创建项目级配置 settings.json
mkdir -p ~/.claude
vim ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash"
  },
  "language": "zh-CN"
}

五、uv 包管理器安装

5.1 安装 uv（Python 包管理器）

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env

# 验证版本
uv --version   # → uv 0.11.19 (x86_64-unknown-linux-gnu)

六、Claude Code 配置文件

6.1 全局配置 (`~/.claude.json`)

当前配置状态：

{
  "mcpServers": {},
  "enabledMcpjsonServers": [],
  "disabledMcpjsonServers": [],
  "hasTrustDialogAccepted": true,
  "projectOnboardingSeenCount": 1,
  "hasClaudeMdExternalIncludesApproved": false,
  "hasClaudeMdExternalIncludesWarningShown": false,
  "lastGracefulShutdown": true,
  "lastVersionBase": "2.1.168"
}

6.2：跳过 Onboarding 检查

vim ~/.claude.json

{
  "hasCompletedOnboarding": true
}

6.3 项目结构

~/ClaudeCodeProjections/
└──.claude/ # 项目级 Claude 配置（可选）
   └── settings.json

七、已安装环境清单

工具	版本	安装方式	用途
Ubuntu	26.04 LTS	WSL2	操作系统
nvm	v0.40.1	Git 安装	Node.js 版本管理
Node.js	v24.16.0 (LTS)	nvm install	JS 运行时
npm	随 Node.js	内置	包管理器
Claude Code	v2.1.168	npm global	AI 编码助手
uv	0.11.19	官方脚本	Python 包管理器（MCP 服务）

八、关键路径速查

Claude Code 可执行文件: ~/.nvm/versions/node/v24.16.0/bin/claude
nvm 目录:               ~/.nvm/
Node.js 目录:           ~/.nvm/versions/node/v24.16.0/
uv 目录:                ~/.local/bin/
全局配置:               ~/.claude/ 和 ~/.claude.json
项目配置:               .claude/settings.json
Bash 配置:              ~/.bashrc