Claude Code CLI 新手使用指南

适用于 macOS 用户最后更新：2026-03

1. 安装与启动

安装方式（选一种即可）

# 方式一：官方脚本
curl -fsSL https://claude.ai/install.sh | bash

# 方式二：Homebrew（推荐 Mac 用户）
brew install --cask claude-code

首次启动

cd /path/to/your/project   # 先进入你的项目目录
claude                      # 启动 Claude Code

首次启动会要求登录，输入 /login 并按提示完成认证。支持 Claude Pro/Max/Teams/Enterprise 订阅或 Anthropic API 账号。

2. 基本用法

启动命令

命令	说明	示例
`claude`	启动交互式会话	`claude`
`claude "任务描述"`	带初始提示启动	`claude "添加登录表单"`
`claude -p "问题"`	一次性提问后退出	`claude -p "解释这个文件"`
`claude -c`	继续上一次对话	`claude -c`
`claude -r "会话名"`	恢复指定会话	`claude -r "auth-refactor"`
`claude -n "名称"`	以指定名称开始新会话	`claude -n "feature-login"`

在对话中引用文件

输入 @ 触发文件自动补全：

解释一下 @src/auth.ts
给 @components/Button.tsx 添加测试

直接运行 Shell 命令

在提示符前加 ! 可以直接执行终端命令，输出会自动加入对话上下文：

! npm test
! git status
! ls -la

3. 斜杠命令大全

在对话中输入 / 可以查看所有可用命令。以下按功能分类：

会话管理

命令	说明
`/help`	显示帮助信息
`/clear`	清空对话历史，重新开始
`/exit` 或 `/quit`	退出 Claude Code
`/resume [会话名]`	恢复之前的对话
`/rename [名称]`	重命名当前会话
`/compact [指令]`	压缩对话历史以节省上下文空间

配置相关

命令	说明
`/config`	打开设置界面（主题、模型、输出风格等）
`/model [模型名]`	切换 AI 模型（如 sonnet、opus、haiku）
`/effort [low\\|medium\\|high\\|max]`	设置推理努力程度
`/fast [on\\|off]`	开关快速模式
`/permission-mode`	查看/更改权限模式
`/memory`	查看/编辑 CLAUDE.md 记忆文件

代码与 Git

命令	说明
`/diff`	查看 Claude 所做的代码更改
`/rewind`	回退到之前的某个对话节点
`/cost`	显示 Token 用量和费用
`/context`	可视化上下文窗口使用情况

高级功能

命令	说明
`/btw <问题>`	快速提问（不影响主对话历史）
`/plan [描述]`	进入计划模式（只读分析）
`/add-dir <路径>`	添加额外的工作目录
`/mcp`	配置 MCP (Model Context Protocol) 服务器
`/hooks`	查看钩子配置
`/plugins`	管理插件
`/doctor`	诊断 Claude Code 问题

4. 模式详解与快捷键

Claude Code 有几种核心工作模式，理解它们能让你更高效地使用工具。

4.1 快速模式 (Fast Mode)

项目	说明
作用	使用同一模型但输出更快
快捷键	`Option + O`
斜杠命令	`/fast on` 或 `/fast off`
适用场景	简单任务、快速问答
权衡	速度更快，但可能牺牲部分推理深度

4.2 计划模式 (Plan Mode)

项目	说明
作用	Claude 只读取和分析代码，不做任何修改
切换方式	按 `Shift + Tab` 循环切换到 plan 模式
斜杠命令	`/plan`
适用场景	理解新代码库、制定实施方案
特点	先分析后动手，避免盲目修改

4.3 扩展思考 (Extended Thinking)

项目	说明
作用	启用深度推理，解决复杂问题
快捷键	`Option + T`
适用场景	复杂架构设计、疑难 bug 排查
权衡	耗时更长，但推理质量更高

4.4 模型切换

项目	说明
作用	在不同 Claude 模型间切换
快捷键	`Option + P`
斜杠命令	`/model opus` 或 `/model sonnet` 或 `/model haiku`
可选模型	Opus（最强）、Sonnet（均衡）、Haiku（最快）

5. 权限模式

权限模式控制 Claude 在执行操作前是否需要征得你的同意。按 Shift + Tab 可以循环切换。

四种权限模式对比

模式	Claude 能做什么	需要确认？	适用场景
default（默认）	只能读取文件	每个操作都要确认	刚开始使用，敏感项目
acceptEdits	读取 + 编辑文件	仅运行命令时确认	日常编码迭代
plan	只能读取（不能编辑）	探索操作需确认	分析代码、制定方案
auto	所有操作（AI 安全检查）	基本不需要确认	长时间运行的任务

切换权限模式

# 方式一：快捷键（推荐）
Shift + Tab     # 循环切换：default → acceptEdits → plan → auto

