Omarchy AI Agents 指南：Claude Code、Codex、默认 Agent 与本地模型
在 Omarchy 中安全启动 Claude Code、OpenAI Codex、OpenCode 等 AI Agent，设置默认 Agent、查看用量并使用 Ollama 或 LM Studio。
Omarchy 把 AI 编码 Agent 当作桌面一级工具，但不会替你选择供应商。多个 CLI 通过 mise 延迟安装：第一次运行时才下载，并在各自官方流程中登录。
可用 Agent 与启动命令
当前官方手册列出的入口包括：
| 命令 | Agent |
|---|---|
claude | Claude Code |
codex | OpenAI Codex |
opencode | OpenCode |
copilot | GitHub Copilot CLI |
agy | Google Antigravity CLI |
crush、grok、pi、omp、ori | 对应的第三方 Agent 或工具链 |
首次执行前确认命令来自 Omarchy 的 mise stub，而不是 PATH 中的同名未知脚本。登录、订阅、模型价格和数据政策应以各供应商当前说明为准。
设置默认 Agent
可以从 Setup → Defaults → Agent 选择，也可以使用：
omarchy default agent <name>选择后，Super + Shift + Ctrl + A 会在独立终端启动默认 Agent。也可直接传入任务：
omarchy agent prompt "Review this project"终端别名 a、c、cx、cy 分别用于默认 Agent、OpenCode、Claude Code 和 Codex。别名和默认行为可能随版本调整，运行前用当前 shell 配置与官方 AI 手册核对。
默认入口可能使用自动批准模式
Omarchy 的部分 Agent 快捷入口会以不暂停询问的模式运行。先在测试仓库和计划模式中观察，检查工作区、密钥权限、网络访问与 Git diff，再允许修改重要项目。
Agents Panel 与用量
系统检测到 AI 编码用量后，顶栏会出现 Agents 图标。面板可以汇总订阅、会话/周额度和按模型统计；支持范围取决于当前版本和供应商。用量记录由本地任务周期更新，不应把面板估算值当成最终账单。
不要把 API Key 写进截图、教程、shell 历史或公开 dotfiles。优先使用供应商登录流程、系统密钥存储或权限受控的环境配置。
Omarchy Skill 与系统定制
Omarchy 会把系统技能链接到 Claude Code、Codex、Pi、Antigravity 和通用 Agent 技能目录，用于解释桌面配置、顶栏和主题。官方把它标记为实验性能力。
安全使用顺序：
- 先让 Agent 只读检查并提出计划；
- 确认它引用的是当前 Omarchy 配置路径；
- 备份用户覆盖并保存 Git diff；
- 一次只改一个组件；
- 失败时回退变更，必要时使用官方配置恢复入口。
Agent 给出的命令不是系统事实来源。涉及磁盘、引导、用户、网络和系统包时必须人工复核。
崩溃诊断
Omarchy 可以监听 systemd-coredump，在进程崩溃时把核心信息交给默认 Agent 分析。手动入口是：
omarchy agent crash <pid>核心转储和日志可能包含文件路径、命令参数与内存中的敏感信息。提交上游问题前脱敏，并先确认崩溃是否可复现。
本地模型与语音输入
Install → AI 提供 LM Studio、Ollama 和语音输入相关选项。LM Studio 适合图形化选择和运行开放模型，Ollama 适合 CLI 与本地服务集成。选择模型时核对：
- 内存/显存需求与量化版本；
- 模型许可证和商业使用限制；
- 是否允许远程访问本地服务；
- 提示、日志和对话是否离开设备。
语音输入属于麦克风数据处理；安装前阅读其模型下载、录音保存和遥测说明。
下一步可用终端、Tmux 与 LazyVim建立 Agent 工作区，并用快照与恢复指南准备系统级退路。