Claude Code 历史记录查看与切换指南

在 claude-code 命令行工具中，历史记录是按 Session (会话) 来管理的。你不能像在网页版那样点击左侧边栏切换，而是需要通过启动参数来选择进入哪个会话。

以下是具体的操作方法：

1. 查看列表并选择（最常用的方法）

如果你想看到过去聊过哪些话题，并选择其中一个继续，请使用 -r (resume) 参数。

claude -r
# 或者
claude --resume

执行后的效果：
终端会弹出一个交互式列表（Interactive Picker），显示你最近的对话历史（通常包含时间和你最后问的问题摘要）。

• 使用键盘 ⬆️ 上 / ⬇️ 下 箭头移动光标。
• 按 Enter 回车 进入选中的会话。

2. 通过关键词搜索历史

如果你记得上次聊了关于 “React” 或 “数据库” 的内容，可以直接在 -r 后面跟上关键词，Claude 会帮你过滤出相关的历史记录。

claude -r "数据库"

• 如果有多个匹配项，它会让你选择。
• 如果只有一个匹配项，它会直接进入该会话。

3. 快速继续上一次的对话

如果你只是刚才关掉了窗口，现在想接着刚才的话茬继续聊，不需要选列表，直接用 -c (continue)。

claude -c
# 或者
claude --continue

• 这会自动加载最近一次活跃的会话上下文。

4. 在运行中如何切换？

如果你当前正在一个会话中（比如正在聊 A 项目），突然想切换到之前的 B 项目会话：

1. 先退出当前会话：
   在对话框输入：

> /exit
# 或者按 Ctrl + C / Ctrl + D

2. 重新启动并选择：
   再次运行选择命令：

claude -r

5. 进阶：通过 Session ID 切换

每次启动 Claude，系统都会分配一个唯一的 Session ID（UUID）。如果你在脚本中需要精准控制，可以使用 ID：

1. 获取 ID：在会话中或日志中可以看到 Session ID。
2. 指定 ID 启动：

claude --session-id 550e8400-e29b-41d4-a716-446655440000

(注：这种方式比较少用，通常直接用 -r 可视化选择更方便)

---

💡 总结对照表

你的需求	终端输入命令	说明
我想看看以前聊过啥，选一个	claude -r	⭐ 推荐，调出历史列表菜单
我想搜一下之前关于某事的对话	claude -r "关键词"	搜索并恢复
刚不小心退出了，想接着聊	claude -c	恢复最近一次会话
我想开启一个全新的对话	claude	不加参数默认就是新会话 (除非配置了自动恢复)
我想在两个会话间来回切	需 /exit 后重连	CLI 不支持在会话内热切换，必须退出来重新选

1. Thought Process (思考过程)

• 用户意图：用户希望获取 claude-code (CLI) 的最新文档，特别是 / 开头的指令列表、功能分类以及详细的使用指南。

• 信息综合：根据最新的搜索结果（2025年10月-12月数据），claude-code 是一个基于终端的 Agent 编程工具。

• 核心指令识别：

• 项目初始化：/init (创建 CLAUDE.md 记忆文件)。

• 上下文管理：/clear (清空历史), /compact (压缩历史/总结)。

• 配置管理：/config (交互式设置), /allowed-tools (权限), /mcp (管理 MCP 服务), /hooks (生命周期钩子)。

• 辅助功能：/help (帮助), /bug (反馈), /vim (切换 Vim 模式)。

• 启动参数 (Flags)：虽然不是 / 命令，但对使用至关重要（如 -p 单次执行, -c 继续会话）。

• 文档结构设计：

• 简介：claude-code 是什么。

• 指令大全 (Slash Commands)：按功能分类列表。

• 常用启动参数：补充 CLI Flags。

• 实战流程：从安装到提交代码的完整 Loop。

• 最佳实践：强调 CLAUDE.md 的重要性。

2. Implementation Plan (执行计划)

• Phase 1: 指令集整理

• 将 /init, /clear, /compact, /config, /mcp 等指令按“项目”、“会话”、“配置”分类。

• 解释每个指令的具体行为（例如 /compact 是如何节省 Token 的）。

• Phase 2: 启动模式解析

• 区分 交互模式 (REPL) 和 单次模式 (Print Mode)。

• 解释 --dangerously-skip-permissions 的风险与用途。

• Phase 3: 编写详细文档

• 场景构建：新项目上手。

• 步骤：npm install -> claude -> /init -> 编码 -> /compact -> 完成。

3. Task List (任务清单)

• 指令提取：确认包含 /init, /compact, /clear, /config, /mcp, /allowed-tools, /vim, /bug。

• 分类定义：

• 记忆与初始化 (/init)

• 上下文控制 (/clear, /compact)

• 系统设置 (/config, /mcp, /allowed-tools)

• 工具 (/help, /vim, /bug)

• 文档撰写：包含安装、基础用法、进阶 MCP 配置。

• 提示：强调 /init 生成的 CLAUDE.md 是项目记忆的核心。

---

Claude Code CLI 使用文档 (2025 最新版)

claude-code 是 Anthropic 推出的终端编程 Agent。它不仅仅是一个聊天机器人，更是一个能直接读写文件、运行终端命令、管理 git 版本的“结对编程”工具。

以下是截至 2025 年底的核心指令与使用指南。

