用 OpenCode 开始对话

下面以 OpenCode 为例，演示如何连接 OptiWaves 并开始对话。

1. 选择并配置 OpenCode

先按 CLI 安装引导安装 OptiWaves CLI。安装完成会自动进入向导；已经安装时，可在终端重新打开：

optiwaves

在向导中按顺序操作：

1. 在客户端列表中选中 OpenCode，按空格勾选，再按回车确认。
2. 粘贴你的 OptiWaves API Key；还没有密钥时，选择“获取 key · Dashboard”创建。
3. 模型选择 auto，思考等级先选 medium。
4. 等待安装和配置完成，再退出向导，按下一步启动 OpenCode。

已安装的 OpenCode 会跳过安装，CLI 会备份并写入 OptiWaves 配置。已经配置其他客户端的用户，也可以重新运行向导，只选择 OpenCode。

如果 OpenCode 已安装，而且当前终端已经设置 OPTIWAVES_API_KEY，也可以直接配置：

optiwaves configure --client opencode --model auto --effort medium

需要直接编辑配置文件时，阅读 OpenCode 手动配置。

2. 启动对话客户端

在你准备使用的文件夹中打开终端，运行：

opencode --model optiwaves/auto --agent plan

optiwaves/auto 表示使用 OptiWaves 提供的 Auto 模型。在 OpenCode 中看到的名称是 OptiWaves Auto。

本例使用 OpenCode 的 Plan 模式进行讨论与分析。按其默认权限，文件修改和命令执行会先请求确认；它与模型的思考等级、OptiWaves Fast 模式分别设置。详情见 OpenCode 的 Plan 说明。

若之前已从向导直接打开 OpenCode，可以按 Tab 切换到 Plan，然后继续。

3. 发送第一条消息

在 OpenCode 的输入框中发送：

我想在一周内入门 Python，每天有 30 分钟。请给我一个简洁的学习计划，直接在对话中回答。

等待回答完成后，可以继续追问或切换话题。

4. 在同一会话中追问

继续发送：

把第一天拆成三个练习，先不要给答案。

这条消息会沿用当前会话的上下文。补充限制、要求举例或调整回答形式，都可以直接在同一会话里继续说明。

5. 新建、继续或退出会话

下面这些指令输入在 OpenCode 的对话输入框中：

会话操作由 OpenCode 管理，更多用法见 OpenCode 终端界面说明。

遇到连接问题

先退出 OpenCode，在系统终端运行：

optiwaves status --client opencode
optiwaves doctor --client opencode --network

网络检查只验证连接与模型目录，不产生模型回答。根据症状继续排查：

详细排查见 API 错误与限制。这里使用的是 OptiWaves API Key，模型权限和消耗按你的 OptiWaves 账号计算。使用 auto 扣减 Auto 用量，具体规则见消耗说明。

需要查询网页或核对多个来源时，继续阅读在 CLI 中使用搜索。