本节目标

完成本节后，你将能够：

1. 熟练使用 Claude Code 的全部 CLI 启动参数，按需定制行为

2. 在三种运行模式（交互/单次/管道）之间自由切换

3. 掌握文件级和项目级操作的命令

4. 在 VS Code 和 JetBrains IDE 中集成 Claude Code

5. 知道"什么时候用什么参数"而不是一股脑复制粘贴

---

核心知识点

CLI 启动参数全览

Claude Code 的 CLI 参数决定了每次启动时的运行时行为。以下是 v2.1.x 的完整参数表：

参数	作用	实际场景
--model <model>	指定使用哪个模型	claude --model claude-sonnet-4-20250514
--worktree	在 Git worktree 中启动隔离环境	并行处理多个分支时使用
--debug	启用调试模式，输出详细日志	排查行为异常时使用
--bare	极简模式，不加载 CLAUDE.md	快速回答，不需要项目上下文
--max-turns <N>	限制最大对话轮数	防止意外超支，适合脚本化调用
--no-color	禁用彩色输出	日志文件重定向时使用
--verbose	显示额外的诊断信息	理解 AI 的文件搜索和工具调用过程
-p "<prompt>"	单次模式，执行后退出	claude -p "这个项目的入口文件是什么？"
--continue	恢复上一个会话	意外退出后继续工作
--session-id <id>	指定会话 ID	多会话管理场景

三种运行模式的深度解析

模式 1：交互模式（默认）

claude
claude --model claude-opus-4-20250514   # 用 Opus 模型启动
claude --debug                            # 带调试日志启动
claude --max-turns 20                     # 限制 20 轮对话

交互模式是 Claude Code 的"标准形态"。终端内提供的完整 TUI 包含对话区、文件对比视图和权限审批面板。适合所有需要多轮交互的开发任务。

模式 2：单次模式（-p / --print）

# 快速查询
claude -p "这个项目用的是什么测试框架？"
​
# 代码审查
claude -p "审查 src/utils.ts，找出潜在的性能问题"
​
# 生成命令
claude -p "为这个项目生成 Docker 构建命令" > docker-build.sh
​
# 组合使用（指定模型 + 限制轮次）
claude --model claude-sonnet-4-20250514 --max-turns 3 -p "分析 package.json 中的所有过时依赖"

单次模式的核心特点是：执行一次推理，输出结果，立即退出。它不保存对话历史，不进入交互界面。适合：

• CI/CD 流水线中的自动化检查

• 快速查询项目信息

• 脚本化批量处理

• Git hooks 中的自动检查

模式 3：管道模式（Pipe Mode）

# 日志分析
tail -100 /var/log/app.log | claude -p "找出所有 ERROR 级别的日志，分类汇总"
​
# 代码差异审查
git diff HEAD~5 | claude -p "审查这 5 个提交的变更，重点检查安全问题和破坏性更改"
​
# 测试输出分析
npm test 2>&1 | claude -p "分析测试失败的原因，按模块分组报告"
​
# JSON 数据处理
cat data.json | claude -p "提取所有 email 字段并去重"

管道模式让 Claude Code 成为 Unix 工具链中的一环。你可以把任何文本内容通过管道传给 Claude Code，让它分析、转换、审查、总结。这是 Claude Code 区别于所有 IDE 插件的根本能力——它是一个真正的命令行工具，不是一个 UI 挂件。

文件级操作

在交互模式中，Claude Code 提供了一系列文件级操作能力。你不需要手动执行这些操作——你用自然语言描述意图，Claude Code 调用相应的工具来完成。但了解底层能力有助于你更精确地表达需求：

操作	工具	示例描述
读取文件	Read	"读取 src/config.ts 中的配置"
创建文件	Write	"创建 src/utils/format.ts"
编辑文件	Edit	"将 formatDate 函数的参数类型改为 Date"
搜索内容	Grep	"找出项目中所有使用 axios 的地方"
搜索文件	Glob	"找到所有 .test.ts 文件"
执行命令	Bash	"运行 npm test"

项目级操作

Claude Code 也理解项目级的概念：

操作	说明	触发方式
初始化规则	为项目生成 CLAUDE.md	/init
上下文刷新	清空当前会话记忆	/clear
上下文压缩	压缩对话历史以节省 token	/compact
成本查看	查看当前会话 token 消耗	/cost
诊断检查	验证系统配置	/doctor
权限配置	调整当前会话的权限级别	/security
会话恢复	恢复之前的会话	claude --continue

IDE 集成

Claude Code 虽然本质上是终端工具，但也提供了与主流 IDE 的集成方式。

VS Code 集成

安装 Claude Code 的 VS Code 扩展后：

• 在 VS Code 终端中使用 claude 命令，当前打开的文件目录自动作为工作目录

• 选中代码后右键可以"Send to Claude Code"

• VS Code 的终端面板直接运行 Claude Code 交互会话

# 在 VS Code 终端中
claude
# Claude Code 自动识别当前 VS Code 工作区的项目

JetBrains IDE 集成

JetBrains（IntelliJ、WebStorm、PyCharm 等）的支持方式：

• 在 IDE 内置终端中运行 claude

• Claude Code 自动读取项目根目录的 CLAUDE.md

• 使用 IDE 的 Terminal 工具窗口进行交互

关键理解：Claude Code 的 IDE 集成不是"嵌入 IDE 的面板"，而是"在 IDE 的终端中运行原生 Claude Code"。这带来了一个巨大优势——你的 Claude Code 工作流在任何终端环境中都是一致的，不受 IDE 限制。

---

实操步骤

步骤 1：参数组合实验

