本页译自英文文档。命令、标识符和示例保持原样。运行时 7.24.4 · SDK 2.6.7。 英文原文

从这里开始

状态：生效 范围：当前状态 最近审阅：2026-09-16 负责人：ax-code 运行时

如果根目录的 README 是安装 AX Code 最快的方式，本页就是理解它最快的方式。

版本与可用性

从 AX Code Standard 开始，这是对个人和 商业用途免费的开源版本。使用本地或云端模型；AX Engine 在受支持的 Apple Silicon Mac 上提供原生本地推理 路径。现有的权限、变更审阅和本地 执行证据仍然是核心能力。

Business 是规划中的专有产品，通过 AX Trust 做组织治理，通过 AutomatosX 做业务工作流。在工作中使用 Standard 本身并不 需要 Business 许可证。细节见 Standard 与 Business。

已签名的安装器和运行时归档可以从 download.ax-code.com 匿名获得。阅读 安装指南 和 升级与恢复指南。公开技术文档托管在 ax-code.app/zh-CN/docs/，独立于源码访问。 已经安装了？在你的项目中打开终端，运行 ax-code，然后在 TUI 内使用 /connect 选择提供商。先提一个关于 项目的问题，请求一项小变更，并在 提交之前审阅差异和项目检查。如果已安装的运行时需要诊断，使用 ax-code doctor。

AX Code 是什么

AX Code 是一个 AI 编程运行时。它结合了：

• 面向不同编程任务的代理
• 显式的工具执行
• 模型和提供商选择
• 持久的会话状态
• 可配置的隔离和权限
• 诸如 TUI、SDK、服务器模式和 MCP 之类的集成表面

这很重要，因为只有当你能控制代理被允许做什么、跨会话保留上下文，并在单个聊天窗口之外复用同一工作流时，AI 编程在真实仓库中才有用。

价值从哪里来

AX Code 优化的是代理完成 之后 的那一刻：决定是否保留它产出的东西。

• 证据。 每个会话都记录为带类型的事件日志加上文件快照，因此 ax-code graph、compare、replay、risk 和 audit 可以在对话结束后重建发生了什么。
• 验证。 在门禁可以强制的地方 — arena 候选、受门禁的重构应用 — 由你仓库自己的类型检查、代码检查和测试命令决定结果是否被接受。
• 可逆性。 快照可以按步骤恢复，而不只是按会话，来自保存在你仓库之外的 Git 对象存储。
• 你的决定。 AX Code 排名、打分和报告。它不会替你合并。

支撑这些的是：带权限规则和隔离模式的显式工具、持久会话、用于仓库约定的 AGENTS.md、提供商可移植性，以及 TUI、CLI、VS Code 扩展、SDK、无头服务器和 MCP 集成背后的同一个运行时。这些是基础，而不是选择 AX Code 的理由 — 见 为什么选择 AX Code。

命令本身见 执行证据。

心智模型

把 AX Code 想成五层：

1. 提供商层：选择你想要运行的模型后端。
2. 代理层：为任务挑选合适的代理，或让路由来帮忙。
3. 工具层：代理通过显式工具行动，而不是隐藏的能力。
4. 会话层：对话、决定和状态会持久化。
5. 控制层：隔离、权限和审计行为定义边界。

文档的其余部分映射到这些层上。

选择下一条路径

我想快速试用

• 从 根 README 开始，了解安装和首次启动。
• 受支持的安装路径使用编译后的运行时：
  • 用于 macOS Apple Silicon 和 Linux 的 Bash 发行版安装器：curl -fsSL -H "Accept: application/vnd.github.raw+json" "https://api.github.com/repos/defai-digital/ax-code/contents/install?ref=main" | bash
  • macOS CLI 的 Homebrew 替代方案： brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • 用于 Windows PowerShell 的 GitHub 发行版安装器：powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• Bash 安装器不是规范的 Windows 设置路径。
• npm 包不再是受支持的安装或升级渠道。平台策略、运行时标签和本地启动器矩阵见 安装与运行时渠道。
• 使用 /connect 或 ax-code providers login 设置模型。云 API 提供商、CLI 提供商、AX Engine 和模型 ID 见 支持的提供商与模型。零成本评估路径请使用 免费层 API 快速入门。
• 打开真实项目后运行 ax-code init，以便 AGENTS.md 捕获本地约定。
• 如果你想要更紧的安全边界，请在更广泛的编辑之前启用 沙盒模式。

我想在团队或公司仓库中安全地使用它

• AX Code 启动时自主模式开启、沙盒模式关闭：full-access，文件系统和网络访问不受限制。
• 对于团队、公司、不受信任或无人值守的工作，请在开始任务之前启用 --sandbox workspace-write（或 read-only）。
• 执行边界请阅读 沙盒模式。
• 如果代理将无人值守运行，请阅读 自主模式。
• 威胁模型和凭据存储细节请阅读 安全策略。
• 如果出处和重放对你的工作流重要，请阅读 语义层。

我想嵌入或自动化它

• 使用 @defai-digital/ax-code-sdk 的无头或 gRPC 入口来做 TypeScript 应用集成。
• 使用 HTTP 与 OpenAPI 兼容性 作为服务边界、生成的客户端，以及权威的 OpenAPI 契约。
• 当代理需要外部工具或服务时，使用 ax-code mcp add。

我想理解仓库或贡献反馈

• 阅读 文档中心 以了解其余公开文档。
• 阅读 CONTRIBUTING.md 以了解当前的外部贡献策略。

AX Code 可能不适合的时候

AX Code 有意不止是自动完成或托管聊天框。在以下情况它可能过重：

• 你只需要行内代码建议，而不希望代理执行工具。
• 你需要只存在于托管 SaaS 中的体验，没有本地运行时。
• 你不需要会话持久化、重放、SDK/服务器集成或仓库级指令。
• 你所在的环境不允许任何本地 CLI 进程。

在这些情况下，更轻的编辑器助手可能更简单。当代理需要在真实开发工作流中运作，并带有控制、连续性和集成边界时，AX Code 最强。

常见的第一条命令

ax-code
ax-code providers login
ax-code models
ax-code run --model qwen -- "Review this change"
ax-code init
ax-code index
ax-code mcp add
ax-code doctor

Grok 只通过 Grok Build CLI 运行。选择 grok-build-cli，位置在 /connect 中；AX Code 会调用本地 grok 命令，并复用其 CLI 登录/会话。原先直接的 xai 云 API 提供商不再受支持。

文档地图