02 安装与配置

cuizhenjie2026-01-052026-01-05

开门见山

安装 Claude Code 其实挺简单的，比你想象中要容易得多。整个过程大概就 5 到 10 分钟，而且大部分时间可能在等下载，不是在折腾配置。

我这么说可能有点夸张，但确实不难。只要你会用命令行，有 Node.js，基本就能搞定。下面我一步步带你走。

安装前先检查一下

系统要求没什么特别的

不管你用的是 Mac、Linux 还是 Windows，基本都能装。

Mac 的话，系统版本得是 Big Sur (11.0) 或者更高。其实现在大家应该都满足了吧？如果你还在用很老的版本，那可能得先升级一下系统。

Linux 用户就随意了，Ubuntu、Debian、CentOS、Fedora 这些主流发行版都没问题。只要你能在终端里敲命令就行。

Windows 用户的话，我有两个建议。第一，如果你在用 WSL（Windows Subsystem for Linux），那就按 Linux 的步骤来，没问题。第二，如果你只用 Windows 自带的 PowerShell，也行，但我觉得 WSL 会更好用一些。

Node.js 得有

这个很重要：Claude Code 需要 Node.js 20.19.0 或者更高版本。

先看看你装了没：

1	node --version

如果版本号是 v20.x.x 或者更高，那就 OK 了。如果版本太低或者压根没装，那就得处理一下。

最简单的方法是去 nodejs.org 下载最新的 LTS 版本。但我个人更推荐用 nvm（Node Version Manager），这个工具能让你在一台电脑上装多个 Node.js 版本，想切哪个切哪个，特别方便。

安装 nvm 就一行命令：

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

装完之后，再装最新的 Node.js：

1 2	nvm install --lts nvm use --lts

搞定。

还得有个 API 密钥

这个是必须的，没有的话 Claude Code 没法工作。

去 console.anthropic.com 注册个账号（如果你还没有的话）。然后在 API Keys 那里点 Create Key，就能生成一个密钥。

密钥长这样：sk-ant-xxxxx。

注意一下：这个密钥只会显示一次，所以你最好复制下来存个档。不然下次还得重新生成，挺麻烦的。还有，千万别把密钥传到 GitHub 或者任何公开的地方，这是常识了。

好了，开始安装

装法其实就一行命令：

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

等它跑完之后，验证一下：

1	claude --version

如果能看到版本号，那就说明装好了。挺简单的吧？

Mac 和 Linux 用户注意

如果上面的命令报错了，提示什么权限问题，那就得用一下 sudo：

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

这个你应该懂的。

Windows 用户看这里

如果你在用 PowerShell，命令跟上面一样，没问题：

1 2	npm install -g @anthropic-ai/claude-code claude --version

如果你用的是 WSL，那就按 Linux 的方式来，一样的。

配置一下 API 密钥

装好了，但还不能用，得告诉 Claude Code 你的 API 密钥是什么。

推荐方案：环境变量

我推荐用环境变量，这样最安全，也最不容易出问题。

如果你在用 Mac 或者 Linux（bash/zsh），那就把这个加到你的 ~/.bashrc 或者 ~/.zshrc 文件里：

1	export ANTHROPIC_API_KEY="sk-ant-your-api-key-here"

然后让它生效：

1
2
3

source ~/.bashrc
# 或者
source ~/.zshrc

如果你在用 Windows PowerShell，那就在你的 PowerShell 配置文件（通常是 $PROFILE）里加：

1	$env:ANTHROPIC_API_KEY="sk-ant-your-api-key-here"

如果你懒得折腾配置文件，也可以直接设置系统环境变量：

右键点 此电脑 → 属性
高级系统设置 → 环境变量
在 用户变量 里新建一个：
- 变量名：ANTHROPIC_API_KEY
- 变量值：你的 API 密钥

备选方案：配置文件

如果你不想用环境变量，也可以建个配置文件：

# 创建配置文件
mkdir -p ~/.claude
echo '{"apiKey": "sk-ant-your-api-key-here"}' > ~/.claude/config.json

# 设置权限（只有你能读写）
chmod 600 ~/.claude/config.json

这个方法也行，就是不太推荐，因为配置文件明文存储密钥，安全性稍微差一点。

