跟着这个教程,你可以轻松在自己的电脑上安装并使用 Claude Code。
Claude Code 需要 Node.js 环境才能运行。
Windows 安装方法
方法一:官网下载(推荐)
- 打开浏览器访问
- 点击 “LTS” 版本进行下载(推荐长期支持版本)
- 下载完成后双击 文件
- 按照安装向导完成安装,保持默认设置即可
方法二:使用包管理器
如果你安装了 Chocolatey 或 Scoop,可以使用命令行安装:
Windows 注意事项
- 建议使用 PowerShell 而不是 CMD
- 如果遇到权限问题,尝试以管理员身份运行
- 某些杀毒软件可能会误报,需要添加白名单
验证安装是否成功
安装完成后,打开 PowerShell 或 CMD,输入以下命令:
如果显示版本号,说明安装成功了!
打开 PowerShell 或 CMD,运行以下命令:
这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。
提示
- 建议使用 PowerShell 而不是 CMD,功能更强大
- 如果遇到权限问题,以管理员身份运行 PowerShell
验证 Claude Code 安装
安装完成后,输入以下命令检查是否安装成功:
如果显示版本号,恭喜你!Claude Code 已经成功安装了。
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:
方法一:PowerShell 临时设置(当前会话)
在 PowerShell 中运行以下命令:
💡 记得将 “你的API密钥” 替换为在上方 “API Keys” 标签页中创建的实际密钥。
方法二:PowerShell 永久设置(用户级)
在 PowerShell 中运行以下命令设置用户级环境变量:
查看已设置的环境变量:
💡 设置后需要重新打开 PowerShell 窗口才能生效。
VSCode Claude 插件配置
如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:
配置文件位置:
💡 如果该文件不存在,请手动创建。
验证环境变量设置
设置完环境变量后,可以通过以下命令验证是否设置成功:
在 PowerShell 中验证:
在 CMD 中验证:
预期输出示例:
💡 如果输出为空或显示变量名本身,说明环境变量设置失败,请重新设置。
现在你可以开始使用 Claude Code 了!
启动 Claude Code
在特定项目中使用
安装时提示 "permission denied" 错误
这通常是权限问题,尝试以下解决方法:
- 以管理员身份运行 PowerShell
- 或者配置 npm 使用用户目录:
PowerShell 执行策略错误
如果遇到执行策略限制,运行:
环境变量设置后不生效
设置永久环境变量后需要:
- 重新启动 PowerShell 或 CMD
- 或者注销并重新登录 Windows
- 验证设置:
Claude Code 需要 Node.js 环境才能运行。
macOS 安装方法
方法一:使用 Homebrew(推荐)
如果你已经安装了 Homebrew,使用它安装 Node.js 会更方便:
方法二:官网下载
- 访问
- 下载适合 macOS 的 LTS 版本
- 打开下载的 文件
- 按照安装程序指引完成安装
macOS 注意事项
- 如果遇到权限问题,可能需要使用
- 首次运行可能需要在系统偏好设置中允许
- 建议使用 Terminal 或 iTerm2
验证安装是否成功
安装完成后,打开 Terminal,输入以下命令:
如果显示版本号,说明安装成功了!
打开 Terminal,运行以下命令:
如果遇到权限问题,可以使用 sudo:
验证 Claude Code 安装
安装完成后,输入以下命令检查是否安装成功:
如果显示版本号,恭喜你!Claude Code 已经成功安装了。
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:
方法一:临时设置(当前会话)
在 Terminal 中运行以下命令:
💡 记得将 “你的API密钥” 替换为在上方 “API Keys” 标签页中创建的实际密钥。
方法二:永久设置
编辑你的 shell 配置文件(根据你使用的 shell):
VSCode Claude 插件配置
如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:
配置文件位置:
💡 如果该文件不存在,请手动创建。
现在你可以开始使用 Claude Code 了!
启动 Claude Code
在特定项目中使用
安装时提示权限错误
尝试以下解决方法:
- 使用 sudo 安装:
- 或者配置 npm 使用用户目录:
macOS 安全设置阻止运行
如果系统阻止运行 Claude Code:
- 打开”系统偏好设置” → “安全性与隐私”
- 点击”仍要打开”或”允许”
- 或者在 Terminal 中运行:
环境变量不生效
检查以下几点:
- 确认修改了正确的配置文件(.zshrc 或 .bash_profile)
- 重新启动 Terminal
- 验证设置:
Claude Code 需要 Node.js 环境才能运行。
Linux 安装方法
方法一:使用官方仓库(推荐)
方法二:使用系统包管理器
虽然版本可能不是最新的,但对于基本使用已经足够:
Linux 注意事项
- 某些发行版可能需要安装额外的依赖
- 如果遇到权限问题,使用
- 确保你的用户在 npm 的全局目录有写权限
验证安装是否成功
安装完成后,打开终端,输入以下命令:
如果显示版本号,说明安装成功了!
打开终端,运行以下命令:
如果遇到权限问题,可以使用 sudo:
验证 Claude Code 安装
安装完成后,输入以下命令检查是否安装成功:
如果显示版本号,恭喜你!Claude Code 已经成功安装了。
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:
方法一:临时设置(当前会话)
在终端中运行以下命令:
💡 记得将 “你的API密钥” 替换为在上方 “API Keys” 标签页中创建的实际密钥。
方法二:永久设置
编辑你的 shell 配置文件:
VSCode Claude 插件配置
如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:
配置文件位置:
💡 如果该文件不存在,请手动创建。
现在你可以开始使用 Claude Code 了!
启动 Claude Code
在特定项目中使用
安装时提示权限错误
尝试以下解决方法:
- 使用 sudo 安装:
- 或者配置 npm 使用用户目录:
- 然后添加到 PATH:
缺少依赖库
某些 Linux 发行版需要安装额外依赖:
环境变量不生效
检查以下几点:
- 确认修改了正确的配置文件(.bashrc 或 .zshrc)
- 重新启动终端或运行
- 验证设置:
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/220354.html