CLI 参数与自动更新
这一页说明设置里的“通用”能力中，和 Claude CLI 运行方式以及应用更新相关的部分。
Claude CLI 启动参数
Aite 支持保存自定义的 Claude CLI 启动参数。
这部分能力适合：
- 你已经熟悉 Claude CLI 参数体系
- 你希望新会话自动带上一组固定参数
- 你不想每次都在命令行里手动补
参数如何生效
当前实现里，这些自定义参数会保存下来，并在新会话创建时自动带上。
需要注意的一点是：
- 它主要影响“新会话”
- 已经运行中的旧会话不会因为你刚改了参数就自动重启并套用
为什么这个入口有价值
因为它把 CLI 层的控制能力带回到了 GUI：
- 你可以继续保留 CLI 习惯
- 但不需要每次重新手工敲完整参数
这对长期固定工作流特别有帮助。
参数输入的特点
当前实现里，参数输入不是简单字符串直通，而是会做一定的解析和校验。
例如：
- 会处理空格与引号
- 会识别不完整转义
- 会提示未闭合引号
这比纯文本保存更稳一些。
使用建议
如果你要配置自定义参数，建议：
- 先只加最必要的参数
- 每次改动后新建一个会话验证
- 出现异常时先清空自定义参数再排查
这样更容易定位到底是模型问题、环境问题，还是启动参数问题。
CLI 状态检查
通用设置里还包含 Claude CLI 的状态检查能力。
这块主要用于查看：
- Claude CLI 是否已安装
- 当前版本
- 当前路径
- Windows 下 Git Bash 是否缺失
必要时，也可以从这里直接触发安装或修复。
自动更新
Aite 已经有自动更新相关能力，但它是否可用，取决于当前构建和发布配置是否完整。
从现有实现看，自动更新能力包括：
- 初始化当前版本
- 检查更新
- 下载更新
- 安装更新
- 下载完成后重启应用
自动检查节奏
当前实现里，自动更新检查大致是这样的：
- 应用启动后延迟一小段时间进行首次静默检查
- 之后按固定间隔继续检查
这样做的目的，是尽量减少对启动过程的干扰，同时保持更新感知。
更新按钮的状态
根据当前状态，更新入口会显示不同文案，例如：
- 检查更新
- 检查中
- 下载并安装某个版本
- 下载中
- 重启应用
- 已是最新版本
所以如果你看到按钮文字变化，不一定是异常，很多时候只是状态推进。
更新不可用时
自动更新不是任何时候都一定可用。
如果当前构建缺少必要的 updater 配置，设置页会把不可用原因展示出来。
这通常意味着：
- 不是本地功能坏了
- 而是当前发布链路还没把更新元数据准备完整
排查建议
参数导致会话异常
优先清空自定义 Claude CLI 参数，再新建会话验证。
检测不到 CLI
先回到快速开始章节，检查 Claude Code 安装和 CLAUDE_CLI_PATH。
更新失败
优先区分是：
- 没有可用更新
- 更新配置未启用
- 下载或安装过程失败
把这三类情况分开看，会更容易定位问题。