Zcode CLI 是一份围绕 Zcode 官方命令行工具的使用技能规范，重点在于安全、可审计地配置 API-Key 访问并执行授权任务。资料描述了一个完整的工作路径：先根据用户请求明确任务、工作区、允许的影响、目标模型与推理级别以及预期结果；随后定位官方 CLI，检查版本、--help 与 doctor --json，并阅读 CLI 契约以了解已验证命令、macOS 捆绑运行时回退和版本相关限制。
在连接配置方面，该技能要求通过受支持接口检查运行时可用模型目录与认证状态。对于 API-Key 设置，需要判断密钥属于 Coding Plan 还是标准 API，并采用匹配的模板与访问类型；若请求未明确服务类型，应主动询问，而不能仅凭密钥形态推断。同时要保留现有账户与提供商配置，必要时使用独立的私有 profile。资料特别指出，Desktop 登录、已存储默认值和 doctor 检查成功均不能证明模型访问可用。
任务执行阶段，需为会话选择指定的提供商、模型和支持的推理选项，运行前回读已有会话的选择；新建无头会话需遵循首次调用验证并回读返回的会话。权限模式必须显式选择，只读工作使用 plan 模式，编辑任务使用任务允许的模式与审批交互；无头提示在受检版本中默认 yolo，因此不得省略 --mode 或为让无人值守运行继续而放宽权限。任务提示应自包含，包含相关来源、允许操作、保留要求和预期答案或产物，并保留准确的会话 ID、进程结果与相关事件。
模型与会话选择方面，默认使用 GLM-5.3 的 max 级别，短小机械任务可用 high，连接检查与冒烟测试可用 low；这些默认值仅在当前目录提供时成立，其他模型应使用其自身目录选项。资料提醒用量按 credits 计量，每次调用带有较大的固定提示，突发请求会触发速率限制，规划多次调用前应阅读用量限制，并保持每个账户同一时间只有一个 Zcode 运行。交互式选择与常规审批优先使用 TUI，自动化需要结构化模型发现、会话选择与审批响应时使用 app-server。续接相关工作应使用准确返回的会话 ID，独立工作应新建会话，避免在并发工作可能使最新会话不明确时使用 --continue，且不得同时运行同一会话的两个续接。
权限与记录方面，并发写入者应处于各自授权的工作区或分配不相交的文件；worktree 仅隔离 Git 变更，不包含 shell 命令、MCP 工具、网络访问或共享 Zcode 状态。工具排除会移除整个命名工具，而非命令模式允许列表。认证应使用正常掩码登录流程或授权私有提供商 profile 中提供的密钥，禁止提取 Desktop 凭据、复制私有认证头、修改权益标志、记录密钥或替换提供商以绕过失败。若认证、模型访问或所需权限无法建立，应停止受影响的启动并报告观察到的错误。提示、附件与工具结果可能发送给所选提供商并保留在会话存储中，凭据值不得出现在参数与提示中。
完成阶段应先返回所请求的答案或产物，并附上 CLI 版本、请求与观察到的模型选择、推理级别、权限模式、会话 ID、进程或轮次结果、相关验证与剩余阻塞项。本地选择回读只能标记为配置证据，只有在收到实际响应后才能声称模型调用成功。维护该包时需验证元数据、资源链接、有来源的命令与发现，文档变更不需要付费模型试用。资料未提供具体的安装命令、价格、计费细节或平台支持范围。