claude code安装教程:Windows/macOS/Linux安装与使用攻略

一篇看完就能装好、马上能用的实战教程。新手友好，全程避坑。

一、先搞清楚：Claude Code 到底是什么？

Claude Code 是 Anthropic 官方推出的命令行 AI 编程工具。

它和网页版的 Claude 最大的不同在于——它不是聊天窗口，而是直接跑在你的终端里：能读取整个项目目录、理解代码结构、修改文件、执行命令、帮你写提交信息、辅助调试。

一句话总结：它是能干活的 AI 编程搭子，而不只是陪你聊天的机器人。

⚠️ 别搞混了三个"Claude"：

产品	定位
Claude Code	终端里的编程 Agent（本文主角）
claude.ai	网页版聊天，偏问答/写作
Claude Desktop	桌面 App，持久化工作流

二、安装前的准备（先自检，成功率翻倍）

组件	要求	检查命令
操作系统	macOS 10.15+ / Ubuntu 20.04+ / Windows 10+	uname -a 或 winver
Node.js	v18 或更高	node -v
npm	随 Node 自带	npm -v
内存	4GB 以上	—

Windows 用户特别注意：Claude Code 无法在原生 CMD / PowerShell 里直接跑，必须用 WSL 或 Git Bash。

三、三步安装法

第 1 步：安装 Node.js（已有 ≥18 可跳过）

macOS（推荐 nvm v0.40.5）：

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

小贴士：你可以去 nvm 官方发布页查看最新的版本号，将上述命令中的

v0.40.5

替换为最新版本。

⚠️ 关键一步：配置 Shell

安装脚本一般会自动在

~/.zshrc

配置文件中添加环境变量。如果安装后终端提示

nvm: command not found

，请手动检查并添加以下内容到

~/.zshrc

文件：

vim ~/.zshrc

export NVM_DIR="$HOME/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

完成后，执行以下命令使配置生效并验证：

source ~/.zshrcnvm -v

如果正确输出了nvm的版本号，恭喜你，第一步完成！🎉

安装 Node.js

使用刚刚装好的 nvm 来安装最新版本的 Node.js，并将其设置为默认版本。

安装最新LTS版本nvm install --lts设为默认版本（新开的终端也将使用这个版本）nvm alias default 'lts/*'验证安装node -v && npm -v

一些常用的 nvm 命令：

nvm ls# 查看系统已安装的所有Node.js版本nvm use 20            # 临时切换到Node.js 20版本nvm install 20        # 安装Node.js 20版本

重要提醒：一旦开始使用 nvm 管理 Node.js，就不要再使用 Homebrew 安装 Node.js，两者可能会发生冲突，导致版本管理混乱。

Ubuntu / Debian：

curl -fsSLhttps://deb.nodesource.com/setup_lts.x| sudo -E bash -
sudo apt-get install -y nodejs

装完确认版本：

node --version

需要 ≥ 18.0

第 2 步：安装 Claude Code

三大平台通用命令（Windows 请在 WSL / Git Bash 里执行）：

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

🚨 重要警告：千万不要用 sudo 安装！sudo npm install -g 会引发权限混乱和安全隐患。遇到 EACCES 权限错误，正确做法是修复 npm 权限配置，而不是加 sudo。

验证安装：

claude --version

mac配置环境变量

vim ~/.zshrc
export ANTHROPIC_BASE_URL="http://xxxxxx"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx

source ~/.zshrc

第 3 步：Windows 用户的 WSL 配置

如果你是 Windows，先把环境准备好：

wsl --install

管理员身份打开 PowerShell
执行命令安装：

安装 WSL + Ubuntu 后执行配置：

wsl --set-default Ubuntu # 关键：确保默认发行版是 Ubuntu
wsl --list --verbose # 带 * 号的就是默认

然后进入 Ubuntu 终端，回到第 1、2 步走一遍即可。

四、登录 / 配置账户并启动

在你的项目目录下运行：

cd your-project-folder
claude

首次启动会引导你完成登录、选择主题、确认安全须知。按提示走完，就能开始和你的 AI 编程搭档对话了 🚀

提示：始终在项目根目录启动 claude，它能获取最完整的代码库上下文，判断更准。

五、常用命令速查

命令	作用
claude	启动交互式会话（REPL）
claude -p "重构这个函数"	一次性查询，适合写进脚本
claude doctor	健康检查，排查安装问题
claude update	手动更新到最新版
/clear	清除当前会话上下文
/init	生成 CLAUDE.md 项目记忆文件
/review @file.py	让 Claude 审查代码
/cost	查看 token 用量与预估费用

管道用法也很香，比如一键总结日志错误：

cat server.log | claude -p "总结这份日志中的所有错误信息"

六、IDE 集成（可选，但真香）

核心逻辑：CLI 是引擎，插件是界面。插件出问题时，先确认 claude 命令能否在集成终端正常运行。

VS Code（成熟稳定）：在项目里打开集成终端运行 claude，会自动提示安装扩展。支持在 diff 视图里审查和应用代码变更，体验远胜终端。

JetBrains（Beta）：在 Settings → Plugins 搜索 "Claude Code" 安装。功能类似，但仍在测试阶段，注意 Node 版本冲突问题。

写在最后

Claude Code 代表了编程辅助工具从"补全建议"走向"自主代理"的方向。装好之后，多用几次 /init 和 diff 审查，你会越用越顺手。