955 lines
20 KiB
Markdown
955 lines
20 KiB
Markdown
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="../../resources/logos/claude-howto-logo-dark.svg">
|
||
<img alt="Claude How To" src="../../resources/logos/claude-howto-logo.svg">
|
||
</picture>
|
||
|
||
# 高级功能
|
||
|
||
这是一份关于 Claude Code 高级能力的完整指南，涵盖 planning mode、extended thinking、auto mode、后台任务、权限模式、打印模式（非交互）、会话管理、交互功能、消息通道（Channels）、语音输入、远程控制、网页会话、桌面应用、任务列表、提示词建议、Git 工作树、沙盒、受管设置和配置。
|
||
|
||
## 目录
|
||
|
||
1. [概览](#概览)
|
||
2. [规划模式](#规划模式)
|
||
3. [扩展思考](#扩展思考)
|
||
4. [自动模式](#自动模式)
|
||
5. [后台任务](#后台任务)
|
||
6. [定时任务](#定时任务)
|
||
7. [权限模式](#权限模式)
|
||
8. [无头模式](#无头模式)
|
||
9. [会话管理](#会话管理)
|
||
10. [交互功能](#交互功能)
|
||
11. [语音输入](#语音输入)
|
||
12. [消息通道（Channels）](#消息通道channels)
|
||
13. [Chrome 集成](#chrome-集成)
|
||
14. [远程控制](#远程控制)
|
||
15. [网页会话](#网页会话)
|
||
16. [桌面应用](#桌面应用)
|
||
17. [任务列表](#任务列表)
|
||
18. [提示词建议](#提示词建议)
|
||
19. [Git 工作树（Git Worktrees）](#git-工作树git-worktrees)
|
||
20. [沙盒](#沙盒)
|
||
21. [企业受管设置](#企业受管设置)
|
||
22. [配置与设置](#配置与设置)
|
||
23. [最佳实践](#最佳实践)
|
||
24. [更多资源](#更多资源)
|
||
|
||
---
|
||
|
||
<a id="overview"></a>
|
||
## 概览
|
||
|
||
Claude Code 的高级功能把基础能力扩展到了规划、推理、自动化和控制层面。它们能支持更复杂的开发任务、代码审查、自动化流程以及多会话管理。
|
||
|
||
**核心高级功能包括：**
|
||
- **Planning Mode**：先写详细实现计划，再开始编码
|
||
- **Extended Thinking**：对复杂问题进行更深入的推理
|
||
- **Auto Mode**：由后台安全分类器在每一步执行前进行审查（Research Preview）
|
||
- **Background Tasks**：长时间任务不阻塞对话
|
||
- **Permission Modes**：控制 Claude 可以做什么（`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions`）
|
||
- **Print Mode**：非交互式运行，适合自动化和 CI/CD（`claude -p`）
|
||
- **Session Management**：管理多个会话
|
||
- **Interactive Features**：快捷键、多行输入、历史记录
|
||
- **Voice Dictation**：按住说话，支持 20 种语言的语音识别
|
||
- **Channels**：消息通道，允许 MCP server 向运行中的会话推送消息（Research Preview）
|
||
- **Remote Control**：从 Claude.ai 或 Claude app 控制本地会话
|
||
- **Web Sessions**：在浏览器中运行 Claude Code
|
||
- **Desktop App**：支持可视化 diff 审查和多会话的独立应用
|
||
- **Task List**：跨 context compaction 持久跟踪任务
|
||
- **Prompt Suggestions**：根据上下文智能推荐命令
|
||
- **Git 工作树（Git Worktrees）**：隔离的 worktree 分支，适合并行工作
|
||
- **Sandboxing**：操作系统级文件系统和网络隔离
|
||
- **Managed Settings**：通过 plist、Registry 或受管文件进行企业部署
|
||
- **Configuration**：用 JSON 配置文件定制行为
|
||
|
||
<a id="planning-mode"></a>
|
||
## 规划模式
|
||
|
||
更多规划示例见 [planning-mode-examples.md](planning-mode-examples.md)。
|
||
|
||
Planning mode 允许 Claude 在真正实现前先梳理复杂任务，生成一份你可以审阅并批准的详细计划。
|
||
|
||
### 什么是 Planning Mode？
|
||
|
||
Planning mode 是一个两阶段流程：
|
||
1. **规划阶段**：Claude 分析任务并生成详细实现计划
|
||
2. **实现阶段**：在你批准后，Claude 执行计划
|
||
|
||
### 什么时候使用 Planning Mode
|
||
|
||
✅ 适合：
|
||
- 复杂的多文件重构
|
||
- 新功能开发
|
||
- 架构调整
|
||
- 数据库迁移
|
||
- 大型 API 重设计
|
||
|
||
❌ 不建议：
|
||
- 简单 bug 修复
|
||
- 格式化修改
|
||
- 单文件编辑
|
||
- 快速查询
|
||
|
||
### 如何启动 Planning Mode
|
||
|
||
**Slash command：**
|
||
```bash
|
||
/plan Implement user authentication system
|
||
```
|
||
|
||
**CLI 参数：**
|
||
```bash
|
||
claude --permission-mode plan
|
||
```
|
||
|
||
**设为默认：**
|
||
```json
|
||
{
|
||
"permissions": {
|
||
"defaultMode": "plan"
|
||
}
|
||
}
|
||
```
|
||
|
||
**快捷键：**
|
||
- `Shift + Tab` - 切换权限模式（包括 plan）
|
||
- `Alt + M` - 切换权限模式（Windows/Linux）
|
||
|
||
### Planning Mode 的好处
|
||
|
||
- **结构化实施方式**：把实现步骤拆得更清楚
|
||
- **审阅和批准**：先看计划，再执行
|
||
- **风险识别**：先发现潜在问题
|
||
- **阶段清晰**：有明确的里程碑和阶段划分
|
||
|
||
### 示例：功能实现
|
||
|
||
```text
|
||
User: /plan Add a real-time notification system
|
||
|
||
Claude: 我会为实时通知系统制定计划。
|
||
|
||
## 实现计划
|
||
|
||
### 阶段 1：基础设施
|
||
1. 安装 WebSocket 库（socket.io）
|
||
2. 搭建 WebSocket server
|
||
3. 配置连接管理
|
||
|
||
### 阶段 2：后端
|
||
4. 创建通知服务
|
||
5. 实现通知队列
|
||
6. 为通知添加数据库 schema
|
||
7. 创建 API 端点
|
||
|
||
### 阶段 3：前端
|
||
8. 搭建 WebSocket client
|
||
9. 创建通知 UI 组件
|
||
10. 实现通知状态管理
|
||
11. 添加通知权限
|
||
|
||
### 阶段 4：测试与发布
|
||
12. 编写单元测试
|
||
13. 编写集成测试
|
||
14. 更新文档
|
||
15. 部署到 staging
|
||
|
||
预计时间：3-4 小时
|
||
需要修改的文件：12 个
|
||
需要创建的新文件：8 个
|
||
|
||
准备继续吗？（yes/no/modify plan）
|
||
```
|
||
|
||
### 计划修改
|
||
|
||
```text
|
||
User: 修改计划 - 先跳过队列，后面再加
|
||
|
||
Claude: 已更新计划：
|
||
[展示删除队列后的计划]
|
||
|
||
User: 看起来不错，继续
|
||
|
||
Claude: [按修改后的计划开始实现]
|
||
```
|
||
|
||
### Planning Mode 配置
|
||
|
||
你可以通过 CLI 参数或 slash command 启用 planning mode：
|
||
|
||
```bash
|
||
# 通过 CLI 启用 plan mode
|
||
claude --permission-mode plan
|
||
|
||
# 或在 REPL 里使用 /plan
|
||
/plan Implement user authentication system
|
||
```
|
||
|
||
**规划专用模型别名**：使用 `opusplan`，规划用 Opus，执行用 Sonnet：
|
||
|
||
```bash
|
||
claude --model opusplan "design and implement the new API"
|
||
```
|
||
|
||
**外部编辑计划**：按 `Ctrl+G` 可以把当前计划打开到外部编辑器里进行更详细的修改。
|
||
|
||
<a id="extended-thinking"></a>
|
||
## 扩展思考
|
||
|
||
Extended thinking 让 Claude 在给出解决方案前，花更多时间进行复杂推理。
|
||
|
||
### 什么是 Extended Thinking？
|
||
|
||
这是一个有意识的、分步骤的推理过程，Claude 会：
|
||
- 拆解复杂问题
|
||
- 比较多种方案
|
||
- 评估权衡
|
||
- 推导边界情况
|
||
|
||
### 如何启用
|
||
|
||
**快捷键：**
|
||
- `Option + T`（macOS）/ `Alt + T`（Windows/Linux）- 切换 extended thinking
|
||
|
||
**自动启用：**
|
||
- 对所有模型默认开启（Opus 4.6、Sonnet 4.6、Haiku 4.5）
|
||
- Opus 4.6 支持自适应推理，effort 等级为 `low`（○）、`medium`（◐）、`high`（●）、`max`（仅 Opus 4.6）
|
||
|
||
### 好处
|
||
|
||
- 更适合复杂问题
|
||
- 更容易发现边界条件
|
||
- 便于比较多个方案
|
||
- 输出通常更稳健
|
||
|
||
### 示例：架构决策
|
||
|
||
```text
|
||
Context Analysis
|
||
Approach 1: Microservices
|
||
Approach 2: Monolith
|
||
Decision Factors
|
||
Recommendation
|
||
```
|
||
|
||
### 配置
|
||
|
||
```json
|
||
{
|
||
"thinking": {
|
||
"enabled": true,
|
||
"effort": "high"
|
||
}
|
||
}
|
||
```
|
||
|
||
<a id="auto-mode"></a>
|
||
## 自动模式
|
||
|
||
Auto mode 是一个研究预览功能。它会在每个动作执行前，用后台安全分类器评估风险，帮助你在自动化和安全之间取得平衡。
|
||
|
||
### 需求
|
||
|
||
- 支持 auto mode 的 Claude Code 版本
|
||
- 合适的权限和配置
|
||
|
||
### 启用方式
|
||
|
||
```bash
|
||
# 用 CLI 解锁 auto mode
|
||
claude --enable-auto-mode
|
||
|
||
# 然后在 REPL 中用 Shift+Tab 切换到它
|
||
```
|
||
|
||
### 分类器如何工作
|
||
|
||
在执行工具前，后台分类器会判断这个动作是否安全、是否需要提示、是否应该被阻止。
|
||
|
||
### 默认阻止的动作
|
||
|
||
- 明显危险的文件操作
|
||
- 高风险 shell 命令
|
||
- 可能泄露凭据的操作
|
||
|
||
### 默认允许的动作
|
||
|
||
- 只读检查
|
||
- 常规分析
|
||
- 低风险修改
|
||
|
||
### 配置 Auto Mode
|
||
|
||
Auto mode 可以在设置中进一步约束、放宽或与权限模式结合使用。
|
||
|
||
### 回退行为
|
||
|
||
如果分类器无法判定，Claude 会回退到更保守的权限处理方式。
|
||
|
||
### 预置一份类似 Auto-Mode 的保守权限基线
|
||
|
||
```bash
|
||
# 先预览将要添加的权限（不会写入）
|
||
|
||
# 应用保守基线
|
||
|
||
# 只有在需要时再逐步增加能力
|
||
```
|
||
|
||
<a id="background-tasks"></a>
|
||
## 后台任务
|
||
|
||
后台任务允许 Claude 在不阻塞对话的情况下运行长时间操作。
|
||
|
||
### 什么是后台任务？
|
||
|
||
后台任务适合长时间运行的工作，例如构建、测试、下载、扫描或并行分析。你可以把它们交给 Claude，让对话继续保持响应。
|
||
|
||
### 启动后台任务
|
||
|
||
你可以从命令、计划或工具链中启动后台任务，让 Claude 在后台继续工作。
|
||
|
||
### 管理后台任务
|
||
|
||
- 查看任务状态
|
||
- 中止任务
|
||
- 等待任务完成
|
||
- 从结果中恢复上下文
|
||
|
||
### 示例：并行开发
|
||
|
||
```text
|
||
任务 A：运行测试
|
||
任务 B：生成文档
|
||
任务 C：执行安全扫描
|
||
```
|
||
|
||
### 配置
|
||
|
||
后台任务的超时、并发和通知行为都可以在设置中调整。
|
||
|
||
<a id="scheduled-tasks"></a>
|
||
## 定时任务
|
||
|
||
Scheduled tasks 让 Claude 按计划重复执行某些提示词或任务。
|
||
|
||
### `/loop` 命令
|
||
|
||
```bash
|
||
# 显式间隔
|
||
/loop 10m Run tests and report failures
|
||
|
||
# 自然语言
|
||
/loop every day at 9am check release notes
|
||
```
|
||
|
||
### 一次性提醒
|
||
|
||
```bash
|
||
/schedule "remind me to review the PR in 30 minutes"
|
||
```
|
||
|
||
### 管理定时任务
|
||
|
||
- 查看任务列表
|
||
- 修改执行频率
|
||
- 暂停或取消任务
|
||
|
||
### 行为细节
|
||
|
||
定时任务会遵循当前会话与权限配置，并按计划触发执行。
|
||
|
||
### 云端定时任务
|
||
|
||
部分场景可以在云端环境中运行调度任务。
|
||
|
||
### 禁用定时任务
|
||
|
||
如果你不希望自动触发，关闭相关设置即可。
|
||
|
||
### 示例：监控部署
|
||
|
||
```text
|
||
每 5 分钟检查一次部署状态，直到 health check 通过。
|
||
```
|
||
|
||
<a id="permission-modes"></a>
|
||
## 权限模式
|
||
|
||
Permission modes 决定 Claude 可以直接执行哪些操作。
|
||
|
||
### 可用模式
|
||
|
||
- `default`
|
||
- `acceptEdits`
|
||
- `plan`
|
||
- `auto`
|
||
- `dontAsk`
|
||
- `bypassPermissions`
|
||
|
||
### 启用方式
|
||
|
||
可以通过命令行、设置或会话中的快捷操作切换权限模式。
|
||
|
||
### 示例
|
||
|
||
#### Default Mode
|
||
|
||
默认的平衡模式，必要时会询问权限。
|
||
|
||
#### Plan Mode
|
||
|
||
只做规划，不直接执行高风险改动。
|
||
|
||
#### Accept Edits Mode
|
||
|
||
更偏向自动接受编辑，适合受控环境。
|
||
|
||
### 使用场景
|
||
|
||
- 代码审查
|
||
- 自动化重构
|
||
- CI/CD
|
||
- 高风险操作前的审批流程
|
||
|
||
<a id="headless-mode"></a>
|
||
## 无头模式
|
||
|
||
Headless mode 指非交互式运行 Claude Code，常用于自动化和 CI/CD。
|
||
|
||
### 什么是 Print Mode？
|
||
|
||
Print mode 就是 `claude -p`：给一个任务，输出结果，然后退出。
|
||
|
||
### 在 Print Mode 中运行
|
||
|
||
```bash
|
||
# 运行指定任务
|
||
claude -p "run tests and summarize failures"
|
||
|
||
# 处理管道内容
|
||
cat logs.txt | claude -p "find the root cause"
|
||
|
||
# CI/CD 集成
|
||
claude -p "review this diff and return JSON"
|
||
```
|
||
|
||
### 其他示例
|
||
|
||
```bash
|
||
# 捕获输出
|
||
claude -p "analyze this code" > report.txt
|
||
|
||
# 结构化输出
|
||
claude -p --output-format json "list files"
|
||
|
||
# 标准输入
|
||
echo "hello" | claude -p "translate to Chinese"
|
||
```
|
||
|
||
### CI/CD 示例
|
||
|
||
```yaml
|
||
# .github/workflows/code-review.yml
|
||
```
|
||
|
||
### Print Mode 配置
|
||
|
||
- 限制自主回合数
|
||
- 使用结构化 JSON 输出
|
||
- 启用 schema 验证
|
||
- 禁用会话持久化
|
||
|
||
<a id="session-management"></a>
|
||
## 会话管理
|
||
|
||
会话管理用于在多个会话之间恢复、重命名、分叉和持续工作。
|
||
|
||
### 常用命令
|
||
|
||
- `/resume`
|
||
- `/rename`
|
||
- `/fork`
|
||
- `claude -c`
|
||
- `claude -r`
|
||
|
||
### 恢复会话
|
||
|
||
```bash
|
||
# 继续最后一次对话
|
||
claude -c
|
||
|
||
# 恢复指定名称或 ID 的会话
|
||
claude -r "feature-auth"
|
||
```
|
||
|
||
### 分叉会话
|
||
|
||
```bash
|
||
# 恢复并分叉，适合实验
|
||
claude -r "feature-auth" --fork
|
||
```
|
||
|
||
### 会话持久化
|
||
|
||
你可以选择保留、继续或重建会话上下文。
|
||
|
||
<a id="interactive-features"></a>
|
||
## 交互功能
|
||
|
||
交互功能包括快捷键、多行输入、历史记录、Vim 模式和 Bash 模式等。
|
||
|
||
### 快捷键
|
||
|
||
常用快捷键用于切换模式、编辑输入、查看历史和控制输出。
|
||
|
||
### 自定义快捷键
|
||
|
||
你可以在设置中绑定自己的按键组合。
|
||
|
||
### 可用上下文
|
||
|
||
不同上下文会影响快捷键的可用性和行为。
|
||
|
||
### Chord 支持
|
||
|
||
支持组合按键触发复杂操作。
|
||
|
||
### 保留键与冲突键
|
||
|
||
某些按键会被系统或终端占用，需要避免冲突。
|
||
|
||
### Tab 补全
|
||
|
||
输入命令、参数或路径时会提供补全建议。
|
||
|
||
### 命令历史
|
||
|
||
Claude 会保留历史记录，方便你快速重用之前的输入。
|
||
|
||
### 多行输入
|
||
|
||
```text
|
||
第一行
|
||
第二行
|
||
第三行
|
||
```
|
||
|
||
### 行内编辑
|
||
|
||
支持在输入过程中编辑中间内容。
|
||
|
||
### Vim 模式
|
||
|
||
如果你熟悉 Vim，可以启用类似的编辑体验。
|
||
|
||
### Bash 模式
|
||
|
||
可在会话中直接进入更偏 shell 风格的操作方式。
|
||
|
||
<a id="voice-dictation"></a>
|
||
## 语音输入
|
||
|
||
语音输入支持按住说话和多语言识别，适合快速记录想法或在不方便键盘输入时使用。
|
||
|
||
### 如何启用
|
||
|
||
在设置中打开语音输入即可。
|
||
|
||
### 特性
|
||
|
||
- 支持按住说话
|
||
- 支持 20 种语言的语音识别
|
||
- 适合快速口述任务
|
||
|
||
### 配置
|
||
|
||
可在 settings 中控制灵敏度、语言和输入行为。
|
||
|
||
<a id="channels"></a>
|
||
## 消息通道（Channels）
|
||
|
||
消息通道允许 MCP servers 向正在运行的会话推送消息。
|
||
|
||
### 订阅 channels
|
||
|
||
```bash
|
||
# 启动时订阅 channel 插件
|
||
```
|
||
|
||
### 支持的集成
|
||
|
||
- Discord
|
||
- Telegram
|
||
- 其他 channel 型集成
|
||
|
||
### 配置
|
||
|
||
通过 MCP 配置或 settings 订阅相应 channel。
|
||
|
||
### 工作方式
|
||
|
||
外部系统可以把消息推送进 Claude 的当前会话里，让你在一个会话中接收通知或事件。
|
||
|
||
<a id="chrome-integration"></a>
|
||
## Chrome 集成
|
||
|
||
Chrome 集成让 Claude 可以协助浏览器自动化和站点级操作。
|
||
|
||
### 启用 Chrome 集成
|
||
|
||
开启相关开关后，Claude 就可以与浏览器协作。
|
||
|
||
### 能力
|
||
|
||
- 浏览器自动化
|
||
- 页面操作
|
||
- 网站级交互
|
||
|
||
### 站点级权限
|
||
|
||
你可以对站点设置更细粒度的访问权限。
|
||
|
||
### 工作方式
|
||
|
||
Claude 通过浏览器连接与页面交互。
|
||
|
||
### 已知限制
|
||
|
||
- 某些站点会限制自动化
|
||
- 复杂页面可能需要更多权限
|
||
|
||
<a id="remote-control"></a>
|
||
## 远程控制
|
||
|
||
Remote Control 可以让你从 Claude.ai 或 Claude app 远程控制本地 Claude Code 会话。
|
||
|
||
### 启动 Remote Control
|
||
|
||
```bash
|
||
# 使用默认会话名启动
|
||
claude --remote-control
|
||
|
||
# 使用自定义名称
|
||
claude --remote-control --name my-session
|
||
```
|
||
|
||
### 连接到会话
|
||
|
||
你可以在远程端连接到已经启动的本地会话，继续同一个上下文。
|
||
|
||
### 安全性
|
||
|
||
远程控制会牵涉到会话和权限，因此建议只在可信环境中使用。
|
||
|
||
### Remote Control vs Claude Code on the web
|
||
|
||
Remote Control 是控制本地会话；web 版则是在浏览器中直接运行。
|
||
|
||
### 局限
|
||
|
||
- 网络可用性依赖更高
|
||
- 某些本地资源可能不可远程访问
|
||
|
||
### 使用场景
|
||
|
||
- 在手机上查看并接管会话
|
||
- 远程继续长期任务
|
||
|
||
<a id="web-sessions"></a>
|
||
## 网页会话
|
||
|
||
Web Sessions 允许你直接在浏览器里创建和恢复 Claude Code 会话。
|
||
|
||
### 创建 Web Session
|
||
|
||
```bash
|
||
# 从 CLI 创建新的 web session
|
||
claude --remote "implement API"
|
||
```
|
||
|
||
### 在本地恢复 Web Session
|
||
|
||
```bash
|
||
# 在本地终端恢复 web session
|
||
claude --teleport
|
||
```
|
||
|
||
### 使用场景
|
||
|
||
- 浏览器里快速开始任务
|
||
- 在本地和网页之间切换
|
||
- 远程继续工作
|
||
|
||
<a id="desktop-app"></a>
|
||
## 桌面应用
|
||
|
||
桌面应用提供独立界面，适合视觉化 diff 审查和多会话管理。
|
||
|
||
### 安装
|
||
|
||
按照桌面应用的安装说明安装即可。
|
||
|
||
### 从 CLI 接力
|
||
|
||
你可以把 CLI 会话交给桌面应用继续处理。
|
||
|
||
### 核心功能
|
||
|
||
- 可视化 diff
|
||
- 多会话
|
||
- 更直观的审查体验
|
||
|
||
### App 预览配置
|
||
|
||
可以调整预览、布局和视觉呈现方式。
|
||
|
||
### Connectors
|
||
|
||
桌面应用可以连接到不同的工作环境。
|
||
|
||
### 远程和 SSH 会话
|
||
|
||
桌面应用也支持远程或 SSH 场景下的接力。
|
||
|
||
### Desktop 中的权限模式
|
||
|
||
Desktop 里同样可以使用不同的权限模式。
|
||
|
||
### 企业功能
|
||
|
||
企业部署下可使用更多受管和合规相关能力。
|
||
|
||
<a id="task-list"></a>
|
||
## 任务列表
|
||
|
||
Task List 用于跨 context compaction 持久保存任务进度。
|
||
|
||
### 切换任务列表
|
||
|
||
在设置里打开或关闭任务列表显示。
|
||
|
||
### 持久任务
|
||
|
||
任务会保留，即使上下文被压缩，也能继续跟踪。
|
||
|
||
### 命名任务目录
|
||
|
||
你可以给任务分组或目录命名，方便管理。
|
||
|
||
<a id="prompt-suggestions"></a>
|
||
## 提示词建议
|
||
|
||
Prompt suggestions 会根据当前上下文智能推荐下一步命令或提示词。
|
||
|
||
### 工作方式
|
||
|
||
系统会结合你的历史、当前任务和上下文给出建议。
|
||
|
||
### 禁用建议
|
||
|
||
如果你不想看到建议，可以在设置里关闭。
|
||
|
||
<a id="git-worktrees"></a>
|
||
## Git 工作树（Git Worktrees）
|
||
|
||
Git worktrees 让你在隔离的目录里并行工作，非常适合实验和分支开发。
|
||
|
||
### 从 worktree 启动
|
||
|
||
```bash
|
||
# 在隔离 worktree 中启动 Claude Code
|
||
claude -w
|
||
```
|
||
|
||
### Worktree 位置
|
||
|
||
你可以控制 worktree 的放置位置，保持主工作区整洁。
|
||
|
||
### Monorepo 的 sparse checkout
|
||
|
||
在大型 monorepo 中，可配合 sparse checkout 只加载需要的部分。
|
||
|
||
### Worktree 工具和 Hooks
|
||
|
||
worktree 场景下依然可以配合工具和 hooks 自动化流程。
|
||
|
||
### 自动清理
|
||
|
||
不需要的 worktree 可以自动清理。
|
||
|
||
### 使用场景
|
||
|
||
- 并行尝试多个方案
|
||
- 隔离高风险重构
|
||
- 保持主分支整洁
|
||
|
||
<a id="sandboxing"></a>
|
||
## 沙盒
|
||
|
||
沙盒提供文件系统和网络层面的隔离，能显著降低自动化操作的风险。
|
||
|
||
### 启用沙盒
|
||
|
||
开启后，Claude 的很多操作都会在受控环境里执行。
|
||
|
||
### 配置项
|
||
|
||
你可以配置允许访问的目录、网络行为和例外列表。
|
||
|
||
### 示例配置
|
||
|
||
```json
|
||
{
|
||
"sandbox": {
|
||
"enabled": true
|
||
}
|
||
}
|
||
```
|
||
|
||
### 工作方式
|
||
|
||
沙盒会限制 Claude 可触达的文件和网络边界。
|
||
|
||
### 使用场景
|
||
|
||
- 低风险自动化
|
||
- 在不完全信任的输入上执行任务
|
||
- 受控环境中的批处理
|
||
|
||
<a id="managed-settings-enterprise"></a>
|
||
## 企业受管设置
|
||
|
||
企业可以通过受管设置统一分发 Claude Code 配置。
|
||
|
||
### 部署方式
|
||
|
||
- plist
|
||
- Registry
|
||
- 受管文件
|
||
|
||
### 受管配置片段
|
||
|
||
通过受管配置片段，可以给团队统一推送策略。
|
||
|
||
### 可用的受管设置
|
||
|
||
- 权限模式
|
||
- 功能开关
|
||
- MCP / hooks / 插件约束
|
||
|
||
### macOS plist 示例
|
||
|
||
```xml
|
||
<!-- 示例略 -->
|
||
```
|
||
|
||
<a id="configuration-and-settings"></a>
|
||
## 配置与设置
|
||
|
||
### 配置文件位置
|
||
|
||
- `~/.claude/settings.json`
|
||
- `.claude/settings.json`
|
||
- `.claude/settings.local.json`
|
||
|
||
### 完整配置示例
|
||
|
||
```json
|
||
{
|
||
"permissions": {
|
||
"defaultMode": "plan"
|
||
},
|
||
"thinking": {
|
||
"enabled": true,
|
||
"effort": "high"
|
||
},
|
||
"autoCheckpoint": true
|
||
}
|
||
```
|
||
|
||
### 环境变量
|
||
|
||
#### 模型选择
|
||
|
||
- `ANTHROPIC_API_KEY`
|
||
- `CLAUDE_MODEL`
|
||
|
||
#### API 配置
|
||
|
||
- `ANTHROPIC_API_KEY`
|
||
|
||
#### Thinking 配置
|
||
|
||
- `CLAUDE_EFFORT`
|
||
|
||
#### 功能开关
|
||
|
||
- `CLAUDE_ENABLE_AUTO_MODE`
|
||
|
||
#### MCP 配置
|
||
|
||
- `CLAUDE_MCP_CONFIG`
|
||
|
||
#### 任务管理
|
||
|
||
- `CLAUDE_TASK_LIST`
|
||
|
||
#### Agent team（实验性）
|
||
|
||
- `CLAUDE_TEAM_MODE`
|
||
|
||
#### Subagent 和 plugin 配置
|
||
|
||
- `CLAUDE_PLUGIN_DATA`
|
||
|
||
#### 子进程和流式处理
|
||
|
||
- `CLAUDE_OUTPUT_FORMAT`
|
||
|
||
### 配置管理命令
|
||
|
||
你可以用命令查看或更新当前配置，并把它们落到 settings 中。
|
||
|
||
### 每个项目的配置
|
||
|
||
推荐把项目专用设置放进项目内的 `.claude/settings.json`，这样能跟代码一起版本化。
|
||
|
||
<a id="best-practices"></a>
|
||
## 最佳实践
|
||
|
||
### Planning Mode
|
||
|
||
- 复杂任务先规划，再实现
|
||
- 计划要可审阅
|
||
|
||
### Extended Thinking
|
||
|
||
- 留给复杂问题
|
||
- 不要在简单任务上过度使用
|
||
|
||
### Background Tasks
|
||
|
||
- 用于长时间、可并行的任务
|
||
- 记得设置超时和可见性
|
||
|
||
### Permissions
|
||
|
||
- 默认最小权限
|
||
- 只在必要时放宽
|
||
|
||
### Sessions
|
||
|
||
- 为重要会话命名
|
||
- 必要时分叉，而不是硬改
|
||
|
||
<a id="additional-resources"></a>
|
||
## 更多资源
|
||
|
||
- [根目录中文指南](../README.md)
|
||
- [Slash Commands 中文参考](../01-slash-commands/README.md)
|
||
- [Checkpoints 中文指南](../08-checkpoints/README.md)
|
||
- [Plugins 中文指南](../07-plugins/README.md)
|
||
- [CLI 中文参考](../10-cli/README.md)
|