一、 Slash Commands (斜杠命令大全)

在 claude-code 的交互界面中，所有以 / 开头的命令用于控制 Agent 的行为、配置和上下文。

1. 项目与记忆 (Project Intelligence)

命令	功能说明	核心用途
/init	初始化项目记忆。扫描当前目录，生成一个 CLAUDE.md 文件。	必用。这个文件是 Claude 的“项目说明书”（架构、规范、常用命令），让它更懂你的代码。

2. 上下文与会话管理 (Context Management)

命令	功能说明	核心用途
/compact	压缩上下文。将之前的对话总结成摘要，释放 Token 空间。	当对话太长导致 Claude 变慢或遗忘旧信息时使用，能显著节省 Token 费用。
/clear	清空会话。清除所有历史记录，相当于“重启大脑”，但保留项目文件上下文。	切换全新任务时使用，避免旧任务的干扰。

3. 配置与工具 (Config & Tools)

命令	功能说明	核心用途
/config	交互式设置。打开一个菜单，调整模型 (Model)、主题、语言等偏好。	修改默认模型（如从 Sonnet 切换到 Opus）。
/mcp	MCP 服务管理。查看、添加或移除 Model Context Protocol 服务。	进阶玩法，连接数据库、浏览器或 GitHub 时使用。
/allowed-tools	工具权限管理。配置哪些工具（如写入文件、运行命令）需要询问权限，哪些可以自动批准。	设置“自动驾驶”级别，减少手动按 Enter 的次数。
/hooks	配置钩子。设置在工具执行前/后触发的脚本。	只有高级开发者需要，用于自动化工作流集成。

4. 辅助功能 (Utilities)

命令	功能说明	核心用途
/help	显示帮助。列出所有可用命令。	忘记命令时查阅。
/vim	Vim 模式。开启/关闭 Vim 键位绑定。	习惯使用 Vim 的开发者必备。
/bug	报告问题。向 Anthropic 官方提交 Bug 反馈。	遇到崩溃或死循环时使用。

---

二、 启动参数 (CLI Flags)

除了交互模式下的斜杠命令，你在终端启动 claude 时也可以加参数：

• claude -p "你的问题" (Print Mode)：

• 单次执行模式。问完就走，不进入聊天界面。适合写在 Shell 脚本里。

• 示例：claude -p "为当前目录写一个 README.md"

• claude -c (Continue)：

• 继续会话。恢复上一次关闭的会话上下文。

• claude --model opus：

• 指定模型。临时指定本次会话使用更强的模型。

• --dangerously-skip-permissions：

• 高危模式。跳过所有“是否允许执行命令/修改文件”的确认。慎用，除非你在沙箱环境里。

---

三、 详细使用流程 (小白上手指南)

Step 1: 安装与登录

你需要先安装 Node.js (v18+)。

# 1. 全局安装
npm install -g @anthropic-ai/claude-code

# 2. 启动并授权
cd 你的项目目录
claude
# 此时会自动打开浏览器进行 OAuth 登录

Step 2: 初始化项目 (最重要的步骤)

第一次在某个项目里使用 Claude 时，务必先运行初始化：

> /init

Claude 会分析你的代码结构，生成 CLAUDE.md。你可以手动编辑这个文件，告诉 Claude：“我们要用 React 19，代码风格必须是 TypeScript 严格模式。”
以后每次 Claude 回答前，都会先看一眼这个文件。

Step 3: 日常对话 Loop

claude-code 的核心工作流是 REPL (Read-Eval-Print Loop)：

1. 提出需求：

“帮我把 src/utils.js 里的日期格式化函数改成用 date-fns 库。”

2. Claude 思考与规划：
   它会列出计划：1. 读取文件；2. 安装库；3. 修改代码；4. 运行测试。
3. 工具执行 (Tool Use)：
   它会请求运行命令：npm install date-fns。

• 你需要按 Enter 批准 (除非配置了自动允许)。

4. 结果验证：
   它会修改文件，然后可能会主动运行 npm test 来验证自己改得对不对。

Step 4: 进阶技巧 (MCP 集成)

如果你想让 Claude 具备“联网搜索”能力：

1. 在对话中输入：

“/mcp install @modelcontextprotocol/server-brave-search”
(前提：你可能需要配置 Brave Search API Key)

2. 安装成功后，你就可以问它：

“搜索一下最新的 Next.js 15 路由变动，并据此更新我的代码。”

Step 5: 结束与提交

• 如果你觉得上下文太乱了，输入 /compact 整理一下。
• 如果你完成了任务，可以直接让 Claude 帮你提交代码：

“运行 git diff 检查更改，然后提交代码，commit message 写得详细点。”

---

💡 核心提示

1. **善用 /compact**：claude-code 默认会保留很长的上下文，这非常消耗 Token（也就是钱）。当你完成了一个小功能，准备开始下一个时，运行 /compact 是个省钱的好习惯。
2. CLAUDE.md 是灵魂：如果你觉得 Claude 总是记不住你的编码习惯（比如缩进、命名规范），不要一遍遍在对话里重复，把它写进 CLAUDE.md 文件里。

下一步建议：
您可以尝试在您的终端输入 claude 启动，然后输入 /init 看看它为您当前的项目生成了什么样的分析报告。