Claude Code、Codex 常用命令和命令速查

常用命令

1. Claude Code

• 安装 ：npm install -g @anthropic-ai/claude-code

• 更新 ：claude update （或 claude upgrade）

• 启动并跳过所有确认（危险） ：

  claude --dangerously-skip-permissions
  # 或等效命令：claude --permission-mode bypassPermissions

• 启动并使用自动放行模式（推荐） ：

  claude --permission-mode auto

2. Codex

• 安装 ：npm install -g @openai/codex （或 brew install codex）

• 更新 ：npm update -g @openai/codex （或 brew upgrade codex）

• 启动并彻底绕过审批与沙盒（危险）：

  codex --dangerously-bypass-approvals-and-sandbox

• 启动全自动沙盒模式（推荐）：

  codex --full-auto

• 启动并从不询问审批（非交互环境）：

  codex -a never [你的提示词]

详细命令

Claude Code 详细使用指南

默认用法：claude[options] [command] [prompt]（不加参数默认启动交互式会话）。

一、 子命令大全 (Commands)

除了直接对话，claude 提供了以下子命令用于特定管理：

• 基础与更新
  • claude install [target]：安装或修复原生构建版本（可指定 stable, latest）。
  • claude update / claude upgrade：检查并安装可用更新。
  • claude doctor：自动更新器健康检查（自动跳过信任检查并在信任目录执行）。
• 身份认证
  • claude auth：管理身份验证。
  • claude setup-token：设置长期的身份验证令牌（需要 Claude 订阅）。
• 环境与扩展
  • claude mcp：配置和管理 MCP（Model Context Protocol）服务器。
  • claude plugin / plugins：管理 Claude Code 插件。
  • claude agents：列出已配置的代理（Agents）。
  • claude auto-mode：检查自动模式分类器的配置。

二、 核心交互与会话控制 (Options)

• 输出与运行模式
  • -p, --print：非交互模式，打印结果后退出（常用于管道）。注意：此模式会跳过工作区信任对话，请仅在信任目录使用。
  • --bare：极简模式，跳过所有钩子、LSP、插件、自动内存等功能，仅依赖显式配置。
• 恢复与继续会话
  • -c, --continue：在当前目录继续最近的一次对话。
  • -r, --resume [value]：通过会话 ID 恢复对话，或打开带有搜索功能的交互式选择器。
  • --from-pr [value]：从 PR（请求编号/URL）恢复关联会话。
  • --fork-session：在使用 resume/continue 时，创建新会话 ID 而不是覆盖原会话。
  • --session-id <uuid>：直接指定会话的 UUID。
  • -n, --name <name>：为会话设置显示名称。
  • --no-session-persistence：禁用持久化，对话不存盘且不可恢复。

三、 权限与安全选项 (Permissions)

• --permission-mode <mode>：指定权限模式，可选值：acceptEdits, auto, bypassPermissions, default, dontAsk, plan。
• --dangerously-skip-permissions：直接绕过所有权限检查（强烈建议仅在断网沙盒中使用）。
• --allow-dangerously-skip-permissions：仅开启允许绕过权限的选项，但不默认激活。

四、 模型、提示词与工具配置 (Model & Tools)

• --model <model>：指定使用的模型（如 sonnet, opus, claude-sonnet-4-6）。
• --fallback-model <model>：设置备用模型（仅在 --print 模式下默认模型过载时生效）。
• --system-prompt <prompt>：设置当前会话的系统提示词。
• --append-system-prompt <prompt>：在默认系统提示词后追加内容。
• --tools <tools...>：指定可用工具（如 "" 禁用所有, "default" 启用全部, 或 "Bash,Edit,Read"）。
• --allowed-tools / --disallowed-tools：允许或拒绝特定的工具名称（支持通配符，如 Bash(git:*)）。
• --disable-slash-commands：禁用所有 / 斜杠指令（Skills）。
• --agent <agent> / --agents <json>：指定当前使用的 agent，或通过 JSON 定义自定义 agents。
• --effort <level>：设置工作努力级别（low, medium, high, max）。

五、 工作区、文件与系统集成

• -w, --worktree [name]：为当前会话创建一个新的 git 工作树（可指定名称）。
• --add-dir <directories...>：允许工具访问的额外目录。
• --file <specs...>：启动时下载并加载资源。格式为 file_id:relative_path。
• --ide：如果有且仅有一个 IDE 可用，启动时自动连接。
• --tmux：为工作树创建 tmux 会话（配合 -w 使用，支持 --tmux=classic）。
• --chrome / --no-chrome：启用/禁用 Chrome 浏览器集成。
• --mcp-config / --strict-mcp-config：从文件或字符串加载 MCP 服务器（strict 表示仅使用指定的，忽略其他）。

