Claude Code 启动参数与环境变量

Claude Code 整理自 @bcherny(Claude Code 创始人,Anthropic)2025–2026 年在 X 上发布的帖子,以及官方文档。

主要来源:
– Jan 2, 2026 X 帖子(13 条使用技巧)
– Jan 31, 2026 X 帖子(10 条团队内部技巧,8.5M 浏览)
– Feb 11, 2026 X 帖子(12 条配置技巧,含 “37 settings, 84 env vars” 原话)
– 官方文档 code.claude.com/docs/en/cli-reference – 官方文档 code.claude.com/docs/en/env-vars


一、CLI 启动标志(Flags)

bcherny 亲自提到的标志

标志 用途 出处
–permission-mode plan 以 Plan 模式启动(只读探索,不写代码) Feb 11 帖子
–permission-mode dontAsk 无需审批权限提示运行 Jan 2 帖子 tip 12
–permission-mode bypassPermissions 等同于 –dangerously-skip-permissions 官方文档
–dangerously-skip-permissions 跳过所有权限提示(在沙箱中使用) Jan 2 帖子 tip 12
–allow-dangerously-skip-permissions 把 bypassPermissions 加入 Shift+Tab 循环,不立即进入该模式 官方文档
–worktree / -w 在独立 git worktree 中启动(如 claude -w feature-auth Jan 31 帖子 tip 1
–worktree –tmux worktree + 自动创建 tmux 会话 官方文档
–teleport 把本地会话切换到 web(claude.ai/code),或把 web 会话恢复到本地 Jan 2 帖子 tip 2
–remote “task” 在 claude.ai 创建新 web 会话 官方文档
–remote-control / –rc 启动支持 Remote Control 的交互会话(可从 claude.ai 或 Claude App 控制) 官方文档
–agent 为当前会话指定 agent(覆盖 agent 设置项) Feb 11 帖子 tip 4
–agents ‘ 用 JSON 动态定义 subagent 官方文档
–name / -n 为会话设置展示名称(可用 claude -r 恢复) 后续线程
–bare 极简模式:跳过 hooks/skills/plugins/MCP/auto-memory/CLAUDE.md 自动发现,只保留 Bash、文件读写工具 后续线程
–add-dir 添加额外工作目录(Claude 可读写该目录文件) 后续线程
–effort 设置当前会话的 effort 等级(low / medium / high / max Feb 11 帖子 tip 2
–model 指定模型(如 claude-opus–4–6,或别名 opus / sonnet Jan 2 帖子 tip 3
-p “query” 非交互(SDK)模式,执行后退出;用于 CI 或脚本 Jan 31 帖子 bonus
–continue / -c 加载当前目录最近的会话 官方文档
–resume / -r 按 ID 或名称恢复会话 官方文档
–fork-session 恢复时创建新会话 ID 而非复用原会话(与 –resume 配合) 官方文档
–chrome 启用 Chrome 浏览器集成(UI 验证、自动化测试) Jan 2 帖子 tip 13
–mcp-config 从 JSON 文件加载 MCP 服务器配置 官方文档
–strict-mcp-config 只使用 –mcp-config 指定的 MCP 服务器,忽略其他 MCP 配置 官方文档
–system-prompt 替换整个系统提示词 官方文档
–append-system-prompt 在默认系统提示词末尾追加内容 官方文档
–append-system-prompt-file 从文件追加系统提示词 官方文档
–tools “Bash,Edit,Read” 限制 Claude 可用的工具集 官方文档
–allowedTools 无需审批直接执行的工具列表(权限白名单) Jan 2 帖子 tip 10
–disallowedTools 从模型上下文中移除的工具(彻底禁用) 官方文档
–max-turns 限制 agentic 轮数(仅 print 模式) 官方文档
–max-budget-usd 限制 API 花费上限(仅 print 模式) 官方文档
–output-format 输出格式:text / json / stream-json(仅 print 模式) 官方文档
–json-schema ‘ 要求输出符合 JSON Schema(仅 print 模式) 官方文档
–fallback-model 主模型过载时自动 fallback 到该模型(仅 print 模式) 官方文档
–debug 启用调试模式,可指定过滤类别(如 “api,mcp” 官方文档
–debug-file 调试日志写入指定文件路径(隐式启用 debug 模式) 官方文档
–enable-auto-mode 解锁 auto 模式加入 Shift+Tab 循环(需 Team/Enterprise 计划) 官方文档
–verbose 详细日志,显示完整逐轮输出 官方文档
–init 运行初始化 hooks 并进入交互模式 官方文档
–plugin-dir 仅本次会话从指定目录加载插件 官方文档
–settings 从 JSON 文件或 JSON 字符串加载额外设置 官方文档
–version / -v 输出版本号 官方文档

常用命令(非标志)

claude # 启动交互会话
claude “query” # 带初始 prompt 启动
claude -p “query” # SDK/非交互模式
claude -c # 继续最近的会话
claude -r “session-name” # 恢复指定会话
claude update # 更新到最新版本
claude auth login # 登录账号
claude auth status # 查看认证状态
claude agents # 列出所有已配置 subagents
claude mcp # 配置 MCP 服务器
claude plugin install  # 安装插件
claude remote-control –name “My Project” # 启动 Remote Control 服务器

Continue reading “Claude Code 启动参数与环境变量”