实时 Language Server Protocol(LSP)
直接集成 TypeScript、Rust、Go、Python 与 Ruby 的活跃语言服务器。lsp 工具提供定义跳转、引用查找、调用层次(incomingCalls / outgoingCalls)与汇总的编译器诊断(diagnosticsAggregated)。当 agent 编辑代码时,实时的类型检查与编译器错误会直接反馈到执行循环,立即自我纠正。
深入开发工作流程
AX Code 是一个 agent harness:它将模型连接到项目工具、会话记录与审查流程。真正的价值在于 agent 修改你的代码之后,你仍然可以查看、验证与回滚。
本导览使用任务示意。下方的命令描述真实的 AX Code 界面;请将示例会话 ID 替换为你自己的。本页面不会运行任何模型。
在仓库中打开 AX Code,使用 /connect 选择支持的本地运行时、云端 API、编程 CLI 或私有 GPU 端点。在向不熟悉的代码授予访问权限之前,先设置沙盒与权限。普通会话不会自动强制运行你项目的测试套件。
ax-code --sandbox read-only请 agent 找出哪里会接受空输入,并指出相关的测试。审查它的发现,开启你打算允许的写入范围,然后请求一项聚焦的修复。可复用的技能可以提供团队的调查或审查指引。
找出为什么只含空白的输入会被接受。在进行修改之前,先显示相关的代码与测试。
运行仓库检查并查看差异。使用会话图谱查看已记录的步骤与工具调用。已记录的检查失败仍然是失败;agent 的完成消息并不能证明补丁是正确的。
git diff
ax-code graph <session-id>对比两个会话,审查执行与风险信号的变化。在选择回滚步骤之前,先列出可用的回滚点。回滚依赖于保留的快照,无法撤销已发送的消息或远程部署等外部副作用。
ax-code compare <session-a> <session-b>
ax-code rollback <session-id> --list安装受支持的 CLI 并登录,再使用下方的提供商 ID 将它连接至 AX Code。适配器会复用 CLI 的本地登录状态与会话。
| 编程 CLI | 提供商 ID | 本地命令 |
|---|---|---|
| Claude Code | claude-code | claude |
| Codex CLI | codex-cli | codex |
| Grok Build CLI | grok-build-cli | grok |
| Muse Code CLI | muse-cli | muse |
每个 CLI 提供商都复用该提供商 CLI 自己的登录状态。请先安装并登录该 CLI,再使用上表中的提供商 ID 将其连接到 AX Code:
ax-code providers login <provider-id>使用 AX Code 的技能与仓库检查来组织任务,然后审查已记录的会话与产生的差异。能力与可见性取决于适配器与 CLI;仅有集成并不意味着更高的编码准确性,也不会让每个嵌套操作都可见。
CLI 提供商设置与要求 ↗选择 Claude Code、Codex CLI、Muse Code CLI 或 Grok Build CLI 作为提供商,再搭配支持的云端 API、本地模型与私有 GPU 端点。使用 Council 从多个已连接的提供商收集独立审查意见,或用 Arena 比较候选方案。可用的成员取决于你的连接与模型能力。Council 仅供参考;由你审查结果并决定保留哪些成果。
多模型工作流程指南 ↗通过 OpenAI 兼容端点连接私有 GPU 云或你自己的 GPU 服务器。在 /connect 中选择 Private GPU cloud → Custom provider,输入端点 URL 与 API 密钥,然后选择一个已发现的模型。服务器必须提供模型发现功能,并支持编码任务所需的模型能力。
WebMCP 是一项拟议的网页标准,让网站向 agent 提供结构化工具。AX Code 可以发现并调用这些工具、读取页面快照和屏幕截图、查看控制台消息及请求元数据,并操作页面控件。
了解 WebMCP 和浏览器操作Arena implement 模式在隔离的 Git worktree 中运行候选方案,并通过仓库检查进行评估。验证通过的候选会排在验证失败者之前。由你审查证据并选择保留内容;AX Code 不会自动合并任何胜出方案。
阅读文档化的执行与 Arena 能力 ↗AX Code 以双层语义智能架构取代盲目的代码编辑:
直接集成 TypeScript、Rust、Go、Python 与 Ruby 的活跃语言服务器。lsp 工具提供定义跳转、引用查找、调用层次(incomingCalls / outgoingCalls)与汇总的编译器诊断(diagnosticsAggregated)。当 agent 编辑代码时,实时的类型检查与编译器错误会直接反馈到执行循环,立即自我纠正。
通过 ax-code index 构建的持久化代码图谱,提供整个仓库的结构智能,而不消耗 LLM 的上下文窗口。查询调用者与被调用者,在修改前计算确切的影响范围(impact_analyze),扫描异步竞态条件(race_scan),并捕捉资源生命周期泄漏(lifecycle_scan)。
大型代码库需要架构基础,而不仅仅是 grep。AX Code 内置原生的仓库 wiki 编译器(@automatosx/ax-wiki),通过 ax-code wiki 访问:
将仓库架构、模块职责、约定与数据流编译为 ax-wiki/ 下清晰的 Markdown 知识库,并直接链接到已验证的源代码符号。
ax-code wiki update 会比较源代码哈希与 wiki 清单,仅重新生成受近期 git 提交影响的页面,让文档保持同步,而无需高昂的完整重建成本。
使用 <!-- AX-WIKI:PROTECTED:START --> 标记保存人类的知识。架构决策、生产环境注意事项与安全不变式都能在自动化更新中保留下来。
编译精简的 wiki 卡片(.ax-code/wiki-cards.md),并将知识指针注入 AGENTS.md,确保 agent 在提出修改前先理解模块边界与约束。
产生回复与工具使用决策,例如 Qwen 与 DeepSeek 等模型。其速度与质量取决于确切的模型、服务设置与任务。
将模型连接到工具并管理执行循环。AX Code、Codex、DeepSeek Harness 与 Hermes Agent 都属于这一类别。DeepSeek Harness 与 DeepSeek 的模型 API 是两个独立的项目。
可复用的任务指令与可选的辅助资源。技能用于引导 agent,但不会取代运行时,也不保证输出正确。AX Code 支持以 SKILL.md 定义的项目技能。
用同一个任务评估工具边界、会话证据、回滚、定制化与验证。技能或本地模型等共同特性,并不能证明某款工具更胜一筹。