Claude Code 到底是什么？
Claude Code 是 Anthropic 推出的 AI 编程助手。它和普通网页聊天工具最大的区别是：Claude Code 运行在你的终端、IDE 或桌面环境里，可以直接理解项目目录、读取文件、修改代码、执行命令，并协助你完成 Git、测试、重构、排错等开发任务。
你可以把它理解成一个能进入项目现场工作的 AI 助手。普通 AI 更像是回答问题，Claude Code 更像是陪你一起处理项目：你告诉它目标，它会先看代码、找文件、提出方案，在获得你的确认后再动手修改。
| 场景 | 可以怎么用 |
|---|---|
| 看不懂项目 | 解释项目结构、技术栈、入口文件 |
| 修改代码 | 按自然语言需求改功能 |
| 修复 Bug | 根据报错定位问题并给出修复 |
| 写测试 | 按现有风格补单元测试 |
| 写文档 | 更新 README、接口说明、安装说明 |
| 做 Git 操作 | 查看改动、生成提交信息、解决冲突 |
| 代码审查 | 提交前检查问题和风险 |
| 提交前检查问题和风险 |
安装前准备
· 你的电脑能打开终端：Windows 用 PowerShell 或 CMD，macOS/Linux 用 Terminal。
· 你有一个 Claude 账号，或 Claude Console/API、企业云服务访问权限。
· 网络能访问 Claude 相关服务。默认配置下 Claude Code 需要访问 claude.ai 和 Anthropic API 等端点。
Windows 用户建议安装 Git for Windows。官方说明：在原生 Windows 上安装 Git for Windows 后，Claude Code 可以使用 Bash 工具；如果没有安装，则会退回使用 PowerShell。
git --version
安装 Claude Code
官方推荐使用 Native Install，也可以用 WinGet、Homebrew 或 npm。新手优先用官方安装脚本。
Windows PowerShell：
irm https://claude.ai/install.ps1 | iex
Windows CMD：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
macOS、Linux、WSL：
curl -fsSL https://claude.ai/install.sh | bash
Windows 也可以用 WinGet：
winget install Anthropic.ClaudeCode
如果你更熟悉 npm，也可以这样安装：
npm install -g @anthropic-ai/claude-code
注意：官方文档目前说明，npm 安装方式从 v2.1.198 起需要 Node.js 22 或更高版本。普通新手不必优先走 npm 路线。
验证安装
安装完成后，不要急着开始用，先检查命令是否可用：
claude --version
claude doctor
如果能看到类似 claude-code/2.x.x 的版本号，说明安装成功。claude doctor 可以检查安装状态、路径、配置文件等问题。
首次启动与登录
进入你的项目目录，然后启动 Claude Code：
cd /path/to/your/project
claude
Windows 示例：
cd C:\\Users\\你的用户名\\Desktop\\my-project\\nclaude
第一次启动时，Claude Code 会引导你登录。通常会打开浏览器完成授权；如果浏览器没有自动打开，终端里一般会给出登录链接，你可以复制到浏览器里手动打开。
第一次使用建议
进入项目后，建议先输入：
/help
然后可以让 Claude Code 先理解项目：
这个项目是做什么的？请解释主要目录、入口文件和技术栈。
如果是新项目，也可以运行：
/init
/init 会分析项目并生成或更新 CLAUDE.md。这个文件可以理解成项目说明书，适合记录技术栈、启动命令、测试命令、代码规范和协作偏好。
常用 Shell 命令
| 命令 | 作用 |
|---|---|
| claude | 启动交互模式 |
| claude “修复构建错误” | 执行一次性任务 |
| claude -p “解释这个函数” | 一次性提问，输出后退出 |
| claude -c | 继续当前目录最近一次对话 |
| claude -r | 恢复之前的对话 |
| claude doctor | 检查安装和配置问题 |
| claude update | 手动更新 Claude Code |
| claude --version | 查看版本号 |
常用会话命令
| 命令 | 作用 |
|---|---|
| /help | 查看帮助和可用命令 |
| /login | 登录或切换账号 |
| /init | 初始化项目说明文件 |
| /memory | 查看或编辑记忆 |
| /clear | 清空当前对话上下文 |
| /compact | 压缩长对话，保留关键信息 |
| /context | 查看上下文占用情况 |
| /diff | 查看当前代码改动 |
| /code-review | 审查当前改动 |
| /permissions | 管理工具和文件权限 |
| /model | 切换模型 |
| /usage | 查看使用量和费用信息 |
| /cost | /usage 的别名 |
| /doctor | 在会话内诊断问题 |
| /exit | 退出 Claude Code |
新手推荐工作流
第一次接触一个项目，可以这样做：
请先阅读这个项目，不要修改文件。告诉我它的主要功能、目录结构、启动方式和可能的风险点。
要改功能时，建议先让它给计划：
用户提交空表单时没有校验。请先定位相关代码，说明你准备修改哪些文件，等我确认后再改。
改完后检查：
/diff
/code-review
如果项目已经用 Git 管理，建议先建立一个检查点：
git status
git add .
git commit -m "初始版本"
常见问题
如果提示找不到 claude 命令，通常是安装路径没有加入 PATH。可以先运行 claude doctor。
如果 Windows 提示需要 Git Bash，就安装 Git for Windows。
如果 PowerShell 提示无法运行脚本，可以尝试：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
如果安装或登录失败，先确认网络能访问 Claude 相关服务。不要随意使用来源不明的代理地址、API Key 或配置脚本。
一句话总结
Claude Code 不是单纯的代码生成器，而是一个能理解项目、提出方案、修改文件、执行命令并辅助验证的 AI 编程助手。新手只要掌握三步：
安装成功、进入项目、用清晰任务描述沟通，
就可以开始把它当作真实开发助手来用。