Deep Agents Code（dcode）命令行参考总结

Deep Agents Codedcode命令行参考总结这是dcode的完整命令行标志与管理子命令参考用于在启动时覆盖默认配置、脚本化非交互任务或无需打开会话即可管理工具、代理、会话、技能、凭证和配置。一、启动与模型选择核心-a/--agent NAME使用指定命名代理有独立记忆、技能、AGENTS.md覆盖配置中的默认/最近代理。-M/--model MODEL指定模型provider:model格式如anthropic:claude-opus-4-8或openai:gpt-5.5。模型解析优先级无--model时--model标志config.toml中的[models].default[models].recent环境自动检测OPENAI_API_KEY→ANTHROPIC_API_KEY→GOOGLE_API_KEY等--default-model [MODEL]/--clear-default-model设置或清除全局默认模型。--model-params JSON传入模型额外构造参数仅当前会话。--profile-override JSON覆盖模型 profile如max_input_tokens会持久影响会话内切换。--install NAME安装可选 provider/sandbox 扩展如groq、fireworks、daytona。二、会话与代理管理-r/--resume [ID]恢复最近或指定线程会话会忽略 agent 选择恢复原代理。管理命令dcode threads list [--agent] [--limit] [--sort] [--branch] [--cwd] [-v] [-r]dcode threads delete ID支持--dry-rundcode agents list/dcode agents reset --agent NAME可复制其他代理记忆三、非交互模式与管道脚本化重点-n/--non-interactive TEXT单次任务后退出每次都是新线程文件状态会持久。stdin 管道自动进入非交互模式。-q/--quiet只输出最终回复到 stdout方便管道。--no-stream缓冲完整回复再输出。--max-turns N/--timeout SECONDS限制轮次或时间超时退出码 124必须配合-n。Shell 默认在非交互模式下禁用需用-S/--shell-allow-list开启逗号分隔命令名recommended安全只读默认all允许任意命令危险--allow-fs-tools LIST限制文件系统工具必须包含read_file有效值ls,read_file,write_file,edit_file,delete,glob,grep,execute。注意--allow-fs-tools控制工具是否存在-S控制execute允许哪些命令。非交互要跑命令必须两者都设。四、启动时技能、目标与初始提示--skill NAME启动时立即调用技能可配合-n/-q。--rubric TEXT|PATH--rubric-model--rubric-max-iterations非交互模式下传入验收标准rubric 评分。-m/--message TEXT交互模式启动后自动提交初始提示。--startup-cmd CMD启动前先跑 shell 命令输出只显示在 transcript不会进入 agent 消息历史。要把输出给 agent请用管道。五、审批与安全模式默认需要人工确认危险操作。-y/--auto-approveAuto 模式LLM 分类器自动审批。--yolo跳过审查直接执行交互模式有风险确认。交互中可用ShiftTab切换 Manual/Auto。六、远程沙箱--sandbox TYPElangsmith、agentcore、daytona、modal、runloop、vercel等。配合--sandbox-id、--sandbox-snapshot-name、--sandbox-setup。无值时使用config.toml中的默认。七、MCP 控制--mcp-config PATH最高优先级添加 MCP 配置。--no-mcp完全禁用。--trust-project-mcp信任项目级 MCP非交互时不提示。dcode mcp login NAMEOAuth 登录。八、其他重要标志--recursion-limit N默认 2000范围 25–100000--interpreter/--interpreter-tools控制 JS 解释器。--acp以 ACP 服务器模式运行stdio。--update/--auto-update/-v/-h九、管理子命令速查命令组主要用途dcode auth管理 API 密钥set/list/status/remove/path推荐管道或--from-envdcode config查看有效配置show/get/list/pathdcode doctor诊断安装、依赖、追踪、数据目录问题dcode tools list列出当前可用工具可先加--allow-fs-tools等dcode skillslist/create/info/delete技能dcode threads列出会话 / 删除会话dcode agents列出 / 重置代理记忆所有管理子命令支持--json输出机器可读格式。破坏性操作支持--dry-run。十、学习重点标粗推荐优先掌握模型选择与默认设置--model、--default-model、解析优先级非交互模式完整工作流-n、管道、-q、--max-turns/--timeoutShell 与文件系统权限控制-S与--allow-fs-tools的区别与组合审批模式Manual / Auto-y/ YOLO--startup-cmd与管道的区别输出是否进入 agent 上下文会话恢复-r与代理隔离-a技能与 Rubric非交互自动化验收dcode auth/dcode config/dcode doctor日常运维命令这些是日常使用和脚本化时最核心的内容。建议先掌握模型指定、非交互运行 权限控制、以及会话/代理管理这三块。