# 方式二：启动时指定
claude --permission-mode plan

# 方式三：斜杠命令
/permission-mode

新手建议

刚开始使用时保持 default 模式，了解 Claude 会执行哪些操作
熟悉后切换到 acceptEdits 模式，提高效率
需要分析代码时切换到 plan 模式
对 Claude 完全信任时可以使用 auto 模式

6. Mac 键盘快捷键

核心快捷键（必记）

快捷键	功能
`Shift + Tab`	循环切换权限模式
`Option + O`	开关快速模式
`Option + T`	开关扩展思考
`Option + P`	切换 AI 模型
`Escape` `Escape`	回退代码到之前的状态
`Ctrl + C`	取消当前输入或生成
`Ctrl + D`	退出 Claude Code
`Ctrl + L`	清屏（保留对话历史）
`?`	显示所有可用快捷键

输入相关

快捷键	功能
`Option + Enter`	换行（多行输入）
`Shift + Enter`	换行（多行输入）
`\` + `Enter`	快速换行
`Ctrl + V` 或 `Cmd + V`	粘贴（支持粘贴图片）
`↑`	浏览历史输入
`Tab`	命令自动补全

文本编辑

快捷键	功能
`Ctrl + K`	删除到行尾
`Ctrl + U`	删除整行
`Ctrl + Y`	粘贴已删除的文本
`Option + B`	光标向左跳一个单词
`Option + F`	光标向右跳一个单词
`Ctrl + R`	反向搜索历史命令

其他

快捷键	功能
`Ctrl + O`	切换详细输出模式
`Ctrl + B`	将任务放到后台运行
`Ctrl + T`	显示/隐藏任务列表

提示：如果 Option 键的快捷键不生效：

iTerm2：设置 → Profiles → Keys → 将 Left/Right Option key 设为 “Esc+”

Terminal.app：设置 → 描述文件 → 键盘 → 勾选”将 Option 键用作 Meta 键”

7. 实用技巧

7.1 描述要具体

# 不好的描述
修复那个 bug

# 好的描述
修复登录页面中用户输入错误密码后显示空白页面的 bug

7.2 善用 @ 引用文件

查看 @src/utils/auth.ts 中的认证逻辑有没有安全隐患

7.3 用 /compact 节省上下文

对话较长时，上下文窗口可能不够用。输入 /compact 可以压缩历史对话，腾出空间。

7.4 用 /btw 快速提问

/btw JavaScript 中 == 和 === 有什么区别？

这样提问不会影响你当前的工作对话。

7.5 给会话命名方便恢复

claude -n "重构用户模块"       # 以名称开始会话
# ... 工作中途退出 ...
claude -r "重构用户模块"       # 之后恢复会话

7.6 查看费用

/cost

随时了解当前会话消耗了多少 Token。

7.7 回退操作

如果 Claude 修改的代码不满意，快速按两次 Escape 可以回退到之前的代码状态。

8. 常见工作流程

理解项目

这个项目是做什么的？
项目的入口文件在哪里？
解释一下 @src/index.ts 的整体结构

修改代码

给登录表单添加输入验证
把 @src/auth.js 重构为使用 async/await

Git 操作

我修改了哪些文件？
提交我的更改，写一个描述性的 commit 信息
创建一个名为 feature/quickstart 的新分支

写测试

为 @src/calculator.ts 编写单元测试

代码审查

审查我的代码改动，给出改进建议

调试

运行测试，如果失败就修复问题
分析 @src/api.ts 中为什么会返回 500 错误

9. 获取帮助

在 Claude Code 中

输入 /help 查看命令列表
输入 ? 查看快捷键
输入 /doctor 诊断问题
直接提问：”怎么做 xxx？”

在线资源

官方文档：https://docs.claude.ai/s/claude-code
问题反馈：https://github.com/anthropics/claude-code/issues

快速参考卡片

┌─────────────────────────────────────────────────┐
│           Claude Code Mac 快捷键速查             │
├─────────────────────────────────────────────────┤
│  Shift+Tab      循环切换权限模式                 │
│  Option+O       开关快速模式                     │
│  Option+T       开关扩展思考                     │
│  Option+P       切换 AI 模型                     │
│  Esc Esc        回退代码更改                     │
│  Ctrl+C         取消当前操作                     │
│  Ctrl+L         清屏                            │
│  Option+Enter   多行输入                        │
│  ?              显示所有快捷键                   │
├─────────────────────────────────────────────────┤
│  /help    帮助      /clear    清空对话           │
│  /compact 压缩历史  /cost     查看费用           │
│  /diff    查看改动  /model    切换模型           │
│  /plan    计划模式  /fast     快速模式           │
│  ! cmd    运行终端命令  @file 引用文件           │
└─────────────────────────────────────────────────┘

目录