《油菜花的Claude Code快速上手指南》— 安装与运行 Claude Code

345 阅读3分钟

❤️ 如果你也关注 AI 的发展现状,且对 AI 应用开发感兴趣,我会跟你分享大模型与 AI 领域的开源项目和应用,提供运行实例和实用教程,帮助你快速上手AI技术!也非常欢迎你通过公众号发消息加入我们!

❤️ 微信公众号|搜一搜:蚝油菜花


前提

在安装 Claude Code 之前,你需要先安装Node.js 18 或更新版本

目前,Claude Code 不能直接在 Windows 中运行,而是需要 WSL。

如果你是Windows用户,那么还需要安装Git for Windows,使用 Git Bash 来安装 Claude Code

Claude Code 使用 Shell 作为运行环境,官方推荐的最佳运行环境为 Bash、Zsh 或 Fish;Windows用户推荐使用 Git Bash 作为运行环境。

安装

打开命令行工具,输入命令全局安装 Claude Code:

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

国内推荐通过阿里提供的npm镜像安装:

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

注意不要使用sudo npm install -g,因为这可能导致权限问题和安全风险。

运行

安装完成后,导航到你的项目:

cd your-project

开始使用 Claude Code:

claude

当终端输出Welcome to Claude Code 时则表示运行成功:

Welcome to Claude Code

踩坑记录——command not found: claude

使用全局安装的 npm 包需要确保 Shell 能正确识别 npm 全局路径。当你遇到类似command not found: claude的问题时,可以尝试以下流程进行排查。

1. 找到 npm 全局安装路径

运行命令:

npm config get prefix

导航到该路径下,你可以看到有全局安装的可执行文件(如 claude、claude.cmd 等)。

2. 将 npm 全局路径添加到 Shell 的 PATH 变量

Windows(Git Bash)

检查当前 PATH:

echo $PATH

看看是否包含 npm 全局路径(如/c/Users/你的用户名/AppData/Roaming/npm)。

如果不在 PATH 中,手动添加:

echo 'export PATH="$PATH:/c/Users/你的用户名/AppData/Roaming/npm"' >> ~/.bashrc

然后重新加载配置:

source ~/.bashrc

MacOS(Zsh)

检查当前 PATH:

echo $PATH

看看是否包含 npm 全局路径(如/usr/local/bin)。

如果不在 PATH 中,手动添加:

echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.zshrc

然后重新加载配置:

source ~/.zshrc

完成上述步骤后建议再次检查 PATH,确保你的 npm 全局路径已被包含。

写在最后

这里是蚝油菜花,Claude官方下场开发AI Coding Cli我个人觉得不仅是对此前如日中天的Cursor发起冲击,更是暗示着未来会有越来越多大模型厂商开始关注将模型能力下放到业务场景,比如此前来自字节颇有热度的Trea、亦或是最近腾讯推出的CodeBuddy IDE。

最近由于Cursor的恶心事实在太多了,前有背刺订阅用户暗中降速,后有OpenAI、Claude、Gemini大模型相继封锁国区,我选择了取消订阅,转向使用Claude Code。在编辑完此篇文章后,我打算单开一个原创专栏《油菜花的Claude Code快速上手指南》,欢迎感兴趣的小伙伴关注,一起学习,一起进步!

❤️ 感谢阅读!


❤️ 如果你也关注 AI 的发展现状,且对 AI 应用开发感兴趣,我会跟你分享大模型与 AI 领域的开源项目和应用,提供运行实例和实用教程,帮助你快速上手AI技术!也非常欢迎你通过公众号发消息加入我们!

❤️ 微信公众号|搜一搜:蚝油菜花