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

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

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

以下是具体的操作方法：

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

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

bash 复制代码

claude -r
# 或者
claude --resume

执行后的效果：

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

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

2. 通过关键词搜索历史

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

bash 复制代码

claude -r "数据库"

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

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

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

bash 复制代码

claude -c
# 或者
claude --continue

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

4. 在运行中如何切换？

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

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

bash 复制代码

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

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

bash 复制代码

claude -r

5. 进阶：通过 Session ID 切换

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

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

bash 复制代码

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+)。

bash 复制代码

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

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

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

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

text 复制代码

> /init

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

Step 3: 日常对话 Loop

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

提出需求：

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

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

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

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

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

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

在对话中输入：

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

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

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

Step 5: 结束与提交

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

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

💡 核心提示

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

下一步建议 ：

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

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

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

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

2. 通过关键词搜索历史

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

4. 在运行中如何切换？

5. 进阶：通过 Session ID 切换

💡 总结对照表

1. Thought Process (思考过程)

2. Implementation Plan (执行计划)

3. Task List (任务清单)

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

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

1. 项目与记忆 (Project Intelligence)

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

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

4. 辅助功能 (Utilities)

二、 启动参数 (CLI Flags)

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

Step 1: 安装与登录

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

Step 3: 日常对话 Loop

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

Step 5: 结束与提交

💡 核心提示

二、启动参数 (CLI Flags)

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