全局选项

会话建立时就固定的全局选项:工作目录、模型、权限模式、接回与派生会话、--json 与 --remote。

这些选项在会话建立时固定,所以放在子命令之前,之后无法中途更改:

  • -C, --cd <目录>:会话的工作目录,默认当前目录。
  • -m, --model <id>:本次会话用哪个模型。
  • -p, --permission-mode <模式>:会话启动时的权限模式。
  • --json:输出引擎的原始协议 JSON,一行一个值。这是给程序读的形态——读到的就是引擎说的原话,不是命令行自己包装的一层。诊断信息一律走 stderr,所以 stdout 可以当纯数据管。
  • --remote ws://主机:端口:驱动一个已经在跑的引擎,而不是在本进程里起一个。配合 klaus serve 用。
  • --config-json <JSON>:直接给一段引擎配置,优先级低于上面这些具名选项。
  • --resume <会话 id>:接回一条已经存下来的会话,而不是新开一条。--fork <会话 id> 是另一回事:拿那条会话的历史做种子、另起一条新的,原来那条不动(两者不能同时给)。
  • --provider <名字>:模型后端(anthropic 默认、openai、gemini)。选后端是引擎端点自己的事,所以用 --remote 驱动别人的引擎时这个选项不能用。
  • --goal-mode:开目标模式——目标工具,加上每轮结束后自动接着跑。引擎里默认关着,因为自动续跑会在你没再开口的时候就花 token,所以要逐会话显式要。
  • --token <TOKEN>:--remote 的 bearer token,只能配 --remote 用。
  • --session-dir <目录>:会话记录写到哪。不指定就是 ~/.klaus/sessions,所以 CLI 里开的会话在桌面端也能看到。
  • --no-discovery:这一跑不从磁盘读技能、子代理、钩子和 MCP 服务器。--no-plugins 只跳已安装插件的加载,其他三类照读。
  • --skills-dir <目录> / --agents-dir <目录>:额外加一个技能或子代理目录,可重复给,排在标准根之后搜。
  • --plugin-home <目录>:引擎读插件账本的目录。