不推荐的方式

你也可以每次运行时手动指定密钥：

1	claude --api-key sk-ant-your-api-key-here

但这个方法太麻烦了，也不安全（命令会被 Shell 记录），所以我真不推荐。

测试一下能不能用

好了，现在可以试试了：

# 看看版本号
claude --version

# 简单测试一下
echo "Hello, Claude!" | claude "请重复这句话"

如果能看到版本号，而且第二个命令能正常返回，那就说明一切正常！

遇到问题了？别慌

安装过程其实挺顺利的，但偶尔也会出点小问题。别担心，大部分问题都能很快解决。

报错了，说没权限？

如果你看到类似这样的错误：

1 2	npm ERR! code EACCES npm ERR! path /usr/local/lib/node_modules/@anthropic-ai/claude-code

那说明权限不够。用 sudo 就能解决：

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

如果你不想用 sudo（或者 sudo 还是报错），那可以换个思路。创建一个属于你自己的 npm 全局目录：

# 创建目录
mkdir ~/.npm-global

# 告诉 npm 用这个目录
npm config set prefix '~/.npm-global'

# 把这个目录加到 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 重新安装
npm install -g @anthropic-ai/claude-code

这样以后你就再也不用 sudo 了，而且更安全。

找不到 claude 命令？

如果你敲 claude 系统说找不到命令，那通常是 PATH 没配置好。

先看看 npm 全局安装路径是啥：

1	npm config get prefix

如果是 /usr/local，那应该会安装到 /usr/local/bin/claude。你可以看看这个目录在不在你的 PATH 里：

1	echo $PATH \| grep -o "/[^:]*bin"

如果不在，那就加上：

1 2	# 在 ~/.bashrc 或 ~/.zshrc 中 export PATH=$PATH:/usr/local/bin

如果你用了我上面说的 ~/.npm-global 方案，那就是：

1	export PATH=$PATH:~/.npm-global/bin

Node.js 版本太老？

如果你看到这样的错误：

1	Error: Claude Code requires Node.js version 20.19.0 or higher

那就得升级 Node.js 了。用 nvm 最方便：

# 安装 nvm（如果还没装）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

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

API 密钥不工作？

如果你看到 “Invalid API key” 之类的错误：

先检查一下密钥是不是复制对了，应该以 sk-ant- 开头
确认环境变量设置好了没有：
1
echo $ANTHROPIC_API_KEY
如果你用的配置文件，检查一下文件路径和 JSON 格式对不对
去确认一下密钥在 Anthropic Console 里是不是还生效

网络连不上？

如果你看到 “Failed to connect” 之类的错误：

先确认一下网络没问题

如果你用代理，得设置一下代理：

1 2	export HTTP_PROXY=http://your-proxy:port export HTTPS_PROXY=http://your-proxy:port

检查一下防火墙有没有阻止访问 Anthropic API

后期维护

卸载（如果你不用了）

如果你想卸载 Claude Code：

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

# 如果你想把配置也删了
rm -rf ~/.claude

升级（推荐）

Claude Code 会不定期更新，建议你时不时升级一下：

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

# 或者直接重装最新版
npm install -g @anthropic-ai/claude-code@latest

高级配置（可选）

如果你想自定义一些配置，可以创建 ~/.claude/config.json：

{
  "apiKey": "sk-ant-your-api-key-here",
  "model": "claude-3-5-sonnet-20241022",
  "maxTokens": 4096,
  "temperature": 0.7,
  "timeout": 120000
}

这个配置文件能调整几个参数：

model：用哪个模型。默认用的是 claude-3-5-sonnet-20241022，平衡性能和速度。如果你想更快，可以用 haiku 模型；如果你想要最强性能，可以用 opus 模型（但会慢一些）。
maxTokens：回复的最大长度。默认 4096，一般够用了。如果你需要更长的回复，可以调大一些。
temperature：这个控制回复的”创造性”。0 到 1 之间，默认 0.7。如果你想要更确定的答案，就调低一点；如果你想要更多样化的输出，就调高一点。
timeout：超时时间，单位是毫秒。默认 120 秒（2 分钟）。如果网络不好或者任务比较复杂，可以调大一些。