CLI 安装引导

一行安装 OptiWaves CLI，配置密钥与模型，启动你的编码客户端。

OptiWaves CLI 是编码客户端的安装与配置向导。它把客户端连接到你的 OptiWaves API Key，实际提问、编辑文件和执行命令由选定的客户端完成。

1. 安装 CLI

无需预装 Node.js、npm 或 Homebrew，安装器会自动安装 Node.js LTS 和 npm。运行安装命令后，按终端向导完成配置。

在 Terminal 或其他终端中运行：

curl -fsSL https://cli.optiwaves.app/install.sh | sh

支持 macOS 的 Apple Silicon / Intel，以及使用 glibc 的 Linux ARM64 / x64。Alpine 等 musl 系统不在此安装包支持范围内。

在 Windows PowerShell 中运行：

irm https://cli.optiwaves.app/install.ps1 | iex

支持 Windows x64 / ARM64，提供 Windows PowerShell 5.1 和 PowerShell 7 入口。CMD 用户先使用 PowerShell 完成安装，之后可在 CMD 中运行 optiwaves。

默认安装到当前用户的 .optiwaves 目录，无需管理员权限。

安装结束自动进入向导。如果当前终端不能交互，按安装结果显示的命令启动，或重新打开终端后运行 optiwaves。

需要再次打开向导时，运行：

optiwaves

使用真实的交互式终端。上下键移动，空格多选客户端，回车确认。Windows PowerShell 若未直接运行命令，可显式使用 optiwaves.cmd 入口。

可以选择 Codex CLI、Claude Code、OpenCode、Hermes Agent、Pi、DeepSeek Harness 或 ZCode。已安装的客户端会标记状态，缺少的客户端会在后续步骤安装。ZCode 未安装时打开官网下载官方安装包，不要使用社区 npm 包。

选择“获取 key · Dashboard”打开 API 密钥，登录并创建密钥，再回到终端选择“粘贴 key”。粘贴输入不会回显。

浏览器登录不会自动将密钥交回 CLI，向导中仍需创建并粘贴。已经设置 OPTIWAVES_API_KEY 环境变量时，也可以直接配置客户端。

第一次配置选择 auto 和 medium。指定模型需要 Plus 或以上套餐，Kimi K3 需要 Max；完整列表见模型与价格。

需要加速时，在模型列表选择 auto-fast、deepseek-v4-flash-fast 或 glm-5.3-flash-fast；权限、价格和重新配置方式见 Fast 模式。

思考设置与任务示例见思考等级。Auto Fast 使用自动思考，无需另外选择档位。

在「记忆」中选择「本地记忆」即可同时配置记忆连接；已有自己的记忆方案时选择「保留现有设置」。用法见本地记忆。

向导显示安装进度，备份将修改的配置，再写入 OptiWaves 连接信息。出现完成结果后，可以选择“打开客户端”，或退出后按终端给出的启动命令运行。

例如 Codex 使用专用配置：

codex --profile optiwaves

旧版 CLI 配置的 Codex 若提示 profile 错误，先更新 CLI，再运行 optiwaves 重新配置。

在客户端发送一个简短的文本问题，确认收到回答。

需要更新 CLI、检查连接或恢复配置，继续阅读 CLI 使用与维护。