Beginner Guide · 命令行新手教程

Claude Code
命令行使用指南

从 macOS 应用迁移到命令行，掌握更强大的操作方式

1
它是怎么工作的

Claude Code 命令行和 macOS 应用本质上是同一个东西，但命令行更灵活、功能更完整。

💬你发任务
→
📂Claude 读文件
→
✏️Claude 操作
→
✅验证结果
💡
你随时可以打断它、纠正它、换方向——你始终是主导者。
2
怎么打开它

打开终端（Cmd + Space 搜索 "Terminal"），然后进入你的项目文件夹，运行：

# cd 到你的项目目录（示例）
cd ~/Desktop/我的项目

# 启动 Claude Code
claude

进入后就可以直接打字对话了，就像 macOS 应用一样。

常用启动方式

claude                         # 新建会话
claude "帮我解释这个项目结构"       # 带初始任务启动
claude -c                        # 继续上次的会话（你平时在 App 里的体验）
claude --resume                  # 弹出选择器，选一个旧会话继续
claude --name "auth重构"           # 给这次会话起个名字
📱
你平时在 macOS 应用里用的，对应的就是 claude -c——每次打开都自动续上次会话。
3
会话是什么

Claude Code 的"会话"类似聊天软件的对话记录，本地保存在 ~/.claude/projects/ 里。

命令效果
claude新对话，空白开始
claude -c接着上次说
claude --resume打开历史列表，选一个继续
claude --resume auth重构直接续指定名称的会话
🏷️
建议给重要会话起名：claude --name "功能名称"，以后可以随时精准续上。
4
对话里能用的斜杠命令

在 Claude Code 对话框里，输入 /命令 可以控制行为：

命令作用
/help显示所有可用命令
/clear清空对话（不影响项目记忆和 CLAUDE.md）
/compact把对话压缩摘要，腾出 context 空间
/context可视化显示当前 context 窗口占用情况
/model切换模型（Sonnet / Opus 等）
/diff查看本次会话中 Claude 所做的所有文件改动
/permissions查看和编辑 Claude 的操作权限
/init在当前项目创建 CLAUDE.md 配置文件
/exit退出（或按 Ctrl+D）
5
权限模式（重要）

Claude 在修改文件或执行命令前会征求你的同意。按 Shift + Tab 循环切换模式：

默认模式 推荐新手
每次修改都问你，最安全，适合刚上手时使用。
自动接受编辑
文件改动自动通过，其他 Shell 命令还是会问。
计划模式 大改动必用
Claude 只分析、列计划，等你批准后才执行。大重构首选。
自动模式
大部分操作不问，有后台安全检查，适合有经验的用户。
⌨️
新手建议： 默认用默认模式。遇到要大改的时候，按两下 Shift+Tab 切到计划模式，让 Claude 先把计划列出来，你确认没问题再放行。
6
Context 窗口管理

Claude 有个"记忆上限"（约 20 万 token）。当对话太长、读的文件太多，它就会开始遗忘早期内容。

症状原因解决方法
回答越来越模糊Context 快满了/context 查看，/compact 压缩
忘了之前交代的规则对话历史被挤出把规则写入 CLAUDE.md（持久加载）
🧠
把不想丢的规则写进 CLAUDE.md——每次会话自动加载，不会因为 context 满而消失。
7
CLAUDE.md — 持久化规则文件

在项目里运行 /init，Claude 会帮你创建 CLAUDE.md。这个文件存放永久性规则，每次会话都会自动加载。

适合写进去的内容：

# 例子：CLAUDE.md 里可以写什么
- 项目用 TypeScript，不要用 JavaScript
- 测试用 Vitest，运行命令是 npm test
- 不要修改 src/legacy/ 下的任何文件
- 提交信息格式：feat: / fix: / refactor:
📌
有了 CLAUDE.md，你就不用每次新开会话都重新交代一遍规则了。
8
实用操作范式
1
先读后做
让 Claude 先读懂再动手。比如"读一下 src/auth/ 目录，解释登录流程"，确认它理解对了，再说"好，现在帮我加 OAuth 支持"。
2
大改动用计划模式
按 Shift+Tab 切到计划模式，让 Claude 列出操作计划，你确认无误后再放行执行。
3
分步推进
不要一次说"帮我做完整个功能"。先"做第一步：数据库表结构"，确认后再"做第二步：API 接口"。
4
用 /diff 检查
每隔一段就输入 /diff，看 Claude 到底改了哪些文件，避免意外修改。
5
Esc Esc 撤销
如果不满意 Claude 的改动，连按两下 Esc 可以回到操作前的检查点（类似 Ctrl+Z）。
9
常见问题速查
问题原因解决
Claude 回答越来越模糊Context 快满了/context 查看，/compact 压缩
关掉终端，找不到旧会话没有续会话claude --resume 选历史
每次都要重新交代规则没有 CLAUDE.md/init 创建，把规则写进去
想撤销 Claude 的改动—连按两下 Esc
Claude 卡住不动了进程挂起Ctrl+C 中断当前响应
10
快速备忘卡
Quick Reference
# ── 启动 ──────────────────────────────────────
claude                    # 新会话
claude -c               # 续上次（同 macOS App 默认行为）
claude --resume          # 选历史会话
claude --name "名称"      # 给会话起名

# ── 对话内斜杠命令 ─────────────────────────────
/help                     # 显示所有命令
/clear                    # 清空对话
/compact                  # 压缩对话，腾出 context
/context                  # 查看 context 占用
/diff                     # 查看文件改动
/model                    # 切换模型
/init                     # 创建 CLAUDE.md

# ── 快捷键 ────────────────────────────────────
Shift+Tab                 # 循环切换权限模式
Esc Esc                   # 撤销到上一个检查点
Ctrl+C                    # 中断当前响应
Ctrl+D                    # 退出
Claude Code 命令行新手教程 · 由 Claude 生成于 2026-05-14