Claude Code 新手入门：安装、开启对话与 VS Code 扩展使用指南
如果你第一次接触 Claude Code，这篇文档可以帮你快速完成从安装到上手的第一步。内容基于 Claude Code 官方中文文档整理，重点覆盖安装、开启对话、代码修改、基础命令，以及 VS Code 扩展中最常用的能力。
这篇文档适合谁
这篇文档主要适合两类人：
- 想先在终端里体验 Claude Code 的开发者
- 平时主要在 VS Code 中写代码，希望直接在 IDE 里使用 Claude Code 的开发者
如果你平时主要在 VS Code 中开发，官方推荐优先使用 VS Code 扩展；如果你更习惯命令行，也可以直接从 CLI 开始。
一、安装 Claude Code
1. 用终端安装
如果你想先从命令行开始，可以使用下面几种官方安装方式。
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
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
如果你在 Windows 上安装，官方说明需要先准备好 Git for Windows。
2. 用包管理器安装
Homebrew
brew install --cask claude-code
Homebrew 安装不会自动更新，后续升级可以执行：
brew upgrade claude-code
WinGet
winget install Anthropic.ClaudeCode
如果你通过 WinGet 安装，也需要手动升级：
winget upgrade Anthropic.ClaudeCode
3. 安装 VS Code 扩展
如果你更希望在 IDE 里直接和 Claude 协作，VS Code 扩展会更顺手。官方说明这是在 VS Code 中使用 Claude Code 的推荐方式。
先确认你的 VS Code 版本不低于 1.98.0。然后可以用以下任意一种方式安装：
在扩展市场中安装
- 按
Cmd+Shift+X（Mac）或Ctrl+Shift+X（Windows / Linux）打开扩展视图 - 搜索
Claude Code - 点击“安装”
用命令安装扩展
code --install-extension anthropic.claude-code
如果安装后没有立即显示，可以重启 VS Code，或者从命令面板执行 Developer: Reload Window。
二、如何开启第一段对话
安装完成后，最重要的不是先记住全部功能，而是先知道怎么把第一段对话真正开起来。
1. 在终端里开始
进入你的项目目录后，直接运行：
cd /path/to/your/project
claude
这会启动 Claude Code 的交互会话。进入欢迎界面后，可以先输入 /help 查看可用命令；如果你想继续之前的会话，可以使用 /resume。
如果你只想让它完成一个一次性任务，也可以直接把任务写在命令里，例如：
claude "fix the build error"
如果你只是想快速问一个问题并在回答后退出，可以使用：
claude -p "explain this function"
2. 在 VS Code 里开始
安装扩展后，你可以通过下面几种方式打开 Claude 对话：
- 点击编辑器右上角的 Spark 图标
- 点击左侧活动栏中的 Spark 图标
- 按
Cmd+Shift+P或Ctrl+Shift+P打开命令面板，搜索Claude Code - 点击右下角状态栏中的 Claude Code 入口
打开后，直接输入你的问题或任务即可，比如“解释这个文件做了什么”“帮我修掉这个报错”“把这个模块改成 async/await”。
如果你已经在编辑器里选中了某段代码，Claude 会自动看到这段选中内容。你也可以输入 @ 引用文件或文件夹；如果想精确引用某个文件的行范围，可以按 Option+K（Mac）或 Alt+K（Windows / Linux）插入类似 @app.ts#5-10 这样的引用。
三、Claude 如何帮助你修改代码
对新手来说，Claude Code 最有价值的能力之一，就是让“提需求并改代码”的过程更自然。
在终端或 VS Code 里，你都可以直接用自然语言描述目标，例如：
- “帮我分析这个仓库的认证流程”
- “给这个接口补上错误处理”
- “把回调写法改成 async/await”
- “总结一下我刚刚改了哪些文件”
在 VS Code 扩展里，Claude 准备修改文件时会先展示原始内容和建议修改的 diff，然后请求你的许可。你可以：
- 接受修改
- 拒绝修改
- 继续补充要求，让它按你的意思重改
这种工作方式很适合新手，因为你不需要一次就把提示写得非常完美，而是可以边看边调整。
四、新手先记住这些基础命令
刚开始不用背很多，先掌握下面这些就够用了。
| 命令 | 作用 |
|---|---|
claude |
启动交互模式 |
claude "task" |
执行一次性任务 |
claude -p "query" |
提问一次后退出 |
claude -c |
在当前目录继续最近一次对话 |
claude -r |
恢复之前的某段对话 |
claude commit |
让 Claude 帮你创建 Git 提交 |
/help |
查看可用命令 |
/clear |
清空当前对话历史 |
如果你在 VS Code 扩展里工作，还可以顺手记住几个高频入口：
/model：切换模型/usage：查看计划使用情况/compact：手动压缩上下文/plugins：管理 plugins/mcp：管理 MCP servers
另外，官方快速开始页还提到几个很实用的交互习惯：
- 输入
/可以查看可用命令和 skills - 按
?可以查看快捷键 - 按
Tab可以进行命令补全 - 按方向键
↑可以查看命令历史
五、VS Code 扩展里最常用的能力
如果你主要在 VS Code 里使用 Claude Code，下面这些功能最值得先熟悉。
1. 直接在 IDE 中对话
你不需要切换到外部工具，Claude 面板就直接在编辑器旁边。这样可以一边看代码，一边提问，一边查看修改建议。
2. 用 @ 和选中代码提供上下文
与其写一大段背景说明，不如直接把文件、目录或代码行引用给 Claude。这样它更容易理解你到底在问哪一段逻辑。
3. 审查计划和代码 diff
对于稍复杂的任务，Claude 可能先给出计划；你确认后它再开始执行。真正改文件时，扩展会展示差异对比，这对控制改动范围很有帮助。
4. 恢复历史对话
你可以从扩展顶部的历史记录入口找回之前的对话，继续上次没做完的任务，而不需要重新解释一遍上下文。
5. 多开会话
同一个 VS Code 中可以开多个对话标签页，把“修 bug”“重构模块”“解释代码”分开处理，思路会更清晰。
6. 常用快捷键
| 操作 | 快捷键 |
|---|---|
| 打开扩展视图 | Cmd+Shift+X / Ctrl+Shift+X |
| 打开命令面板 | Cmd+Shift+P / Ctrl+Shift+P |
| 在编辑器和 Claude 之间切换焦点 | Cmd+Esc / Ctrl+Esc |
| 在新标签页打开新对话 | Cmd+Shift+Esc / Ctrl+Shift+Esc |
| 新建对话 | Cmd+N / Ctrl+N |
插入带行号的 @ 引用 |
Option+K / Alt+K |
六、一个适合新手的上手顺序
如果你想尽快形成使用手感，可以按下面这个顺序开始：
- 先装好 Claude Code 或 VS Code 扩展
- 在一个你熟悉的小项目目录中运行
claude，或在 VS Code 中打开 Claude 面板 - 先做“解释代码”这类低风险任务，比如“解释这个模块做了什么”
- 再尝试小范围修改，比如“给这个函数补日志”或“修一个明显报错”
- 每次修改前后都看一下 diff，确认你真的理解它改了什么
- 逐步再去尝试
/compact、/mcp、/plugins这类进阶能力
结语
对于新手来说，Claude Code 最好的打开方式，不是一上来就研究全部功能，而是先完成三个最小动作：装好、开一个对话、让它帮你做一次真实的小改动。只要这一步顺了，后面的命令、工作流和扩展能力都会更容易理解。