mirror of
https://github.com/claude-code-best/claude-code.git
synced 2026-06-22 16:25:51 +00:00
185 lines
8.6 KiB
Markdown
185 lines
8.6 KiB
Markdown
# 第三章：日常对话 -- 交互式 REPL 怎么用
|
||
|
||
> 装好 Claude Code 之后，每天打开它会做什么、怎么用。
|
||
|
||
## 发消息、看回复、中断与退出
|
||
|
||
启动 `claude` 之后，你会看到一个输入框。直接输入你想说的话，按 Enter 发送。Claude 的回复会以流式文本逐字出现，就像在聊天。
|
||
|
||
如果你中途觉得方向不对，想停下来，按 **Esc** 可以中断当前正在生成的回复。中断后，已输出的部分仍然保留在对话里，你可以换个方向继续追问。如果 Claude 正在调用某个工具（比如读文件或执行命令），Esc 也会中断工具执行。
|
||
|
||
想要彻底退出 REPL，按 **Ctrl+C**。第一次按会尝试中断当前任务，再次按会退出程序。
|
||
|
||
你也可以在非交互场景下使用 pipe 模式，一次性发送问题并获取结果：
|
||
|
||
```bash
|
||
echo "解释一下 package.json 里的 scripts 字段" | claude -p
|
||
```
|
||
|
||
这种模式下不需要启动完整的交互界面，适合脚本调用和快速提问。
|
||
|
||
## 会话持久化：恢复、历史与清空
|
||
|
||
Claude Code 会把每次对话自动保存为会话日志。下次你想继续上次的对话，有几种方式。
|
||
|
||
**恢复上次对话**：直接在输入框里输入 `/resume`，会弹出一个历史会话列表，你可以按时间或项目筛选。也可以在启动时直接恢复：
|
||
|
||
```bash
|
||
# 恢复当前项目最近的对话
|
||
claude --continue
|
||
|
||
# 恢复指定会话 ID 的对话
|
||
claude --resume <session-id>
|
||
|
||
# 恢复时创建新的会话 ID（不影响原始会话）
|
||
claude --continue --fork-session
|
||
```
|
||
|
||
`--continue`（简写 `-c`）恢复当前目录下最近一次对话，`--resume` 可以指定会话 ID 或搜索关键词。
|
||
|
||
**查看历史**：输入 `/history`（别名 `/hist`）可以浏览所有历史会话，包括跨项目的记录。
|
||
|
||
**清空当前上下文**：如果对话太长、上下文窗口快满了，输入 `/clear`（别名 `/reset`、`/new`）会清空当前对话历史，从零开始。这不会删除会话日志，只是释放当前上下文窗口。
|
||
|
||
## 切换模型与思考强度
|
||
|
||
不同的任务适合不同的模型。你可以随时在对话中切换。
|
||
|
||
**切换模型**：输入 `/model`，后面跟模型名称即可。不传参数时会显示当前使用的模型：
|
||
|
||
```
|
||
/model claude-sonnet-4-20250514
|
||
/model opus
|
||
```
|
||
|
||
模型名称支持简写。切换后立即生效，下一轮对话就会使用新模型。
|
||
|
||
**调整思考强度**：用 `/effort` 命令控制 Claude 的推理深度：
|
||
|
||
```
|
||
/effort low # 快速响应，适合简单问题
|
||
/effort medium # 默认，平衡速度和质量
|
||
/effort high # 深度思考，适合复杂任务
|
||
/effort xhigh # 扩展推理，超过 high 但不到 max
|
||
/effort max # 最大推理强度（外部用户为会话级，不持久化）
|
||
/effort auto # 让系统自动决定
|
||
```
|
||
|
||
设置会持久化到用户配置，下次启动仍然生效。你也可以通过环境变量 `CLAUDE_CODE_EFFORT_LEVEL` 设置。
|
||
|
||
**ultrathink 触发词**：当 `ULTRATHINK` feature 启用时，在输入中包含 `ultrathink` 关键词会自动将本轮对话的思考强度提升到 `high`。这是一种"按需激活"的方式，不需要提前切换 `/effort`，只需在需要深度思考的那一轮输入里写上 ultrathink 即可。
|
||
|
||
## 权限模式切换
|
||
|
||
Claude Code 执行文件读写、Shell 命令等操作时，默认会逐个询问你是否允许。你可以通过 `/mode` 命令切换交互模式来调整这个行为。
|
||
|
||
输入 `/mode` 后会弹出一个选择器，可用的模式包括：
|
||
|
||
- `default` -- 标准模式，每次工具调用都需要确认
|
||
- `gentle` -- 更温和的交互风格
|
||
- `sharp` -- 精简直接
|
||
- `workhorse` -- 工作流优化，减少不必要的确认
|
||
- `token-saver` -- 节省 token 消耗
|
||
- `super-ai` -- 高自主性模式
|
||
|
||
模式切换会立即生效并持久化到配置中。选择哪种模式取决于你的信任程度和任务类型：在做探索性任务时可以用更自主的模式，在操作关键文件时切回 default。
|
||
|
||
## 查看 token 消耗与费用
|
||
|
||
想知道这一轮对话花了多少钱、用了多少 token，输入 `/usage`（别名 `/cost` 或 `/stats`）。
|
||
|
||
```
|
||
/usage
|
||
```
|
||
|
||
这会显示当前会话的费用估算、token 使用量、以及计划限额的剩余情况。对于有 rate limit 的 Provider，还会显示限流相关状态。
|
||
|
||
费用追踪基于 API 响应中的 usage 字段实时计算，每个 Provider 的计费方式不同，但 `/usage` 会统一展示。
|
||
|
||
## 上下文管理与自动压缩
|
||
|
||
长时间对话会让上下文窗口越来越满。Claude Code 有几种机制来管理这个问题。
|
||
|
||
**手动压缩**：输入 `/compact` 可以触发上下文压缩。Claude 会把之前的对话总结成一段摘要，释放上下文空间但保留关键信息。你也可以附上自定义的压缩指令：
|
||
|
||
```
|
||
/compact 重点保留代码修改相关的讨论
|
||
```
|
||
|
||
系统在上下文接近上限时也会自动触发 compact，无需手动干预。
|
||
|
||
**强制剪裁**：输入 `/force-snip` 会在当前位置插入一个剪裁边界。边界之前的所有消息将从下一轮对话的模型视角中移除，但 REPL 的 UI 滚动历史仍然保留，你仍然可以往回翻看。与 `/compact` 不同，`/force-snip` 不会生成摘要，而是直接丢弃旧消息。
|
||
|
||
一般来说，优先使用 `/compact`（保留摘要），只有当你确认旧消息完全不再需要时才用 `/force-snip`。
|
||
|
||
## 导出与分享对话
|
||
|
||
有时候你想把对话内容保存下来或分享给同事。
|
||
|
||
**导出到文件**：输入 `/export` 会把当前对话导出为一个文件。支持指定文件名：
|
||
|
||
```
|
||
/export my-session.md
|
||
```
|
||
|
||
导出内容是纯文本格式，包含完整的对话记录，方便用其他工具查看或归档。
|
||
|
||
**上传分享**：输入 `/share` 会把当前会话日志上传到 GitHub Gist，生成一个可分享的链接：
|
||
|
||
```
|
||
/share # 默认创建 secret Gist
|
||
/share --public # 创建公开 Gist
|
||
/share --mask-secrets # 自动脱敏 API key 等凭证
|
||
/share --summary-only # 只分享摘要（每轮截取前 200 字符）
|
||
/share --allow-public-fallback # gh 不可用时回退到 0x0.st
|
||
```
|
||
|
||
**隐私提示**：`/share` 上传的 JSONL 文件包含当前会话的所有输入和工具输出。虽然 `--mask-secrets` 可以自动替换常见格式的 API key、Bearer token、AWS key 和 GitHub token，但不保证能覆盖所有敏感信息。分享前请确认内容安全。如果只想让别人了解大概讨论了什么，用 `--summary-only` 是更安全的选择。
|
||
|
||
**生成摘要**：输入 `/summary` 会让 Claude 对当前对话生成一份结构化的会话摘要。这比 `/compact` 更详细，适合在结束一个长会话前做总结归档。
|
||
|
||
## 更换主题、输出风格与语言
|
||
|
||
**主题**：输入 `/theme` 可以更换界面配色方案。适合根据终端背景和个人偏好调整。
|
||
|
||
**输出风格**：`/output-style` 命令可以调整 Claude 的回复风格（该命令目前标记为已废弃，推荐使用 `/config` 代替）。
|
||
|
||
**界面语言**：输入 `/lang` 可以切换显示语言：
|
||
|
||
```
|
||
/lang zh # 简体中文
|
||
/lang en # English
|
||
/lang auto # 跟随系统语言
|
||
```
|
||
|
||
这个设置影响的是界面提示和部分 UI 文本的显示语言，不影响 Claude 的回复语言（回复语言由对话上下文和 CLAUDE.md 配置决定）。
|
||
|
||
## 配置项目记忆：CLAUDE.md 与 /memory
|
||
|
||
Claude Code 每次启动时会自动加载项目目录下的 `CLAUDE.md` 文件作为上下文。你可以在里面写项目约定、代码规范、常用命令等，让 Claude "记住"你的项目特性。
|
||
|
||
CLAUDE.md 支持四层层级，后加载的优先级更高：
|
||
|
||
1. **Managed** -- 平台管理的全局指令
|
||
2. **User** -- 用户主目录下的 `~/.claude/CLAUDE.md`
|
||
3. **Project** -- 项目根目录的 `CLAUDE.md`
|
||
4. **Local** -- 子目录中的 `CLAUDE.md`
|
||
|
||
你可以用 `@include` 指令在 CLAUDE.md 里引用其他文件，支持相对路径、家目录路径和绝对路径：
|
||
|
||
```markdown
|
||
@./docs/coding-standards.md
|
||
@~/my-global-rules.md
|
||
@/etc/claude/company-rules.md
|
||
```
|
||
|
||
支持的文件类型不限于 `.md`，还包括 `.ts`、`.py`、`.rs`、`.sql` 等几十种文本格式。如果引用的文件不存在，会被静默忽略。
|
||
|
||
在对话中输入 `/memory` 可以直接编辑 Claude 的记忆文件，快速追加或修改项目知识。
|
||
|
||
## 下一步
|
||
|
||
- 想快速查找某个 slash 命令，看 [第四章：slash 命令速查](./04-slash-commands.md)
|
||
- 想接入外部工具扩展 Claude 的能力，看 [第五章：扩展 Claude 的能力](./05-extensions.md)
|
||
- 想了解 token 消耗优化和配置进阶，看 [第九章：省钱、提速、定制](./09-budget-config.md)
|