客户端

选择你使用的客户端，查看对应的配置文件、连接参数和启动步骤。

独立配置与 Responses 接入

配置 Messages 接入

添加 OptiWaves 提供方

注册模型与默认选项

配置命名提供方

配置连接与模型

写入 Responses 提供方

准备 API Key

先安装需要使用的客户端，并在 API 密钥创建一把 OptiWaves 密钥。各教程默认选择 auto，调用时仍会检查密钥、套餐与额度。

这些教程使用终端环境变量 OPTIWAVES_API_KEY。在随后启动客户端的同一个终端中设置它。ZCode 不读取环境变量，按 ZCode 把密钥写入配置文件。

以下为 Bash 命令；macOS 默认 zsh 可先输入 bash：

read -r -s -p 'OptiWaves API Key: ' OPTIWAVES_API_KEY
printf '\n'
export OPTIWAVES_API_KEY

$credential = Read-Host "OptiWaves API Key" -AsSecureString
$env:OPTIWAVES_API_KEY = [Net.NetworkCredential]::new("", $credential).Password

新终端需要重新设置环境变量。从桌面图标打开的程序通常不会继承当前终端的变量；按教程从这个终端启动客户端。

新安装且配置为空时，可以使用教程中的完整示例。已有配置时，先备份，再合并展示的字段，保留其他 provider、工具、权限和项目设置。没有配置目录或文件时，先创建它们。

配置中的 OPTIWAVES_API_KEY、$OPTIWAVES_API_KEY 和 {env:OPTIWAVES_API_KEY} 是不同客户端的变量引用语法，按对应教程填写，不要相互替换。

接通后继续使用客户端的文件工具和已授权 MCP。阅读客户端工具适配了解调用如何完成；需要跨会话保存偏好时，按本地记忆配置。

发送一个简短的文本问题，确认连接成功。

切换模型前查看模型与价格，确认套餐与 API Key 允许使用该模型。
需要 Fast 时，按对应客户端的模型设置选择 auto-fast、deepseek-v4-flash-fast 或 glm-5.3-flash-fast；倍率见 Fast 模式。
遇到连接或额度问题，按 API 错误与限制排查。

希望通过向导完成安装与配置，可以使用 CLI 安装引导。开发自己的程序则阅读使用 SDK 开发。