dcode) 在启动时接受命令行标志，并为工具、代理、会话、技能、凭证和配置提供管理子命令。当您需要从 shell 覆盖默认设置、在脚本中运行非交互式任务或在不打开会话的情况下自动化管理时，请将此页面作为参考。有关安装和日常交互使用，请参阅快速入门。有关 CLI 标志如何融入更广泛的配置模型，请参阅配置。
使用示例
选择模型
使用--model (-M) 启动以将模型固定用于单个会话。使用 provider:model 格式（例如，openai:gpt-5.5），或在提供商明确时传递裸模型名称：
--model 的情况下启动时，它会按以下顺序解析模型：
--model标志（如果提供了）。[models].default位于~/.deepagents/config.toml中。[models].recent位于~/.deepagents/config.toml中（当您在会话中切换模型时自动写入）。- 环境自动检测：在
OPENAI_API_KEY、ANTHROPIC_API_KEY、GOOGLE_API_KEY和GOOGLE_CLOUD_PROJECT（Vertex AI）中第一个可用的凭证。
--model 或保存的默认设置使用，即使它们不在启动自动检测列表中。完整的提供商列表和凭证设置请参阅模型提供商。
设置或清除默认模型
为所有未来启动设置一个默认模型：/model 切换器 (Ctrl+S) 固定默认模型，或在 config.toml 中设置 [models].default。请参阅设置默认模型。
模型参数和配置文件覆盖
使用--model-params 作为 JSON 字符串向模型传递额外的构造函数 kwargs。这些仅应用于当前会话，并覆盖 config.toml 提供商参数：
--profile-override 覆盖模型配置文件字段（例如，max_input_tokens）。值会合并到配置文件覆盖之上，并在会话中的 /model 热切换后保持：
--max-retries 或 config.toml 中的 [retries] 部分。请参阅模型参数和配置文件覆盖。
安装提供商扩展
可选的提供商和沙箱包作为扩展提供。无需启动会话即可从 shell 安装：--package 以通过 uv --with 安装任意提供商包（请参阅任意提供商），并使用 --yes 跳过确认提示。要在初始 CLI 安装期间预安装扩展，请设置 DEEPAGENTS_CODE_EXTRAS（例如，DEEPAGENTS_CODE_EXTRAS="groq,fireworks"）。
代理和会话
使用-a/--agent 启动一个命名代理，该代理拥有自己的记忆、技能和位于 ~/.deepagents/<agent_name>/ 下的 AGENTS.md。该标志覆盖 config.toml 中的 [agents].default 和 [agents].recent：
-r/--resume 恢复之前的对话。不传递 ID 可打开最近的线程，或传递线程 ID 以恢复特定会话。恢复会绕过代理选择标志并恢复线程的原始代理：
dcode threads list 和 dcode threads delete 列出和删除会话。有关按代理记忆的工作方式，请参阅记忆和技能。
非交互模式和管道
使用-n/--non-interactive 运行单个任务而不使用交互式界面。每次非交互式运行都会启动一个新线程；基于文件的状态（记忆、技能、配置）会在多次调用之间持久化：
-n 或 -m 结合使用时，管道内容会首先出现，后跟标志文本。最大管道输入大小为 10 MiB。使用 --stdin 显式从 stdin 读取，而不是自动检测。
输出、限制和 Shell 访问
使用-q/--quiet 仅在 stdout 上输出代理的响应（用于管道到其他命令）。添加 --no-stream 以在写入前缓冲完整响应：
--max-turns 或 --timeout 限制代理运行。当超出预算时，两者都会以代码 124 退出。需要 -n 或管道 stdin：
-S/--shell-allow-list 启用：
启动时的技能
--skill 标志在交互或非交互模式下启动时立即调用一个技能：
--skill 与 --quiet 或 --no-stream 结合使用时需要 -n。使用 dcode skills list、create、info 和 delete 管理技能。请参阅记忆和技能。
脚本中的评估标准
非交互式运行无法暂停以进行交互式目标审查。当标准已知时，使用--rubric 传递验收标准：
-n 或管道 stdin。请参阅目标和评估标准。
人在回路和 Shell 访问
默认情况下，潜在破坏性的工具调用需要批准。有三种批准模式可供选择：默认的手动模式在所有检查点都需要确认，自动模式 (-y/--auto-approve) 使用 LLM 分类器，而 YOLO (--yolo) 无需审查即可运行受控操作。在交互式会话期间，使用 Shift+Tab 在手动和自动模式之间切换：
-S/--shell-allow-list 标志适用于交互和非交互模式。传递一个逗号分隔的命令名列表，'recommended' 表示安全的只读默认值，或 'all' 允许任何命令。您也可以在环境中设置 DEEPAGENTS_CODE_SHELL_ALLOW_LIST。
限制文件系统工具
默认情况下，Deep Agents Code 会暴露所有文件系统工具。要仅暴露一个子集，请传递一个逗号分隔的列表：ls、read_file、write_file、edit_file、delete、glob、grep 和 execute。显式列表必须包含 read_file。允许列表适用于每个会话模式中的主代理和同步子代理，但不适用于异步子代理或非文件系统工具。
--allow-fs-tools 和 -S/--shell-allow-list 控制不同的 Shell 访问层：--allow-fs-tools控制哪些文件系统工具可用。Shell 访问需要execute。-S/--shell-allow-list控制哪些 shell 命令被允许通过execute执行。它不影响其他文件系统工具。
在非交互模式下，传递两者以在无人批准的情况下启用命令：
/tools 以检查活动工具集。从 shell 中，将工具调整标志放在子命令之前：
启动命令和初始提示
使用-m/--message 在交互式会话开始时自动提交初始提示。与 --startup-cmd 结合使用以先运行 shell 命令：
--startup-cmd 的输出会在记录中渲染供您参考，但不会添加到代理的消息历史中。要将命令输出传递给代理，请改为通过 stdin 管道传输：
--startup-cmd 的非零退出和超时会发出警告，但不会中止会话。非交互模式对启动命令应用 60 秒超时。
远程沙箱
使用--sandbox 将代码执行路由到远程沙箱。内置提供商包括 langsmith、agentcore、daytona、modal、runloop 和 vercel。也接受第三方和配置声明的提供商。不带值传递 --sandbox 以使用 config.toml 中的 [sandboxes].default：
因为
--sandbox 接受一个可选值，请将裸形式放在命令行的最后。否则，后面的参数（例如 dcode --sandbox agents）将被消耗为该标志的值。dcode --install 安装沙箱扩展（例如 dcode --install daytona 或 dcode --install all-sandboxes）。有关提供商设置、工作目录和第三方提供商，请参阅远程沙箱。
MCP 标志
在启动时控制 MCP 服务器加载：--mcp-config 和 --no-mcp 是互斥的。在非交互模式下，除非传递了 --trust-project-mcp，否则没有匹配的保存或环境批准的项目服务器会被静默跳过：
auth: "oauth" 的 MCP 服务器的 OAuth 登录，请使用 dcode mcp login <server>。请参阅 MCP 工具。
命令行选项
管理凭证 (dcode auth)
dcode auth 命令组是 /auth 凭证管理器的可脚本化等效项。它在不启动 TUI 的情况下读取和写入相同的 auth.json 存储：
set 拒绝在交互式终端中运行，除非您通过 stdin 管道传输密钥或使用 --from-env。dcode auth set 仅管理 API 密钥；openai_codex 提供商改为通过 /auth 使用 ChatGPT 浏览器登录。请参阅提供商凭证。
检查配置 (dcode config)
dcode config 命令组报告有效配置而无需启动会话。使用它来确认环境变量或 config.toml 设置是否被采用，或在错误报告中共享编辑后的快照：
--json。请参阅检查配置。
运行诊断 (dcode doctor)
当 Deep Agents Code 无法正确启动、提供商或 MCP 服务器未连接、追踪配置错误，或安装或更新看起来有问题时，请使用 dcode doctor。它总结了安装方法、依赖版本、更新状态、追踪配置和数据目录健康状况，而无需启动会话。
当您需要高级别的健康检查和特定设置的确切来源时，请将 dcode doctor 与 dcode config show 结合使用。请参阅使用 dcode doctor 运行诊断。
CLI 命令
所有管理子命令都支持
--json 以生成机器可读输出。更多信息请参阅命令行选项。
破坏性命令（agents reset、skills delete、threads delete）支持 --dry-run 以预览将要发生的变化而不进行更改。在 JSON 模式下，--dry-run 返回相同的信封，但包含 dry_run: true 字段。
另请参阅
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.