Claude Code 命令行参数实践指南

前言很多人第一次打开 Claude Code只会输入claude然后开始聊天。这当然可以但就像开车只会踩油门一样——你根本没用上方向盘和变速箱。命令行参数CLI Flags就是那些被忽视的方向盘。掌握它们你才算真正开始用 Claude Code。文章结构1. 启动模式 — 如何打开 Claude Code 2. 核心参数 — 每天都会用的旗标 3. 提示词控制 — 定制 Claude 的行为 4. 自动化参数 — 脚本和 CI/CD 场景 5. 实战练习 — 5 个可以马上动手的例子快速参考卡# 启动 claude# 交互模式claude问题# 单次问答claude-p任务# 非交互模式claude-c# 继续最近会话claude-rid# 继续指定会话# 模型 claude--modelclaude-opus-4-5# 最强claude--modelclaude-sonnet-4-6# 默认均衡claude--modelclaude-haiku-4-5-20251001# 最快最省# 提示词 claude --append-system-prompt规则# 追加推荐claude --append-system-prompt-file 文件# 从文件追加推荐claude --system-prompt规则# 替换慎用claude --system-prompt-file 文件# 从文件替换慎用# 输出 claude-p任务--output-format json# JSON 输出claude-p任务--output-format text# 纯文本默认claude--verbose# 显示详细日志# 自动化 claude --dangerously-skip-permissions# 跳过确认仅 CI 用claude --add-dir /path# 添加工作目录第一节启动模式Claude Code 有三种主要的启动方式命令作用场景claude启动交互模式日常开发对话claude 你的问题单次问答后退出快速查询claude -p 任务非交互 print 模式脚本/自动化继续上次会话# 继续最近的会话当前目录claude-cclaude--continue# 继续指定 ID 的会话claude-rsession-idclaude--resumesession-id第二节核心参数模型选择# 使用 Opus最强最贵claude--modelopus# 使用 Sonnet默认均衡claude--modelsonnet# 使用 Haiku最快最便宜claude--modelhaiku什么时候用哪个模型模型适合场景Opus复杂架构设计、深度推理、困难 Bug 排查Sonnet日常编码、代码审查、一般问题Haiku快速查询、简单格式化、探索性子任务注意同一个任务Opus 的费用是 Haiku 的 数倍。合理选择模型能大幅节约成本。添加工作目录# 添加额外的工作目录monorepo 场景非常有用claude --add-dir /path/to/another/project claude --add-dir../shared-lib当你的项目跨多个仓库时这个参数可以让 Claude 同时看到多个目录。输出格式# JSON 格式输出适合脚本解析claude-p列出所有函数名--output-format json# 流式 JSON 输出claude-p解释这段代码--output-format stream-json# 纯文本输出默认claude-p写一个 hello world--output-format text第三节提示词控制Claude Code 提供四个控制系统提示词System Prompt的参数参数总览参数作用推荐程度--append-system-prompt追加到默认提示词后首选--append-system-prompt-file从文件追加首选--system-prompt替换整个默认提示词慎用--system-prompt-file从文件替换慎用核心原则优先使用append追加而非替换。追加保留了 Claude Code 的内置能力替换会把它们全清空。使用示例# 追加要求回答必须用中文claude --append-system-prompt请始终用中文回答所有问题。# 追加要求遵循特定编码规范claude --append-system-prompt所有 Python 代码必须通过 black 格式化使用类型注解。# 从文件追加适合长规则claude --append-system-prompt-file ./team-coding-standards.md# 替换完全控制场景如 CI 自动化claude --system-prompt你是一个代码审查机器人只输出 JSON 格式的审查结果不做任何解释。第四节自动化参数Print 模式非交互# -p / --print 进入非交互模式完成任务后退出claude-p检查 src/ 目录下的所有 TODO 注释# 组合使用JSON 输出 非交互claude-p找出所有未使用的变量--output-format json跳过权限确认# 危险跳过所有权限提示仅用于受信任的 CI 环境claude --dangerously-skip-permissions-p运行测试并修复失败的用例警告--dangerously-skip-permissions会允许 Claude 在不询问你的情况下执行任何操作包括删除文件、运行任意命令。只在完全受控的 CI/CD 环境中使用。冗长日志# 显示详细的工具调用日志调试时很有用claude--verbose-p分析项目结构第五节实战练习以下 5 个练习可以马上在你的终端动手练习 1用 Haiku 快速查询# 场景快速查一个 Python 语法不需要 Sonnet 的算力claude--modelhaiku-pPython 的 operator : 怎么用给我一个例子预期效果几秒内得到答案消耗极少 token。练习 2强制中文回答# 场景你的团队用中文但 Claude 默认用英文claude --append-system-prompt所有回答必须使用简体中文。# 然后在交互模式中问任何问题预期效果即使你用英文提问Claude 也会用中文回答。练习 3JSON 输出 脚本处理# 场景把 Claude 的输出传给 jq 解析claude-p列出 src/ 目录下所有 .py 文件的文件名用 JSON 数组格式\--output-format json|jq.result预期效果得到一个可以被脚本处理的结构化输出。练习 4继续上次未完成的任务# 第一次开始一个任务claude帮我重构 utils.py我们先分析一下结构# 关闭终端第二天继续# 第二次恢复会话不需要重新解释claude-c# Claude 会记住上次的对话继续工作预期效果跨会话保持上下文节省大量重新解释的时间。练习 5加载团队编码规范# 第一步创建规范文件cat./team-coding-rules.mdEOF ## 编码规范 1. 所有函数必须有类型注解 2. 注释语言中文 3. 每个函数不超过 50 行 4. 优先使用 pathlib 而不是 os.path EOF# 第二步启动时加载规范claude --append-system-prompt-file ./team-coding-rules.md# 之后写的所有代码都会遵循这些规范预期效果Claude 的所有代码输出都会遵循你定义的团队规范。下一篇预告#02 — Claude Code 的 Slash 命令与交互技巧在交互模式里有一套强大的/命令系统——/compact压缩上下文、/init自动生成 CLAUDE.md、/plan进入规划模式……下一篇我们深入这个世界。参考文档Claude Code 官方文档