acpx快速上手教程：5步跑通你的第一个AI编码持久会话（从安装到JSON输出）

acpx快速上手教程5步跑通你的第一个AI编码持久会话从安装到JSON输出【免费下载链接】acpxHeadless CLI client for stateful Agent Client Protocol (ACP) sessions项目地址: https://gitcode.com/gh_mirrors/ac/acpxacpx 是一个运行在命令行里的headless ACPAgent Client Protocol客户端让你用一条命令就能创建持久会话、调用 Codex / Claude Code 等 AI 编码智能体并输出机器可读的 JSON 事件流。本教程用 5 步带你从安装到 JSON 输出完整跑通你的第一个 acpx 持久会话。1. 安装 acpx一条命令完成acpx 以 npm 包形式发布要求Node.js ≥ 22.13无需守护进程、无需托管服务所有会话状态保存在~/.acpx/目录下。npm install -g acpxlatest acpx --version不想全局安装所有命令都支持npx acpxlatest …临时运行。更多安装细节见 docs/install.md。2. 选择你的 AI 编码智能体acpx 内置了二十多个智能体适配器最常用的两个智能体命令示例适配方式CodexOpenAIacpx codex …npx首次使用时自动拉取Claude Codeacpx claude …npx首次使用时自动拉取Gemini / Cursor / Copilot 等acpx gemini …等需自行安装上游 CLI验证适配器是否可用acpx codex --help完整内置智能体清单见 docs/agents.md自定义注册方式见 docs/custom-agents.md。3. 创建并发送第一个持久会话acpx 要求显式创建会话避免自动化中意外发起对话然后会话会按当前仓库目录作用域持久化cd ~/repos/your-project acpx codex sessions new # 创建会话记录写入 ~/.acpx/sessions/ acpx codex 找到最慢的测试并解释原因你会看到结构化的 ACP 事件流助手文本、[tool]工具调用块、计划更新以及结尾的[done] end_turn。关键来了——会话是持久的。继续追问它会接着上文对话acpx codex 现在为最慢的那个测试提一个一行修复方案 acpx codex 应用修复并重新运行该测试即使你处在src/或docs/子目录acpx 也会向上查找 git 根目录自动恢复同一个会话。会话的作用域规则(agentCommand, cwd, name)三元组见 docs/sessions.md。4. 并行会话与无状态一次性执行命名会话可以把同一仓库拆成并行工作流acpx codex sessions new --name backend acpx codex sessions new --name docs acpx codex -s backend 修复 checkout 超时 acpx codex -s docs 根据最近的提交起草发布说明如果只是想问一个不留状态的一次性问题用exec——它永不读写会话记录非常适合脚本acpx codex exec 用5个要点总结这个仓库是做什么的5. 输出 JSON让脚本消费你的会话 acpx 提供三种输出模式完整说明见 docs/output-formats.md模式命令适用场景text默认acpx codex …人类终端交互jsonacpx --format json codex …自动化管道每行一条 ACP JSON-RPC 消息quietacpx --format quiet codex …只要最终助手文本管道到jq过滤事件acpx --format json codex exec 审查改动文件中的风险模式 \ | jq -r select(.methodsession/update)脚本里只取最终答案SUMMARY$(acpx --format quiet codex exec 一句话总结当前分支)加--json-strict可保证 stdout 只有 JSON、stderr 保持安静是全自动消费管道的最佳组合。顺手配置权限 ⚡默认策略是读操作自动批准、写操作询问。想让智能体自动改文件加--approve-all纯分析场景可用--deny-allacpx --approve-all codex 应用补丁并运行测试完整权限策略表见 docs/permissions.md退出码含义见 docs/exit-codes.md。下一步去哪儿 会话管理排队、取消、导出/导入、清理docs/sessions.md提示词输入方式stdin、--file、--no-waitdocs/prompting.md完整 CLI 参考docs/CLI.md多步骤 TypeScript 工作流 Flowsdocs/flows.md示例见 examples/flows/从零到持久会话的官方快速上手docs/quickstart.md5 步走完你已经掌握了 acpx 的核心循环安装 → 选智能体 → 建持久会话 → 多轮对话 → JSON 自动化。剩下的就是让它帮你写代码吧。【免费下载链接】acpxHeadless CLI client for stateful Agent Client Protocol (ACP) sessions项目地址: https://gitcode.com/gh_mirrors/ac/acpx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考