Claude Code 保姆级安装教程：从零到跑通终端编码助手只要3分钟-编程实验室

Claude Code 保姆级安装教程：从零到跑通终端编码助手只要3分钟

【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code

如果你还在为翻遍十几个窗口找代码、修 bug 而头疼，试试 Claude Code：在终端里用自然语言下命令，它就能帮你执行日常编码任务、解释复杂代码、处理 Git。照着这篇走完，3 分钟装好并跑起来。

快速上手：两条命令装好并打开 Claude Code

先别研究细节，先把这两条跑通（macOS / Linux）：

curl -fsSL https://claude.ai/install.sh | bash

装完进入你的项目目录，执行claude。看到欢迎界面和输入提示符，就说明已经跑起来了，后面再补环境要求和验证方法。Windows 用户把第一条换成 PowerShell 里的irm https://claude.ai/install.ps1 | iex即可。

Claude Code 一分钟速览：它能帮你做什么

一个住在终端里的 AI 编码助手，能读懂你整个项目的代码结构
用自然语言下达任务：重构、改名、修 bug，它直接动手执行
复杂代码看不懂？让它逐行讲解
Git 工作流交给它：提交、整理 commit、处理 PR

官方文档入口就在仓库根目录的 README.md，建议收藏。

🧪 环境自检：装 Claude Code 之前确认这3项

打开终端，逐项核对：

Node.js 18 及以上版本，执行node -v查看，输出类似v18.x.x就算达标
npm 包管理器，执行npm -v能返回版本号（Node.js 自带）
一个能用的终端：macOS 自带 Terminal，Windows 用 PowerShell

缺 Node.js 的话，去 Node.js 官网（nodejs.org）下载 LTS 版本装一下，装完重开终端再验证。终端是 Windows 自带的，不需要额外安装。

安装并验证 Claude Code：你应该看到什么输出

macOS / Linux 执行安装脚本：

curl -fsSL https://claude.ai/install.sh | bash

执行完你应该看到安装完成的提示，全程没有成片的红色报错。Windows 推荐二选一：

irm https://claude.ai/install.ps1 | iex

winget install Anthropic.ClaudeCode

npm 方式目前官方已标记为不再推荐，但老项目仍可用：npm install -g @anthropic-ai/claude-code，成功后 npm 会显示 "added 1 package"。

最后验证：执行claude --version，你应该看到一串版本号（如1.x.x）。能输出版本号，说明装好了；接着在项目目录里执行claude，进入欢迎界面并提示登录，首次使用会要求你完成账号验证。

🧩 进阶玩法：用钩子自动优化 Claude Code 的 Bash 命令

什么时候用：你希望 Claude Code 执行命令前，先过一道自定义检查。比如它习惯用grep搜代码，其实rg（ripgrep）更快，可以让钩子自动"纠正"它。

怎么配：在 Claude Code 的设置文件里加一段钩子配置，把command指向一个校验脚本。仓库里就有现成示例 examples/hooks/bash_command_validator_example.py，如果你还没拿到项目代码，先执行git clone https://gitcode.com/GitHub_Trending/cl/claude-code：

{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "python3 examples/hooks/bash_command_validator_example.py" } ] } ] } }

配完的效果：当 Claude 准备跑grep或find -name时，钩子会先拦截并提示改用更快的rg写法，搜索速度肉眼可见地提升。想扩展更多能力（代码审查、提交规范等），可以浏览 plugins/ 目录里的一批现成插件。

🩹 卡住了？3分钟修好这3个高频错误

问题1：执行claude提示 "command not found"通常是全局安装目录没进 PATH。先执行npm config get prefix查看全局安装前缀，把其中的 bin 目录加进系统 PATH，然后重开终端再试。

问题2：npm 安装中途报错先node -v确认版本不低于 18；满足的话执行npm cache clean --force清掉缓存再重装。还不行就换安装脚本或winget install Anthropic.ClaudeCode这条路。

问题3：安装脚本卡住或下载失败多是网络问题，直接重跑一次安装命令。Windows 上也可以改用 Homebrew 之外的备选：winget或brew install --cask claude-code（已装 Homebrew 时）。

下一步：从 Claude Code 文档和插件继续深入

装好只是开始，把"让 Claude Code 帮我……"变成你的日常终端习惯。完整功能说明看 README.md，想装现成插件扩展能力看 plugins/README.md，安全策略细节在 SECURITY.md。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Claude Code 保姆级安装教程：从零到跑通终端编码助手只要3分钟