OptiWaves
手册产品站
客户端

Codex CLI

创建 OptiWaves 专用 profile，使用环境变量密钥连接 Responses API。

先按准备 API Key在终端设置 OPTIWAVES_API_KEY。以下配置适用于 Codex CLI 0.134.0 及以上。

1. 创建 profile 文件

系统文件位置
macOS / Linux~/.codex/optiwaves.config.toml
Windows%USERPROFILE%\.codex\optiwaves.config.toml

如果已经自定义 Codex 配置目录，文件放在该目录下、与 config.toml 同级。写入：

optiwaves.config.toml
model = "auto"
model_provider = "optiwaves"
model_reasoning_effort = "medium"
model_context_window = 500000

[model_providers.optiwaves]
name = "OptiWaves"
base_url = "https://api.optiwaves.app/v1"
wire_api = "responses"
env_key = "OPTIWAVES_API_KEY"

env_key 填环境变量的名称，实际密钥由启动进程读取。optiwaves 是本地 provider 名称，auto 是发送给 OptiWaves 的模型 ID。

Codex 0.134.0 及以上使用独立的 optiwaves.config.toml，--profile 不再读取 config.toml 中旧式的 [profiles.optiwaves]。若已有旧表，将其中的模型设置迁移到这个文件并移除旧表；保留其他配置。格式与加载顺序见 Codex Profiles。

2. 启动 Codex

在项目目录、已设置密钥的终端中运行：

codex --profile optiwaves

进入后使用 /status 核对当前模型，并发送：

只在对话中回答：用一句话解释 TypeScript 的联合类型。

收到回答后再开始项目任务。本地文件和命令权限仍由 Codex 自身的权限设置控制。

3. 切换模型

例如切换为 Auto Fast：

codex --profile optiwaves --model auto-fast

这次启动使用指定模型。要持久修改，在 profile 中更新 model。选择其他模型时，按模型与价格同步确认上下文窗口与权限；不要把 Auto 的窗口配置直接套给所有模型。

常见问题

情况检查
找不到 optiwaves profile文件名应为 optiwaves.config.toml，并与用户级 config.toml 同级
缺少环境变量密钥在启动 Codex 的同一个终端重新设置 OPTIWAVES_API_KEY
仍使用其他 provider使用本页完整启动命令，检查用户配置、profile 与命令行覆盖项
返回 403 或 429检查模型权限、密钥白名单与对应额度

完整字段见 Codex 配置参考。返回客户端选择。

本地记忆

API 接通后，可用 OptiWaves CLI 为这个客户端配置本地记忆：

optiwaves memory --client codex

重启客户端后，用一次保存和一次新会话召回检查结果。具体路径与限制见本地记忆。

售后群 1055897442

本页