外观
安装Claude Code
约 723 字大约 2 分钟
次阅读
2026-01-20
记录一下 Claude Code 的安装方法，方便以后翻。
前置要求
安装前先确保满足这些条件：
- Node.js 18+ 或 20+（推荐用 nvm 管理）
- npm 或 yarn
- 一个 Anthropic 账号（需要注册并获取 API key）
为什么用 Claude Code？
在终端里直接用 Claude 帮你写代码、改 bug、执行命令，不用切换到浏览器。跟 AI 配合开发效率提升明显。
安装方法
方法一：全局安装（推荐）
直接安装到系统全局，任何项目都能用：
npm install -g @anthropic-ai/claude-code装完之后，在任意目录运行：
claude第一次运行会提示你登录，按指引操作就行。
登录时会发生什么？
会弹出一个浏览器窗口，让你登录 Anthropic 账号并授权。授权成功后，终端就可以用了。
方法二：使用 npx（临时使用）
不想全局安装的话，可以直接用 npx：
npx @anthropic-ai/claude-code适合偶尔用一下的情况。
方法三：项目本地安装
只想在某个项目里用：
npm install -D @anthropic-ai/claude-code然后在项目里运行：
npx claude配置 API Key
Claude Code 需要 API Key 才能工作。
获取 API Key
- 去 Anthropic Console
- 登录账号
- 进入 API Keys 页面
- 创建一个新的 API Key
设置 API Key
方法一：环境变量（推荐）
把 API Key 放到环境变量里：
# macOS/Linux - 添加到 ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_API_KEY="your_api_key_here"
# Windows - 使用 setx 命令
setx ANTHROPIC_API_KEY "your_api_key_here"方法二：配置文件
创建 ~/.claude/config.json：
{
"apiKey": "your_api_key_here"
}注意
API Key 要保密，别提交到 Git 仓库。记得把 .claude 目录加到 .gitignore。
常用命令
# 启动 Claude Code
claude
# 查看版本
claude --version
# 查看帮助
claude --help基本使用
启动后，直接在终端里跟 Claude 对话就行：
你: 帮我写一个快速排序
Claude: 好的，这是快速排序的实现...Claude Code 可以帮你：
- 写代码和改代码
- 执行终端命令
- 读写文件
- 搜索代码
- 调试问题
升级
定期升级到最新版本：
npm update -g @anthropic-ai/claude-code常见问题
安装失败
检查 Node.js 版本：
node --version确保是 18+ 或 20+。版本不对的话，用 nvm 升级：
nvm install 20
nvm use 20API Key 无效
确认 API Key 是否正确设置：
# macOS/Linux
echo $ANTHROPIC_API_KEY
# Windows
echo %ANTHROPIC_API_KEY%权限问题
如果安装时遇到权限问题，可能需要用 sudo（不推荐）或者修复 npm 权限：
# 修复 npm 权限（推荐）
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc卸载
不再需要的话，可以卸载：
npm uninstall -g @anthropic-ai/claude-code相关信息
配置文件和缓存数据会保留在 ~/.claude 目录，如果需要彻底清理可以手动删除这个目录。