Claude Code 安装指南(2026年最新版)
系统要求
最低配置
- 内存: 4GB RAM 或以上
- 网络: 需要活跃的互联网连接
- 操作系统:
- Windows 10+ (支持 WSL 或 Git Bash)
- macOS 10.15+
- Linux (Ubuntu 20.04+/Debian 10+, Alpine)
前置依赖
- Node.js: LTS 版本(推荐最新 LTS)
- npm: 随 Node.js 一起安装
第一步:检查和安装 Node.js
1.1 检查现有 Node.js 版本
打开命令提示符或终端,运行以下命令:
node --version
npm --version
1.2 如果未安装 Node.js
访问 Node.js 官方网站,下载并安装最新 LTS 版本。
1.3 验证安装
安装完成后,重新运行上述命令确认版本号显示正确。
打开 Git Bash / 终端,执行以下命令验证安装情况:
$ node -v
$ npm -v
第二步:安装 Claude Code CLI
2.1 Windows 用户 - PowerShell 方法
在 PowerShell 中运行以下命令:
irm https://claude.ai/install.ps1 | iex
2.2 Windows 用户 - CMD 命令行方法
使用 CMD 命令行运行以下命令:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
2.3 Windows 用户 - Git Bash 方法(推荐)
步骤 1:打开 Git Bash
- 在 Windows 资源管理器中打开任意文件夹
- 右键点击空白处
- 选择 "Git Bash Here"
- 或从开始菜单搜索并打开 "Git Bash"
步骤 2:在 Git Bash 中安装 Claude Code
在 Git Bash 终端中运行以下命令:
$ npm install -g @anthropic-ai/claude-code
//或者
curl -fsSL https://claude.ai/install.sh | bash
//如果已安装,卸载已安装的Claude Code(未安装请跳过)
$ npm uninstall -g @anthropic-ai/claude-code
步骤 3:验证安装
claude --version
应该显示类似输出:
Claude Code version X.X.X
步骤 4:配置中转 API
Mac / Linux 用户
步骤 1:打开终端
在终端中执行以下命令创建配置文件:
vim ~/.claude/settings.json
步骤 2:添加配置内容
在 vim 编辑器中按 i 进入插入模式,然后粘贴以下内容:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "粘贴为claude code专用分组令牌key",
"ANTHROPIC_BASE_URL": "https://aicodeditor.com",
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
},
"permissions": {
"allow": [],
"deny": []
}
}
步骤 3:保存并退出
- 按
Esc键退出插入模式 - 输入
:wq并按Enter保存并退出
步骤 4:验证配置
cat ~/.claude/settings.json
Windows 用户
步骤 1:打开 Git Bash 终端
- 在 Windows 资源管理器中打开任意文件夹
- 右键点击空白处
- 选择 "Git Bash Here"
步骤 2:创建配置文件
在 Git Bash 终端中执行以下命令:
vim ~/.claude/settings.json
步骤 3:添加配置内容
在 vim 编辑器中按 i 进入插入模式,然后粘贴以下内容:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "粘贴为claude code专用分组令牌key",
"ANTHROPIC_BASE_URL": "https://aicodeditor.com",
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
},
"permissions": {
"allow": [],
"deny": []
}
}
步骤 4:保存并退出
- 按
Esc键退出插入模式 - 输入
:wq并按Enter保存并退出
步骤 5:验证配置
cat ~/.claude/settings.json
配置参数说明
| 参数 | 说明 | 示例 |
|---|---|---|
ANTHROPIC_AUTH_TOKEN |
Claude Code 专用分组令牌密钥 | sk-ant-xxxxx |
ANTHROPIC_BASE_URL |
中转 API 的基础 URL | https://aicodeditor.com |
CLAUDE_CODE_MAX_OUTPUT_TOKENS |
最大输出令牌数 | 32000 |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC |
禁用非必要流量(1=启用,0=禁用) | 1 |
常见问题
问题 1:如何获取 ANTHROPIC_AUTH_TOKEN?
- 访问 Anthropic 控制台
- 进入 API 密钥管理
- 创建新的专用分组令牌
- 复制令牌并粘贴到配置文件中
问题 2:配置后需要重启吗?
是的,修改配置文件后需要重启 Claude Code:
# 关闭当前 Claude Code 会话
exit
# 重新启动 Claude Code
claude
问题 3:如何验证中转 API 是否生效?
# 查看 Claude Code 的日志
claude --debug
# 或检查环境变量是否正确加载
echo $ANTHROPIC_BASE_URL
步骤 5:配置 PATH(如果需要)
如果 claude 命令无法识别,需要将 Claude Code 添加到 PATH:
# 检查 Claude Code 安装位置
ls ~/.claude/bin/
# 添加到 PATH(临时)
export PATH="$HOME/.claude/bin:$PATH"
# 永久添加到 PATH,编辑 ~/.bashrc 或 ~/.bash_profile
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
2.4 macOS 和 Linux 用户
在终端中运行以下命令:
curl -fsSL https://claude.ai/install.sh | bash
2.5 验证安装
安装完成后,运行以下命令验证:
claude --version
Claude Code 应该被安装在以下位置之一:
- Windows:
%USERPROFILE%\.claude\bin\claude - macOS/Linux:
~/.claude/bin/claude或~/.local/bin/claude
第三步:身份验证和配置
3.1 初始化配置
运行以下命令启动配置过程:
claude config
3.2 选择身份验证方式
系统会提示你选择以下身份验证方式之一:
选项 A:使用 API 密钥
- 访问 Anthropic Console
- 登录你的账户
- 导航到 API 密钥部分
- 创建新的 API 密钥
- 复制密钥并粘贴到 Claude Code 配置中
选项 B:使用 OAuth
- 选择 OAuth 选项
- 浏览器会自动打开 Anthropic 登录页面
- 使用你的 Anthropic 账户登录
- 授权 Claude Code 访问权限
- 返回终端完成配置
3.3 保存配置
配置完成后,你的凭证将被安全地保存在本地。
第四步:项目初始化
4.1 创建或进入项目目录
mkdir my-project
cd my-project
4.2 初始化 Claude Code 项目
claude init
这将在项目目录中创建必要的配置文件。
第五步:启动第一个会话
5.1 开始交互式会话
claude
5.2 提出你的第一个问题
在提示符处输入你的问题或代码请求,例如:
> 帮我创建一个 Hello World 的 Python 脚本
5.3 查看 Claude 的响应
Claude 会提供代码建议和解释。
第六步:代码修改和文件操作
6.1 让 Claude 修改文件
你可以要求 Claude 创建或修改文件:
> 在 app.py 中添加一个计算器函数
6.2 审查更改
Claude 会显示建议的更改,你可以:
- 接受更改
- 拒绝更改
- 要求修改
6.3 自动应用更改
确认后,Claude 会自动将更改应用到你的文件。
第七步:Git 集成
7.1 初始化 Git 仓库
如果项目还没有 Git 仓库,运行:
git init
7.2 使用 Claude 进行版本控制
Claude Code 可以帮助你:
- 创建有意义的提交信息
- 管理分支
- 解决合并冲突
7.3 示例
> 帮我提交这些更改,提交信息为"添加用户认证功能"
第八步:高级配置(可选)
8.1 配置编辑器集成
Claude Code 支持与以下编辑器集成:
- VS Code
- Vim
- Neovim
- Emacs
8.2 设置模型偏好
claude config --model claude-opus-4-5
8.3 配置输出格式
根据需要调整输出格式和详细程度。
常见问题排查
问题 1:命令未找到 (Command not found)
解决方案:
- 确保 Node.js 已正确安装
- 重启终端或命令提示符
- 检查 PATH 环境变量是否包含 Claude Code 安装目录
问题 2:身份验证失败
解决方案:
- 确保网络连接正常
- 验证 API 密钥或 OAuth 凭证是否正确
- 运行
claude config重新配置
问题 3:权限被拒绝 (Permission Denied)
解决方案:
- 在 macOS/Linux 上,运行
chmod +x ~/.claude/bin/claude - 确保有足够的文件系统权限
问题 4:内存不足
解决方案:
- 关闭其他应用程序
- 升级系统内存
- 检查是否有其他进程占用大量资源
问题 5:无法连接到 Anthropic 服务
解决方案:
- 找到.claude.json文件,位置:C:\Users\用户名
- 输入
"hasCompletedOnboarding": true()//注意需不需要逗号
更新 Claude Code
检查更新
claude --version
更新到最新版本
claude update
或重新运行安装命令。
卸载 Claude Code
Windows 用户 - PowerShell 方法
Remove-Item -Path $env:USERPROFILE\.claude -Recurse -Force
Windows 用户 - Git Bash 方法(推荐)
步骤 1:打开 Git Bash
- 在 Windows 资源管理器中打开任意文件夹
- 右键点击空白处
- 选择 "Git Bash Here"
- 或从开始菜单搜索并打开 "Git Bash"
步骤 2:在 Git Bash 中卸载 Claude Code
在 Git Bash 终端中运行以下命令:
# 删除 Claude Code 安装目录
rm -rf ~/.claude
# 删除本地 bin 目录中的 Claude Code(如果存在)
rm -rf ~/.local/bin/claude
# 清理配置文件(可选)
rm -rf ~/.claude-config
步骤 3:验证卸载
# 检查 claude 命令是否仍然存在
which claude
如果显示 "not found" 或无输出,说明卸载成功。
步骤 4:清理 PATH(可选)
如果之前手动添加了 PATH,需要清理:
# 编辑 ~/.bashrc 文件
nano ~/.bashrc
# 找到并删除以下行:
# export PATH="$HOME/.claude/bin:$PATH"
# 保存并退出(Ctrl+O, Enter, Ctrl+X)
# 重新加载配置
source ~/.bashrc
macOS/Linux 用户
# 删除 Claude Code 安装目录
rm -rf ~/.claude
# 删除本地 bin 目录中的 Claude Code
rm -rf ~/.local/bin/claude
# 清理配置文件(可选)
rm -rf ~/.claude-config
验证卸载
运行以下命令确认卸载成功:
claude --version
如果显示 "command not found" 或类似错误,说明卸载成功。
完全卸载(包括所有配置和缓存)
如果需要完全删除所有 Claude Code 相关文件:
Git Bash 方法
# 删除所有 Claude Code 相关目录
rm -rf ~/.claude
rm -rf ~/.local/bin/claude
rm -rf ~/.claude-config
rm -rf ~/.cache/claude*
rm -rf ~/.config/claude*
# 清理环境变量(如果有)
unset CLAUDE_API_KEY
unset CLAUDE_HOME
PowerShell 方法
# 删除所有 Claude Code 相关目录
Remove-Item -Path $env:USERPROFILE\.claude -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item -Path $env:USERPROFILE\.local\bin\claude -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item -Path $env:USERPROFILE\.claude-config -Recurse -Force -ErrorAction SilentlyContinue
# 清理环境变量
[Environment]::SetEnvironmentVariable("CLAUDE_API_KEY", $null, "User")
[Environment]::SetEnvironmentVariable("CLAUDE_HOME", $null, "User")
获取帮助
查看帮助信息
claude --help
claude <command> --help
官方资源
报告问题
如果遇到问题,请在 GitHub 上报告:
https://github.com/anthropics/claude-code/issues
下一步
安装完成后,你可以:
- 探索示例项目 - 查看官方示例了解 Claude Code 的功能
- 阅读文档 - 深入了解高级功能
- 加入社区 - 与其他用户分享经验和最佳实践
- 开始编码 - 在你的项目中使用 Claude Code
最后更新: 2026年1月14日
版本: Claude Code 最新版本








这一切,似未曾拥有