OpenWork 中转 API 配置指南

前提条件

• 已安装 OpenWork 桌面版（从 GitHub Releases 下载对应平台安装包）
  • macOS：openwork-desktop-macos-arm64.dmg（Apple Silicon）或 openwork-desktop-macos-x64.dmg（Intel）
  • Windows：openwork-desktop-windows-x64.msi
• 拥有中转 API 的地址和密钥

配置文件说明

OpenWork 底层基于 OpenCode，涉及三类配置文件：

文件	路径	用途
全局配置	~/.config/opencode/opencode.json	Provider 和 baseURL
密钥存储	~/.local/share/opencode/auth.json	API 密钥
工作区配置	各工作区目录下的 opencode.jsonc	工作区级别的 Provider 配置

注意： auth.json 必须放在 ~/.local/share/opencode/，放在 ~/.config/opencode/ 会导致密钥无法读取。

第一步：创建全局配置

macOS

mkdir -p ~/.config/opencode
nano ~/.config/opencode/opencode.json

Windows

在资源管理器中打开 C:\Users\<用户名>\.config\opencode\，如果目录不存在则手动创建，然后新建 opencode.json 文件。

配置内容

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://你的中转地址/api/v1"
      }
    }
  }
}

第二步：配置 API 密钥

macOS

mkdir -p ~/.local/share/opencode
nano ~/.local/share/opencode/auth.json

Windows

在资源管理器中打开 C:\Users\<用户名>\.local\share\opencode\，如果目录不存在则手动创建，然后新建 auth.json 文件。

配置内容

{
  "anthropic": {
    "type": "api",
    "key": "你的API密钥"
  }
}

注意： type 必须是 "api"，不能填 URL。

第三步：修改工作区配置

OpenWork 的工作区配置文件位于：

macOS

• 默认工作区：~/Library/Application Support/com.differentai.openwork/workspaces/starter/opencode.jsonc
• 自定义工作区：你选择的工作区目录下的 opencode.jsonc

Windows

• 默认工作区：%APPDATA%\com.differentai.openwork\workspaces\starter\opencode.jsonc
• 自定义工作区：你选择的工作区目录下的 opencode.jsonc

配置内容

在工作区配置中添加 provider 部分：

{
  "$schema": "https://opencode.ai/config.json",
  "default_agent": "openwork",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://你的中转地址/api/v1"
      }
    }
  },
  "mcp": {
    "control-chrome": {
      "command": [
        "chrome-devtools-mcp"
      ],
      "type": "local"
    }
  }
}

第四步：启动并验证

重启 OpenWork，在界面中输入 /models 选择模型，正常对话即表示配置成功。

Windows 特别注意事项

移除 opencode-scheduler 插件

默认工作区配置中包含 "plugin": ["opencode-scheduler"]，该插件不支持 Windows，会导致报错：

"Scheduler is not supported on Windows yet."

解决方法：从 opencode.jsonc 中删除以下内容：

"plugin": [
  "opencode-scheduler"
]

常见问题

Q: 报错 "Failed to load tasks"

原因： 工作区配置中未添加中转 API 的 provider 配置，或密钥未正确配置。

解决： 确认工作区的 opencode.jsonc 中包含 provider.anthropic.options.baseURL，且 auth.json 路径和格式正确。

Q: 报错 "Anthropic API key is missing"

原因： auth.json 路径不对或内容格式错误。

解决： 确认文件在 ~/.local/share/opencode/auth.json，且 type 为 "api"。

Q: 报错 "Unrecognized key: apiKey"

原因： 在 opencode.json 的 provider 中添加了 apiKey 字段。

解决： 密钥只能通过 auth.json 或环境变量 ANTHROPIC_API_KEY 配置，不能写在 opencode.json 中。

Q: 报错 "Scheduler is not supported on Windows yet."

原因： 工作区配置中包含 opencode-scheduler 插件。

解决： 从 opencode.jsonc 中移除 "plugin": ["opencode-scheduler"]。

相关路径速查

macOS

用途	路径
全局配置	~/.config/opencode/opencode.json
密钥存储	~/.local/share/opencode/auth.json
工作区数据	~/Library/Application Support/com.differentai.openwork/
工作区列表	~/Library/Application Support/com.differentai.openwork/openwork-workspaces.json
应用缓存	~/Library/Caches/com.differentai.openwork/

Windows

用途	路径
全局配置	C:\Users\<用户名>\.config\opencode\opencode.json
密钥存储	C:\Users\<用户名>\.local\share\opencode\auth.json
工作区数据	C:\Users\<用户名>\AppData\Roaming\com.differentai.openwork\
工作区列表	C:\Users\<用户名>\AppData\Roaming\com.differentai.openwork\openwork-workspaces.json
应用缓存	C:\Users\<用户名>\AppData\Local\com.differentai.openwork\