OptiWaves
手册产品站
客户端

Claude Code

配置 Anthropic Messages 地址、环境变量密钥与 OptiWaves 模型。

先按准备 API Key设置 OPTIWAVES_API_KEY。以下配置适用于 Claude Code 2.1.260。

1. 设置项目连接

在项目中创建或编辑 .claude/settings.local.json，合并以下配置：

.claude/settings.local.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.optiwaves.app",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  },
  "model": "auto"
}

这里的地址不带 /v1，Claude Code 会请求 /v1/messages。model 决定实际调用的模型，仅修改地址不会自动切换模型。

这份文件只用于当前项目。需要全局应用时，将对应字段合入用户级 ~/.claude/settings.json；Windows 默认位置为 %USERPROFILE%\.claude\settings.json。使用自定义 CLAUDE_CONFIG_DIR 时，以自己的配置目录为准。

2. 设置密钥并启动

Claude Code 使用 ANTHROPIC_API_KEY。将前面准备的 OptiWaves 密钥传给这个变量，再从项目目录启动。

macOS / Linux

export ANTHROPIC_API_KEY="$OPTIWAVES_API_KEY"
unset ANTHROPIC_AUTH_TOKEN
claude --model auto

Windows PowerShell

$env:ANTHROPIC_API_KEY = $env:OPTIWAVES_API_KEY
Remove-Item Env:\ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
claude --model auto

以上只设置当前终端的环境。移除旧 ANTHROPIC_AUTH_TOKEN 是为了避免同时发送另一把认证凭据。若客户端首次询问是否使用环境变量中的 API Key，请确认使用这把 OptiWaves 密钥。

3. 验证与切换

进入后使用 /status 检查当前模型，再发送：

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

需要 Auto Fast 时，用下面的命令启动：

claude --model auto-fast

也可以将配置文件中的 model 改为 auto-fast 或其他允许的 OptiWaves 模型 ID。模型列表与账户权限分别检查，详见模型与价格。

常见问题

情况检查
请求路径重复出现 /v1/v1ANTHROPIC_BASE_URL 应为 https://api.optiwaves.app
使用了其他账户或认证失败检查当前终端的 ANTHROPIC_API_KEY、旧 token 和已有 apiKeyHelper 配置
模型名称被客户端拒绝确认使用支持网关模型发现的版本，并启用本页 discovery 设置
配置没有生效从包含 .claude/settings.local.json 的项目目录启动，检查更高优先级的管理设置

参考 Claude Code 连接配置与环境变量。返回客户端选择。

本地记忆

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

optiwaves memory --client claude-code

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

售后群 1055897442

本页