Claude Code CLI 完整参数&命令详解

这是 Anthropic Claude Code（终端版 claude 命令行工具），运行在本地终端，可以调用 Claude 模型、操作文件、执行 shell、编辑代码、对接 MCP、后台智能代理、IDE 联动。

核心区分： 不带 -p/--print：交互式会话（持续对话，进入终端聊天界面） 带 -p/--print：一次性非交互式，输出结果直接退出，适合脚本、管道调用

一、顶层 Options（启动参数）

基础运行模式

参数	作用
-p, --print	一次性执行prompt，输出结果后退出；用于shell脚本、管道。 ⚠️ 非交互模式跳过工作区信任弹窗，只在可信目录使用
-c, --continue	继续当前目录最近一次对话会话
-r, --resume [value]	通过session-id恢复会话；不传值会弹出交互式选择器；支持搜索会话
--fork-session	恢复会话时复制会话，不修改原始对话（搭配 --resume / --continue）
--session-id <uuid>	手动指定会话UUID，用于固定会话上下文
-n, --name <name>	设置会话显示名称，出现在会话列表、终端标题
--no-session-persistence	关闭会话持久化，对话不会保存磁盘（仅 --print 生效）

模型、提示词配置

参数	作用
--model <model>	指定模型：别名 sonnet/opus/fable 或完整名称 claude-fable-5
--effort <level>	思考强度：low/medium/high/xhigh/max，控制模型深度思考
--system-prompt <prompt>	自定义本次会话系统提示词，覆盖默认
--append-system-prompt <prompt>	在默认系统提示词尾部追加自定义内容（不覆盖原有）
--exclude-dynamic-system-prompt-sections	将cwd、git状态、环境变量等动态信息移出系统提示词，放入首条用户消息，提升缓存复用
--betas <betas...>	开启API Beta特性（仅API Key方式有效）
--fallback-model <model>	主模型繁忙时自动降级备选模型，逗号分隔多个；仅 --print 模式可用

工具权限、沙箱控制（重点）

参数	作用
--tools <tools...>	全局启用内置工具集：default全部、""禁用所有、Bash,Read,Edit 指定工具
--allowed-tools	白名单允许的工具，支持过滤 Bash(git *) 限制bash只能执行git命令
--disallowed-tools	工具黑名单，禁止指定工具
--permission-mode <mode>	权限策略：auto/dontAsk/manual/acceptEdits/bypassPermissions/plan
--dangerously-skip-permissions	完全绕过所有权限确认弹窗，高危！仅隔离沙箱使用
--allow-dangerously-skip-permissions	开启后才允许动态选择绕过权限，默认不开放该选项
--add-dir <dirs...>	额外授权目录，允许工具访问该路径文件

MCP / 插件扩展

参数	作用
--mcp-config <configs>	加载MCP服务配置（文件路径或JSON字符串）
--strict-mcp-config	只使用 --mcp-config 指定的MCP，忽略项目/全局其他MCP配置
--plugin-dir <path>	临时加载本地插件目录/zip（单次会话生效）
--plugin-url <url>	远程下载zip插件，单次会话生效

运行环境极简/安全模式

参数	作用
--bare	极简裸模式：关闭LSP、钩子、缓存、自动读取CLAUDE.md、keychain；只显式传入的上下文生效；认证仅读取ANTHROPIC_API_KEY
--safe-mode	安全排障模式：禁用 CLAUDE.md、插件、钩子、MCP、自定义指令；仅基础鉴权、模型、内置工具可用，排查配置异常

后台智能代理 Agent

参数	作用
--bg, --background	启动后台常驻Agent，命令立刻返回，用 claude agents 管理
--agent <agent>	指定会话使用自定义Agent（覆盖配置文件）
--agents <json>	临时定义多个Agent JSON配置
--brief	开启SendUserMessage，允许Agent主动向用户发消息交互
--remote-control [name]	开启远程控制交互式会话

输入输出格式（自动化脚本核心）

参数	作用
--input-format [text/stream-json]	输入格式（仅--print），stream-json支持流式持续输入消息
--output-format [text/json/stream-json]	输出格式：普通文本 / 完整json / 实时流式json
--include-partial-messages	流式输出实时推送增量片段（stream-json）
--forward-subagent-text	把子代理思考内容透传到输出流
--include-hook-events	输出流携带钩子生命周期事件
--replay-user-messages	stdin收到的用户消息原样回显stdout
--ax-screen-reader	无障碍模式：移除边框、动画，纯扁平文本输出

调试、日志、限制

参数	作用
-d, --debug [filter]	开启调试日志；过滤语法 api,hooks / !file 排除文件日志
--debug-file <path>	将调试日志写入文件，自动开启debug
--max-budget-usd <amount>	设置本次会话最大API费用上限，到达自动停止（仅--print）
--json-schema <schema>	强制模型输出符合指定JSON Schema结构化数据

集成功能

参数	作用
--chrome / --no-chrome	开启/关闭和Chrome浏览器联动
--ide	自动连接本地IDE（VSCode Claude Code插件）
-w, --worktree [name]	创建git worktree绑定当前会话
--tmux	搭配worktree自动拉起tmux分窗
--from-pr [value]	关联PR启动会话，读取PR代码上下文

杂项

--settings <file/json>：加载外部配置文件 / 行内JSON配置 --setting-sources：限定读取配置范围 user/project/local --disable-slash-commands：禁用所有内置技能斜杠命令 /xxx--file：启动时预加载远端文件资源 -v --version、-h --help 版本、帮助

---

二、内置子 Commands（claude xxx）

1. claude agents

管理后台启动的代理（--background）：查看列表、暂停、终止后台运行的智能任务。

2. claude auth

认证管理：登录、退出、查看当前Anthropic账号登录状态，OAuth会话管理。

3. claude setup-token

配置长期Token（Claude订阅用户），用于无交互服务器环境鉴权。

4. claude doctor

环境诊断工具：检查安装完整性、权限、配置文件、MCP连通性、API网络；

完整修复诊断建议在交互会话内执行 /doctor。

5. claude mcp

MCP服务管理：新增、删除、启停、查看MCP服务配置（Model Context Protocol，本地工具扩展标准）。

6. claude plugin / plugins

插件管理：安装、卸载、列出本地/远程Claude Code插件。

7. claude project

管理项目持久化状态：清除项目缓存、重置项目本地配置。

8. claude install [target]

安装/重装Claude Code本地客户端；target可选 stable/latest/指定版本号。

9. claude update / upgrade

在线检测新版本并自动升级客户端二进制。

10. claude ultrareview [target]

云端多智能体代码评审：对当前git分支/指定PR做深度代码审查，直接输出评审报告。

11. claude auto-mode

查看/重置自动模式分类器（区分普通问答、代码执行任务）。

12. claude gateway

企业版专用：启动企业鉴权、遥测网关，内部集群部署场景使用。

---

三、高频实用示例（快速上手）

# 1. 一次性调用，脚本使用（非交互）
claude -p --model claude-3-5-sonnet "解释这段代码"

# 2. 启动交互式会话，禁止bash高危工具
claude --disallowed-tools Bash

# 3. 恢复上次对话
claude -c

# 4. 流式JSON输出，用于程序对接
claude -p --output-format stream-json "写一个go接口"

# 5. 自定义系统提示词 + 限制访问目录
claude --system-prompt "你是后端架构师" --add-dir ./src

# 6. 后台启动长期运行代理
claude --bg --name "日志巡检代理"
# 查看后台代理
claude agents