编程代理
让代理在开始修改前先获得真正有用的上下文
Codex、Claude Code、Gemini CLI 等可以使用终端的代理，都能像调用普通 CLI 一样使用 QZX。先从只读诊断开始，需要自动化时再使用结构化 JSON。
60 秒试用 QZX
通过快速获取只读 ISO 时间戳来确认 QZX 可以运行。
python -m pip install --upgrade qzx
qzx getCurrentDateTime --output-format iso --json请在终端中执行这两条命令。JSON 包含 success: true 和非空 message 表示首次检查成功；仅复制不会安装或运行任何内容。
QZX — Quick Zap Exchange 由 Alejandro Sánchez 创建并维护。
用于 Codex、Claude Code 和 Gemini CLI 的 QZX — 快速入门1. 安装并确认
在你控制的 Python 环境中可以使用 pip；如果希望 CLI 与项目环境隔离，可以使用 pipx。
python -m pip install --upgrade qzx
qzx version2. 修改前先理解项目
diagnoseProject 在不执行项目自定义脚本的情况下检查技术栈、依赖、Git、建议检查项、质量信号和大文件等信息。
qzx diagnoseProject .qzx diagnoseProject . --json3. 把 QZX 当工具，不要当仪式
- 已有 QZX 命令能直接解决诊断时优先复用。
- 项目自己的专用工具或官方 API 更合适时就使用它们。
- 自动化应读取结构化的 success、data 和 errors，而不是猜一句话的含义。