在一个测试项目中，依次尝试以下命令：

# 1. 基准体验：默认交互模式
claude
​
# 2. 快速单次查询（注意退出方式的不同）
claude -p "列出这个项目中的所有 TypeScript 文件"
​
# 3. 指定模型 + 限制轮次
claude --model claude-haiku-3-5-20241022 --max-turns 5 -p "为 src/ 下的代码提 3 条改进建议"
​
# 4. 调试模式（观察额外日志输出）
claude --debug -p "读取 package.json 并告诉我项目名和版本号"
​
# 5. 极简模式（不加载 CLAUDE.md）
claude --bare -p "这段代码是做什么的？" <<< "const x = arr.map(([k,v]) => ({k,v}));"

观察每种组合下的行为差异，特别是 --bare 和 --debug 的输出区别。

步骤 2：管道模式的实战练习

创建一个测试场景：

# 生成一些日志数据
cat > test.log << 'EOF'
[2026-05-26 10:01:23] INFO: Server started on port 3000
[2026-05-26 10:01:25] ERROR: Database connection failed - timeout
[2026-05-26 10:01:30] INFO: Retrying database connection...
[2026-05-26 10:01:35] ERROR: Database connection failed - authentication error
[2026-05-26 10:01:40] WARN: Circuit breaker opened for database
[2026-05-26 10:02:00] INFO: Using cache fallback
[2026-05-26 10:05:00] INFO: Database connection restored
EOF

然后通过管道分析：

cat test.log | claude -p "分析这个服务器日志：
1. 找出所有 ERROR 事件及原因
2. 重建事件时间线
3. 判断根因并给出修复建议
"

步骤 3：文件操作命令链

在交互模式中，用自然语言实现以下操作链——观察每一步 Claude Code 都调用了哪些底层工具：

# 第 1 步：搜索所有使用了 fetch 的文件
在整个项目中搜索直接调用 fetch 的地方（不要用 axios 或别的库包装的）
​
# 第 2 步：创建封装文件
基于搜索结果，在 src/utils/ 下创建一个 apiClient.ts，封装一个统一的请求函数
​
# 第 3 步：查看修改统计
告诉我这次会话一共修改了哪些文件

在第 3 步之后，使用 /cost 查看本次会话的数据——你会看到 Read、Write、Grep、Glob 等工具各自被调用了多少次。

步骤 4：IDE 集成验证（选做）

在 VS Code 中：

1. 打开一个项目

2. 在终端面板中输入 claude

3. 验证 Claude Code 能正确读取你的项目文件

4. 尝试在编辑器中选中一段代码，思考如何用 Claude Code 分析它（提示：你可以复制到终端或使用管道）

---

避坑指南

坑 1：在单次模式中执行需要多轮对话的任务

# 错误：单次模式不应该用于复杂任务
claude -p "重构整个项目的错误处理机制"
# AI 只会给一个大致的建议，因为它无法在单次模式中读取所有文件并逐步推进

正确做法：单次模式只做"查询、审查、生成一个短回答"类的任务。任何需要多步文件操作的任务，都应该在交互模式中进行。

坑 2：滥用 --max-turns 导致任务中断

设置 --max-turns 5 但你的任务需要 8 轮才能完成——结果第 5 轮后被强行退出，前面的工作白费了。

正确做法：如果不确定需要多少轮，不要设置 --max-turns。只在自动化脚本中使用这个参数（你确定任务只需要 N 轮）。

坑 3：在 --bare 模式下期望项目规则生效

--bare 模式跳过了 CLAUDE.md 的加载。如果你在 --bare 模式下让 Clode Code 修改代码，它不会遵守你在 CLAUDE.md 中定义的任何规范。

正确做法：--bare 只用于快速的非代码修改类问题（如"解释一下这个命令"、"这段代码是什么意思"）。任何涉及代码修改的任务都不要用 --bare。

坑 4：管道模式中发送过长的内容

# 这个操作可能因为输入 token 超限而失败
find . -name "*.ts" -exec cat {} \; | claude -p "全面审查所有代码"

把整个项目的代码全部塞进管道，输入 token 可能直接超过限制。

正确做法：精确限制管道的输入量。只发送需要分析的文件，或者分批处理。

---

课后作业

1. 参数手册：为每个 CLI 参数写一句"什么时候应该用它"的场景描述，建立你自己的使用决策表。

2. 管道挑战：用管道模式完成三个不同的任务——日志分析、代码审查、数据提取。记录每个任务的命令和结果。

3. 模式对比：用同一个任务（如"审查 src/ 下所有文件的代码质量"）分别在交互模式和单次模式中执行。对比两种模式下的输出质量和实用性的差异。

4. 调试日志：在 --debug 模式下执行一个简单的文件修改任务。阅读调试日志，理解 Claude Code 在后台做了什么。

---

总结

Claude Code 的命令体系分为三层：

第一层：启动参数（--model、--debug、--bare、--max-turns 等）——决定"以什么方式启动" 第二层：运行模式（交互 / 单次 / 管道）——决定"怎么和 AI 交互" 第三层：会话内操作（斜杠命令、文件操作、权限控制）——决定"在会话中做什么"

三个层次的组合给了你极大的灵活性：

• CI/CD 流水线中用单次模式 + 管道做代码审查

• 日常开发中用交互模式做多轮迭代

• 快速查询时用 -p 做单次问答

• 团队协作时用 --worktree 做分支隔离

记住：Claude Code 的设计哲学是"做一件事并做好"——它是一个终端工具，不是一个平台。它的所有能力都围绕一个核心：让你在终端中用自然语言完成编程任务，同时保持完全的可见性和控制权。