夜雨聆风Claude Code 保姆级教程｜一键安装+配置+MCP工具全攻略，程序员零踩坑上手
前言
Claude Code 是Anthropic推出的智能编程工具，能实现代码审查、错误排查、项目初始化，还能通过MCP工具扩展地图、天气、高级搜索等功能，搭配智谱API使用更流畅。
很多人反馈“安装难、配置繁”，其实只要跟着以下步骤操作，3分钟完成安装，5分钟搞定配置，全程零踩坑，新手也能轻松驾驭！
一、系统要求与环境准备（必看！避免安装报错）
先确认自己的系统和前置环境，不符合要求会导致安装失败，建议先检查再操作～
◆ 1.1 支持的操作系统
• Windows：Windows 10/11（推荐用Git Bash或PowerShell，cmd容易出权限问题） • macOS：macOS 10.14+（直接用终端操作即可） • Linux：Ubuntu 18.04+、CentOS 7+，其他主流发行版均支持
◆ 1.2 前置要求
• Node.js：版本16.0及以上（低于此版本会报错，下文有升级方法） • npm：包管理器（通常随Node.js一起安装，无需单独下载） • Git：用于版本控制（可选，但推荐安装，避免后续操作受限）
◆ 1.3 环境检查（复制命令直接执行，快速验证）
打开终端（Windows用Git Bash/PowerShell），依次输入以下命令，检查环境是否符合要求：
检查Node.js版本（显示v16.0.0及以上即可）
node --version
检查npm版本
npm --version
检查Git版本（可选）
git --version
💡 小提示：如果Node.js版本过低，下文会教你升级，不用慌～
二、Claude Code 一键安装（推荐！最省心，新手优先）
分系统操作，步骤清晰，复制命令直接执行，避免手动操作出错，推荐优先用自动安装方式！
◆ 2.1 自动安装方式（推荐，Linux/macOS/Windows通用）
Linux/macOS系统（终端操作）
1. 下载安装脚本（复制完整命令，粘贴到终端，回车）
curl -o glm_claude_setup.sh “http://bigmodel-us3-prod-marketplace.cn-wlcb.ufileos.com/1753683727739-0b3a4f6e84284f1b9afa951ab7873c29.sh?ufileattname=claude_code_prod.sh”
2. 赋予执行权限（继续输入，回车）
chmod +x glm_claude_setup.sh
3. 运行安装脚本（输入后回车，等待自动安装即可）
./glm_claude_setup.sh
Windows系统（2种方法，选一种即可）
方法1：使用Git Bash（和Linux操作完全一致）
复制上面Linux的3条命令，依次粘贴到Git Bash，回车执行，等待安装完成。
方法2：使用PowerShell（管理员身份运行）
1. 打开PowerShell（右键开始菜单，选择“Windows PowerShell (管理员)”） 2. 输入命令（复制粘贴，回车）
powershell -ExecutionPolicy Bypass -File glm_claude_setup.ps1
💡 小提示：安装过程中会自动安装/升级Node.js，无需手动操作，耐心等待即可。
◆ 2.2 手动安装方式（自动安装失败时用）
如果自动安装报错，可尝试手动安装，步骤如下：
1. 安装/更新npm（确保是最新版本） 2. 全局安装Claude Code（复制命令，回车执行） 3. npm install -g @anthropic-ai/claude-code 4. 验证安装（输入以下命令，能显示版本号即安装成功） 5. 检查Claude Code版本
6. claude --version 7. 检查Claude Code状态
8. claude --help
◆ 2.3 权限配置（Windows特殊处理，必看！）
Windows用户容易遇到权限问题，按以下步骤配置，避免后续无法运行：
• Git Bash权限配置：首次运行若出现警告，系统会自动创建.bash_profile文件，直接忽略即可。 • PowerShell权限配置：若提示“权限不足”，以管理员身份运行PowerShell，输入以下命令（回车执行）： • Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
三、Claude Code 快捷命令与配置（提升效率，必学！）
安装完成后，掌握这些快捷命令和配置，能大幅提升编码效率，新手先记常用命令即可～
◆ 3.1 基础快捷命令（常用命令加粗，直接复制使用）
| /bug | ||
| /clear | ||
| /config | ||
| /help | ||
| /review | ||
| /mcp | ||
◆ 3.2 自动模式配置（避免频繁确认，提升效率）
Claude Code默认执行命令时需要用户确认，频繁确认很繁琐，启用自动模式即可解决：
启用自动权限模式（复制命令，回车执行）
claude --dangerously-skip-permissions
◆ 3.3 高级操作技巧（进阶必备）
• 权限模式切换：Shift+Tab 循环切换（自动接受模式/计划模式） • 快捷键：@文件名（精准引用分析文件）、#（快速编辑CLAUDE.md）、!（执行bash命令） • 全局记忆设置：输入/memory，在编辑器中设置“与用户交流始终使用中文”，后续使用更流畅。
四、常见问题与故障排除（必看！解决90%的报错）
整理了安装、配置、使用中最常见的问题，对应解决方案直接抄，不用再查资料！
◆ 4.1 安装相关问题
• 问题1：npm权限错误（EACCES），提示“权限不足” • 解决方案：Linux/macOS输入 sudo npm install -g @anthropic-ai/claude-code；或配置npm用户目录（具体命令见下文）。 • 问题2：Node.js版本过低，安装时报错 • 解决方案：用nvm升级Node.js，复制命令依次执行： • curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash（安装nvm） • nvm install node（安装最新Node.js） • nvm use node（切换到最新版本） • 问题3：下载安装脚本失败、超时 • 解决方案：设置npm镜像源（国内加速），输入 npm config set registry https://registry.npmmirror.com，再重新下载。
◆ 4.2 配置与使用相关问题
• 问题1：MCP工具无法使用，提示“未收到Authorization参数” • 解决方案：检查API密钥是否正确，重新执行MCP工具添加命令，确保“your_key”替换为自己的智谱API密钥。 • 问题2：命令无响应，输入后卡住 • 解决方案：Ctrl+C强制退出，重新输入claude重启，再用claude --status检查系统状态。 • 问题3：自动模式不生效，仍需要确认 • 解决方案：重新执行 claude --dangerously-skip-permissions，用claude --config检查是否有配置覆盖。
五、卸载与维护（按需操作）
◆ 5.1 完全卸载步骤（彻底删除，避免残留）
1. 卸载Claude Code：npm uninstall -g @anthropic-ai/claude-code 2. 清理配置文件（关键！避免后续安装报错）： 3. Windows：rm -rf ~/.claude、rm -f ~/.claude*（Git Bash中执行） 4. Linux/macOS：rm -rf ~/.claude*、rm -rf ~/.claude 5. 清理npm缓存：npm cache clean --force
◆ 5.2 定期维护
1. 升级Claude Code：npm update -g @anthropic-ai/claude-code 2. 清理缓存：rm -rf ~/.claude/cache（避免内存占用过高）
六、总结与建议（新手必看）
1. 新手优先用「自动安装方式」，省心高效，避免手动配置出错； 2. 环境准备是关键，先检查Node.js版本，过低及时升级； 3. MCP工具按需安装，常用的地图、天气工具优先配置，不用贪多； 4. 遇到报错先看“常见问题”，90%的问题都能快速解决； 5. 收藏本文，后续使用中遇到问题，随时查阅，不用重复找资料。
💬 留言区聊聊：你用Claude Code主要做什么？安装过程中遇到了什么问题？评论区留言，我会一一回复解答～
✨ 觉得有用，记得点赞+在看+转发给身边的程序员朋友，一起提升编码效率！