六、 高级格式控制与调试

• --input-format / --output-format：指定输入输出格式（支持 text, json, stream-json）。
• --json-schema <schema>：配置 JSON Schema 强制结构化输出校验。
• --max-budget-usd <amount>：设置 API 最大消费金额上限（仅 --print 下有效）。
• --settings / --setting-sources：从文件或 JSON 字符串加载设置；指定设置加载源（user, project, local）。
• -d, --debug [filter]：开启调试模式，支持过滤（如 api,hooks）。
• --debug-file <path>：输出调试日志到特定文件。
• --verbose：强制开启详细输出覆盖默认配置。

---

Codex 详细使用指南

默认用法：codex [OPTIONS] [PROMPT] 或 codex [OPTIONS] <COMMAND> [ARGS]

一、 子命令大全 (Commands)

• 基础交互与执行
  • exec (e)：非交互式执行 Codex（执行完毕退出）。
  • apply (a)：将 Codex agent 产生的最新代码差异以 git apply 方式应用到本地工作树。
  • review：非交互式执行代码审查。
• 会话管理
  • resume：恢复之前的交互式会话（默认打开选择器，配合 --last 恢复最近一次）。
  • fork：分叉之前的交互式会话（配合 --last 分叉最近一次）。
• 环境与服务器集成
  • sandbox：在 Codex 提供的沙盒环境中运行命令。
  • mcp：管理 Codex 的外部 MCP 服务器。
  • mcp-server：将 Codex 作为一个 MCP 服务器通过 stdio 启动。
  • app-server：[实验性] 运行应用服务器或相关工具。
  • app：启动 Codex 桌面客户端（macOS 缺失时会自动下载）。
• 账户与云端
  • login / logout：管理登录认证凭据。
  • cloud：[实验性] 浏览 Codex Cloud 上的任务并应用到本地。
• 实用工具
  • completion：生成 Shell 的自动补全脚本。
  • debug：调试工具集。
  • features：检查特性开关 (Feature flags) 状态。

二、 核心沙盒与审批选项 (Sandbox & Approvals)

• -s, --sandbox <SANDBOX_MODE>：选择执行模型生成命令的沙盒策略：
  • read-only：只读模式。
  • workspace-write：允许修改工作区。
  • danger-full-access：完全访问权限。
• -a, --ask-for-approval <APPROVAL_POLICY>：模型执行命令时的审批策略：
  • untrusted：只允许受信任指令（如 ls, cat, sed）静默执行，其他指令必须询问用户。
  • on-request：由 AI 模型自行决定何时向人类请求审批（交互式运行推荐）。
  • never：永远不询问用户。执行错误会直接反馈给模型（非交互式运行推荐）。
  • on-failure：(已废弃) 默认不询问，只有命令执行失败并需要更高沙盒权限时才询问。
• --full-auto：快捷开启低摩擦全自动执行（等同于 -a on-request --sandbox workspace-write）。
• --dangerously-bypass-approvals-and-sandbox：极度危险！跳过所有确认提示并且无沙盒执行。仅限已被外部物理/容器隔离的环境使用。

三、 模型与本地 OSS 选项 (Model & Providers)

• -m, --model <MODEL>：指定代理使用的模型。
• --oss：快捷标志。选择本地开源模型提供商（等同于使用本地的 LM Studio 或 Ollama 服务）。
• --local-provider <OSS_PROVIDER>：明确指定本地提供商（lmstudio 或 ollama）。

四、 工作区、搜索与环境选项 (Workspace & Context)

• -i, --image <FILE>...：将会话初始化时附带指定的图片。
• -C, --cd <DIR>：告诉 Agent 使用该目录作为其工作根目录。
• --add-dir <DIR>：指定需要额外开启写权限的外部目录（主工作区之外）。
• --search：开启实时联网搜索能力（启用响应中的 web_search 工具，该工具无需逐次审批）。
• --no-alt-screen：禁用备用屏幕缓冲。使 TUI 内联显示，以便在如 Zellij 等严格遵循 xterm 规范的终端复用器中保留历史滚动日志。

五、 高级配置与远程连接 (Config & Remote)

• -c, --config <key=value>：覆盖 ~/.codex/config.toml 中的设置（支持点语法覆盖嵌套配置，如 -c 'sandbox_permissions=["disk-full-read-access"]'）。
• -p, --profile <CONFIG_PROFILE>：指定 config.toml 中的具体配置文件名。
• --enable <FEATURE> / --disable <FEATURE>：快捷开启/关闭某个特性。
• --remote <ADDR>：连接 TUI 到远程应用服务器的 WebSocket 端点（ws:// 或 wss://）。
• --remote-auth-token-env <ENV_VAR>：指定包含发送给远程 websocket Bearer token 的环境变量名称。