aude(1)

NAME

aude — 基于 claude 或 codex CLI 的编程智能体

SYNOPSIS

DESCRIPTION

aude 把一个框架（claude 或 codex）作为子进程运行。它会替换该框架的指令。模型只有这些工具：在 claude 上是 Read、Bash 和 Skill，在 codex 上是 exec、apply_patch 和 view_image。参见 CAVEATS。

会话（session）是一次对话，它有一个名称和一个目录。 宿主（host）是运行该会话的 aude 进程。 记录（record）在宿主退出后仍把会话的事实和实录保存在磁盘上。 轮次（turn）是一行输入所对应的工作。 子智能体（subagent）是由 aude start 在它自己的 git 工作树中创建的会话。 目标（target）是范围内的某个会话：它的名称、ID 或 ‘<name>#<tag>’ 形式，或者是其中之一的唯一前缀。 ‘<tag>’ 是 ID 的前 8 个字符。 范围（scope）是当前的 git 仓库，在仓库之外则是当前目录。

INPUT AND OUTPUT

当标准输入和标准输出是终端时， aude 是 aude-terminal(7) 的行编辑器。

没有终端时，标准输入的每一行是一个轮次。 aude 在该轮次完成后发送下一行。 ‘!interrupt’ 这一行会中断正在运行的轮次。标准输出是不带颜色的实录。标准错误接收诊断信息。输入结束后， aude 会把每个轮次运行到结束，然后退出。如果有轮次运行过，标准输出的最后一行是 DIAGNOSTICS 中的恢复行。

每个宿主都会与本机器的监听器建立一条链路。参见 aude-rc(7)。

OPTIONS

--harness name

claude 或 codex。 aude、print 和 start 必须带有此选项。其他命令从记录中读取它。

--model name

框架的一个模型，用名称或标识符指定。一个系列表示该系列最新的模型：在 claude 上是 opus、sonnet、haiku 或 fable，在 codex 上是 sol、astra、luna 或 terra。

--effort level

low、medium、high、xhigh 或 max。

--agent name

项目的一个智能体，或者 default，即 aude 的智能体。参见 FILES。

--resume id

继续具有此 ID 的对话。

--name name

会话的名称。参见 aude-rc(7)。

--budget duration

对于 start 和 send，表示轮次可以运行的最长时间，写成 ‘<n>s’ 或 ‘<n>m’ 或 ‘<n>h’ 的形式。

--limit duration

wait 阻塞的最长时间，形式相同。

--on name ...

此子智能体在其基础上构建的子智能体。参见 start。

-h, --help, --version

打印摘要或版本，然后退出。

COMMANDS

SLASH COMMANDS

aude 只接受这些命令。除了 /login 以及不带名称的 /model 或 /agent 之外，每个命令都在队列中等待它的轮次。

/login

登录。参见 AUTHENTICATION。

/clear

开始新的对话。如果旧对话运行过轮次，打印它的恢复行。

/model [name]

显示模型和各个标识符，或更改模型。

/effort [level]

显示推理强度，或更改它。

/agent [name]

显示智能体和各个名称，或更改智能体。更改会以相同的对话重启框架。

/<skill>

运行项目的一个技能。

命令会以一行作答。在这些行中， ‘<what>’ 是 model、effort 或 agent：

• ‘<what> <value> · available: <values>’
• ‘<what> set to <value>’
• ‘unknown <what> '<value>' — available: <values>’
• ‘model change failed — <detail>’
• ‘effort change failed — no response’
• ‘effort is not supported by <model>’
• ‘clear failed — context is unchanged’
• ‘unknown command /<name> — aude accepts /login /clear /model /effort /agent and /<skill>’

/attach, /switch 和 /detach 是行编辑器的命令。参见 aude-terminal(7)。

AUTHENTICATION

aude 使用框架保存的登录，在 claude 上是对 Claude 的登录，在 codex 上是对 OpenAI 的登录。 aude 从不读取该登录。 aude 拒绝其他提供商。

如果登录不正确， aude 会打印像 ‘not logged in to Claude — type /login’ 这样的一行。有终端时， /login 会运行 ‘claude auth login --claudeai’ 或 ‘codex login’ 命令。

ENVIRONMENT

NO_COLOR

任何值都会去除颜色和文本样式。

PATH

aude 在其中的绝对路径条目里查找框架和隧道。

TERM

空值或 ‘dumb’ 会去除颜色和文本样式，但可达信息除外。

