alt
开发者文档

开发者文档

CLI

通过一个交互式设置向导，即可在终端中完成 Alt 集成配置。

altalt CLI 会引导你设置 MCP、REST API 和 webhook，同时不会覆盖现有配置。请在要连接的项目目录中运行：

npx
npx altalt

需要 Node.js 18 或更高版本。npx 会在运行时下载当前 CLI 包，无需全局安装。

设置向导的工作内容

  1. 1

    连接 MCP

    检测 Claude Code 和 Codex，提供 Cursor 配置，并通过浏览器 OAuth 连接 Alt 托管的 MCP 服务器。手动配置请参阅 MCP。

  2. 2

    验证 API 与 webhook

    打开账户控制台，验证你粘贴的 API 密钥并保存到当前项目；也可以在再次确认后向选定的 webhook 端点发送测试事件。

  3. 3

    交接实现工作

    确认后，将基于机器可读开发者文档的提示词交给编码智能体。如果未安装受支持的智能体，CLI 会输出可供粘贴的提示词。

模式与参数

--mcp-only将设置步骤限制为通过浏览器 OAuth 连接 MCP，随后仍会提供智能体交接。
--api-only将设置步骤限制为验证 REST API 与 webhook，随后仍会提供智能体交接。
--print-prompt输出编码智能体提示词后退出。
--dev连接开发环境。仅用于发布前 QA。
--version输出已安装的 CLI 版本。
--help输出命令用法和可用参数。

配置与密钥安全

  • CLI 会先验证密钥，再修改环境文件，并在当前项目目录中将其保存为 ALT_API_KEY。
  • 现有 Alt MCP 配置不会被删除或覆盖。必要时，OAuth 会以 alt-oauth 并存配置的方式添加。
  • 智能体交接和 webhook 测试投递都需要明确确认。部署前请查看安全中的密钥处理说明。

当前可用范围

CLI 包已公开，但在 dogfooding 期间，生产 OAuth 和 API 密钥签发目前仅对 Alt 管理员开放。现有的 API 密钥 MCP 连接仍受支持。如果控制台返回 404 或无法批准 OAuth，则说明你的账户尚未开通。