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
  1. 重新启动并选择：
    再次运行选择命令：
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 库。”

  1. Claude 思考与规划：
    它会列出计划：1. 读取文件；2. 安装库；3. 修改代码；4. 运行测试。
  2. 工具执行 (Tool Use)：
    它会请求运行命令：npm install date-fns。
  • 你需要按 Enter 批准 (除非配置了自动允许)。
  1. 结果验证：
    它会修改文件，然后可能会主动运行 npm test 来验证自己改得对不对。
Step 4: 进阶技巧 (MCP 集成)

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

  1. 在对话中输入：

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

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

“搜索一下最新的 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 看看它为您当前的项目生成了什么样的分析报告。

Logo
https://edu.csdn.net/learn/39067/627173?utm_source=2019755004

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

cover

OpenCode：程序员的终端里，住进了一个真正“能干活”的 AI

avatar AI编程社区
cover

【爆肝】AI编程神器大洗牌！GitHub Copilot遇敌，Cursor崛起，企业开发者的2025生存指南

avatar AI编程社区
cover

AI编程工具未来预测：3年后，程序员可能都要靠这5款工具吃饭！

avatar AI编程社区