51cowork API文档
打开文档导航

Guides

API Key 配置与更新

51cowork API Key 是模型调用凭据,不是账户管理 Token。

快速答案

Key 的创建、列表和删除能力以当前控制台为准;迁移时先验证新配置,再删除旧 Key。

创建
控制台
复制
仅一次安全保存
更新
先验证新配置
存储
Secret / 本地配置
01

环境变量

Terminalbash
export COWORK_GATEWAY_URL="https://api.51cowork.com"
export COWORK_API_KEY="<key-from-dashboard>"
export COWORK_MODEL="<model-from-v1-models>"

环境变量适合本地测试和服务启动注入。生产环境使用 Secret Manager 或部署平台 Secret。

02

配置文件

  • Claude Code 使用用户级 settings.json。
  • Codex 使用 config.toml 和 auth.json。
  • OpenCode 使用用户级 opencode.json。
  • Cursor、Cherry Studio 和 WorkBuddy 在各自的模型设置中保存和更新 API Key。
  • 配置文件权限应只允许当前用户读取。
03

更新 Key 清单

  1. 1在控制台创建或选择替代 Key。
  2. 2更新所有 Secret。
  3. 3完全重启会缓存凭据的客户端。
  4. 4发送最小请求并在 Usage 验证。
  5. 5确认迁移完成后删除旧 Key。