子进程不继承任何以 ANTHROPIC_, CLAUDE_, CCR_, OPENAI_ 或 CODEX_ 开头的名称，也不继承 CLAUDECODE 或 AUDE_DISCLAIMED。 例外是 claude 上的 CLAUDE_CONFIG_DIR 和 CLAUDE_SECURESTORAGE_CONFIG_DIR，codex 上的 CODEX_HOME，以及每个密钥： ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN, AWS_BEARER_TOKEN_BEDROCK, OPENAI_API_KEY, CODEX_API_KEY 和 CODEX_ACCESS_TOKEN。 git 不获得任何密钥，也不获得任何 GIT_ 名称。

FILES

~/.aude/rc/<id>/events.jsonl

记录的每个事实，每行一个。参见 aude-wire(7) ENTRIES。

~/.aude/rc/<id>/host.lock

宿主在运行时持有这个锁。

~/.aude/rc/<id>/checkpoint.json

‘record’ 是事件文件前 ‘length’ 个字节所对应的记录。

~/.aude/run/<id>/prompt.md

子进程的系统提示词，在子进程运行期间存在。

.aude/worktrees/<name>

子智能体的工作树。

.git/info/exclude

start 在 git 不忽略 ‘/.aude/’ 时把它加入此文件。

.claude/settings.json, .claude/settings.local.json, .codex/config.toml

项目设置。 aude 会拒绝其中一些设置。参见 DIAGNOSTICS。

CLAUDE.md, AGENTS.md

框架会读取的项目指令。

.claude/skills, .claude/agents

 

.agents/skills, .codex/skills, .codex/agents

项目的技能和智能体，分别用于 claude 和 codex。 aude 只读取智能体文件 <name>.md 或 <name>.toml 中的名称和指令。这些指令会替换系统提示词中 aude 的角色设定。

wiki/README.md

项目 wiki。参见 aude-wiki(7)。

EXIT STATUS

aude 成功时退出码为 0，出错时退出码大于 0。如果标准输出关闭， aude 以 0 退出。TERM、HUP 或 INT 信号会先停止会话，然后 aude 因该信号结束，shell 显示 143、129 或 130。QUIT 信号会立即结束 aude。列表行的 ‘exit’ 字段使用相同的退出码。

EXAMPLES

打印一个轮次的回答：

DIAGNOSTICS

下面的每一行都是完整的。 EXIT STATUS 给出每一行的退出码：

• ‘no input — one line on standard input is one turn’
• ‘empty turn’
• ‘no session matches '<target>' — try: aude sessions’
• ‘'<target>' matches <n> sessions:’
• ‘'<name>' would be folded to '<folded>' — use that name’
• ‘'<name>' exists — send to it, or remove it’
• ‘.aude/worktrees/<name> exists and is not a subagent’
• ‘<name>: not a subagent’
• ‘unknown agent '<name>' — available: <names>’
• ‘<name>: interrupt it first’
• ‘'<name>'s host is out of reach’
• ‘'<name>' did not start — <detail>’
• ‘'<name>' exited <code>’
• ‘an AUDE: target needs a terminal’
• ‘HOME is unset and the user has no home directory’
• ‘<name>, from a newer aude’

下面这些行附有解释：

resume with: aude --harness <name> --resume <id>

结束时，该行用于继续本会话。开始时，该行用于继续本会话所替换的记录。

aude cannot start: <detail> — check <file> ...

项目或框架的设置文件设置了 <detail> 所指的内容，例如钩子、API 密钥、MCP 服务器或基础 URL。删除该设置。

a project skill named '<name>' collides with a reserved command name and is not routable

重命名该技能目录。

the harness offers the model skills the project does not hold: <names>

你无法阻止这种情况。

error: <binary> exited <code> mid-turn — reconnecting to session <id>

子进程已停止。该轮次已失败。再次发送该轮次。

aude cannot see the end of <binary> — the session has ended

持有子进程的进程已停止，没有报告。

SEE ALSO

git-merge(1), git-worktree(1), aude-rc(7), aude-team(7), aude-terminal(7), aude-wiki(7), aude-wire(7), aude-workflow(7)

CAVEATS

在沙箱中运行 aude。 模型可以运行你能运行的每条 shell 命令，并且事先不会询问你。

在 macOS 上，把命令所需的访问权限授予 aude，而不是终端；通过 SSH 使用时，在会话开始之前授予。

在 claude 上，CLI 会把登录的电子邮件地址提供给模型。 aude 无法移除它。

计算机的托管设置会覆盖 aude 的设置。 aude 不会拒绝技能设置的钩子。

记录的事件文件会一直增长，直到该记录被移除或被替换。

aude 不能作为 1 号进程运行。请使用 init，例如 ‘docker run --init。’

如果所有 aude 进程都收到 SIGKILL，隧道程序会继续运行。启动自己会话的程序也会继续运行。

模型启动的命令可以在 aude 停止后继续运行。

如果只有 GIT_ 变量给出身份，合并会失败。请用 git config 设置 user.name 和 user.email。