这是 Qwen Code CLI 的端到端测试指南，用于单元测试不足以验证完整链路（模型 API → 工具校验 → 工具执行）时的行为验证。
用途与准备：复现 bug 时用全局安装的 qwen 命令，以匹配用户提交问题时的环境；验证修复时先构建（npm run build && npm run bundle）再运行 node dist/cli.js；最快的运行时检查用 npm run dev -- "<prompt>" <flags>，无需构建。真实模型运行需通过 --auth-type 指定提供方（openai/anthropic/qwen-oauth/gemini/vertex-ai），仅用 --model 不会切换提供方。可用 QWEN_RUNTIME_DIR 重定向 tmp/、debug/、projects 等运行时产物，配置仍从 ~/.qwen 读取。
主要能力与用法：无头模式以 --output-format json 输出单个 JSON 数组，类型含 system、assistant、user（含 is_error 的 tool_result）、result，可用 jq 过滤；stream-json 则输出 NDJSON。交互模式借助 tmux 验证 TUI 渲染与键盘交互，需先等待初始化，发送提示时文本与 Enter 之间留短延迟，通过轮询 "esc to cancel" 状态行判断完成，最后 tmux kill-session 清理。API 流量检查可用 --openai-logging 与 --openai-logging-dir 导出每次调用的请求/响应 JSON。脚本 scripts/token-stats.py 可统计 token 用量。MCP 测试见 references/mcp-testing.md，Mock OpenAI 服务器见 references/mock-openai-server.md。
限制：tmux 无法可靠发送所有按键组合，视觉闪烁等中间状态无法捕捉；涉及权限提示、slash 命令、键盘交互或挂起问题时用交互模式，测试权限规则时用 --approval-mode default 而非 yolo。具体版本与收费信息暂未提供。