Claude Code 新手上手指南：从安装到生产力的完整攻略

Claude Code 是什么

Claude Code 是 Anthropic 官方推出的 AI 编程助手，基于 Claude 大模型。它能帮助你完成代码编写、文件修改、调试排错、重构优化等日常工作，是提升开发效率的利器。

本指南将从零开始，帮你快速掌握它的核心用法。

一、安装与登录

1.1 安装

前往 Claude Code 官网，复制安装命令，粘贴到终端执行即可。

1.2 启动与登录

1
2
3
mkdir my-project
cd my-project
claude

如果没有自动弹出登录提示，手动触发：

1
/login

1.3 两种接入方式

方式 说明
订阅制 购买 Claude Pro 或 Max 会员后直接使用
API Key 按 Token 用量计费，用多少花多少

如果无法使用官方服务，也可以通过配置环境变量接入国产模型（如 GLM、MiniMax 等）来驱动 Claude Code。

二、三种交互模式

按 Shift + Tab 可以在三种模式之间循环切换：

模式 显示标识 说明
默认模式 ? For shortcuts 每次创建或修改文件前都会询问，最稳妥
自动模式 Accept Edits On 自动创建/修改文件，不再询问，最方便
规划模式 Plan Mode On 只讨论方案，不修改文件，适合构思

三、终端命令与权限控制

3.1 直接执行终端命令

在输入框中输入 ! 即可进入 Bash 模式，直接运行终端命令：

1
! open index.html

3.2 跳过权限检测

1
claude --dangerously-skip-permissions

开启后 Claude Code 可执行任意终端命令而无需确认。模式显示为 Bypass Permissions On。

⚠️ 该参数含 dangerously（危险的）字样，请务必确认操作安全后再使用。

四、复杂任务处理

4.1 使用规划模式（Plan Mode）

面对较大改动（如架构重构）时，建议先切换到规划模式讨论方案，再执行。

换行技巧：按 Shift + Enter 换行，不会直接提交请求。

VS Code 编辑输入：按 Ctrl + G 可在 VS Code 中编辑内容，保存关闭后内容自动填入。

规划模式结束后会给出三个选项：

  • 执行计划，进入自动同意模式
  • 执行计划，使用默认模式
  • 继续修改计划

4.2 后台任务管理

启动开发服务器后，Claude Code 会被阻塞，此时：

操作 按键/命令
将当前服务放入后台 Ctrl + B
查看所有后台任务 /tasks
结束某个后台服务 任务列表中按 K
退出任务列表 ESC

4.3 回滚功能

Claude Code 每次处理请求时都会自动创建回滚点。

  • 进入回滚页面：按两下 ESC，或执行 /rewind

回滚选项：回滚代码和对话 / 仅回滚对话 / 仅回滚代码 / 放弃回滚

⚠️ Claude Code 只能回滚它自己写入的文件，由终端命令（如 mkdir、npm install）生成的文件无法回滚。建议日常使用 Git 进行版本管理，回滚功能作为补充。

五、多模态与上下文管理

5.1 传入图片（多模态）

将设计稿截图传给 Claude Code，让它照图实现界面：

  • 拖拽：直接将图片文件拖入 Claude Code 界面
  • 粘贴：复制图片后，在 Claude Code 界面按 Ctrl + V（Mac 也用 Ctrl，不是 Command）

5.2 上下文压缩

对话越来越长会影响性能和 Token 消耗，需要定期压缩：

命令 说明
/compact 压缩上下文，可追加压缩策略，如”重点保留用户需求”
/clear 清空上下文，适合新任务与之前完全无关的场景

按 Ctrl + O 可查看压缩后的上下文内容。

六、高级功能扩展

6.1 CLAUDE.md — 持久化上下文

CLAUDE.md 是一个特殊文件，Claude Code 每次启动时都会自动读取它，非常适合沉淀项目上下文。

常见写入内容：项目介绍、技术栈说明、开发规范、注意事项。

1
2
/init        # 自动生成 CLAUDE.md
/memory      # 查看和编辑 CLAUDE.md

保存范围可选：

  • 项目级别：放在当前项目目录，仅对该项目生效
  • 用户级别：放在用户目录，对当前用户所有项目生效

6.2 Hook — 自动化钩子

Hook 允许在 Claude Code 执行工具的前后自动运行一段自定义逻辑，例如写完代码后自动格式化。

1
/hooks

配置示例（使用 Prettier 格式化文件）：

1
echo "$CLAUDE_TOOL_INPUT" | jq -r '.file_path' | xargs prettier --write

6.3 Agent Skill — 动态加载的提示词

Agent Skill 相当于给大模型看的说明书，可以动态加载，无需每次手动粘贴。

创建方法：

1
2
mkdir -p ~/.claude/skills/daily-report
# 在该目录下创建 skill.md

调用方式：

1
2
/skills           # 查看所有已加载的 Skill
/daily-report     # 直接调用指定 Skill

6.4 Subagent — 独立的子智能体

Subagent 是拥有独立上下文、独立工具、独立 Skill 的子 Agent，适合处理复杂的独立任务。

1
/agent  # 创建 Subagent

与 Agent Skill 的对比：

对比项 Agent Skill Subagent
上下文 共享主对话上下文 独立上下文
适合场景 与当前任务关联强 与当前任务关联弱/大规模任务
Token 消耗 中间过程进入主上下文 只返回最终结果

6.5 Plugin — 一键安装能力包

Plugin 将 Skill、Subagent、Hook、MCP 等打包成一键安装包，非常适合团队共享。

1
/plugin

三个 Tab：Discover（发现）/ Installed（已安装）/ Marketplaces（插件市场）

推荐插件：Frontend Design（Anthropic 官方出品的前端 UI 设计插件），可让生成的界面风格更协调。

快捷键速查

快捷键 功能
Shift + Tab 切换交互模式（默认/自动/规划）
Shift + Enter 输入框内换行
Ctrl + G 在 VS Code 中编辑输入内容
Ctrl + B 将当前服务放入后台
Ctrl + O 查看完整上下文内容
Ctrl + V 粘贴图片
ESC × 2 进入回滚页面

常用命令速查

命令 功能
/login 手动触发登录
/tasks 查看后台任务
/rewind 进入回滚页面
/compact 压缩上下文
/clear 清空上下文
/init 自动生成 CLAUDE.md
/memory 查看和编辑 CLAUDE.md
/hooks 进入 Hook 配置页面
/skills 查看所有 Agent Skill
/agent 管理 Subagent
/plugin 进入插件管理器
! + 命令 直接执行终端命令
开发调优
#工具 #人工智能 #软件开发 #Claude Code
Claude Code 新手上手指南：从安装到生产力的完整攻略
https://luoshuang.org/2026/04/18/Claude-Code-新手上手指南/
作者
LuoShuang
发布于
2026年4月18日
许可协议