AI 工具接入指南

开始前

1. 1在控制台创建并复制 API Key。
2. 2使用 https://api.51cowork.com，并通过 https://api.51cowork.com/v1/models 选择模型。
3. 3备份已有客户端配置文件；合并配置，不要直接覆盖其他 provider。
4. 4命令行工具先在临时终端验证；桌面工具保存后选择配置的模型发送测试请求。

Claude Code

Claude Code 使用 Gateway 根地址和 ANTHROPIC_AUTH_TOKEN。

export ANTHROPIC_BASE_URL="https://api.51cowork.com"
export ANTHROPIC_AUTH_TOKEN="<key-from-dashboard>"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export CLAUDE_CODE_ATTRIBUTION_HEADER=0
claude

$env:ANTHROPIC_BASE_URL="https://api.51cowork.com"
$env:ANTHROPIC_AUTH_TOKEN="<key-from-dashboard>"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
$env:CLAUDE_CODE_ATTRIBUTION_HEADER="0"
claude

需要用户级持久配置时，将以下内容保存到 ~/.claude/settings.json；Windows 使用 %USERPROFILE%\.claude\settings.json。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.51cowork.com",
    "ANTHROPIC_AUTH_TOKEN": "<key-from-dashboard>",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Codex CLI / Extension

Codex 使用 Responses wire API。

将 provider 配置合并到 ~/.codex/config.toml；Windows 路径为 %USERPROFILE%\.codex\config.toml。模型 ID 必须替换为当前网关返回值。

model_provider = "51cowork"
model = "<model-from-gateway>"

[model_providers."51cowork"]
name = "51cowork"
base_url = "https://api.51cowork.com"
wire_api = "responses"
requires_openai_auth = true

{
  "OPENAI_API_KEY": "<key-from-dashboard>"
}

• 目录不存在时先创建。
• 合并已有 config.toml，不要删除其他 provider 或用户设置。
• 保存后完全退出并重启 CLI 或扩展，再新建会话验证。

OpenCode

将示例保存到 ~/.config/opencode/opencode.json（也可使用 opencode.jsonc）。这是 OpenAI 兼容 provider 示例；模型仍应使用 /v1/models 中的实际 ID。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "51cowork": {
      "npm": "@ai-sdk/openai",
      "name": "51cowork",
      "options": {
        "baseURL": "https://api.51cowork.com/v1",
        "apiKey": "<key-from-dashboard>"
      }
    }
  }
}

Cursor

1. 1打开模型或 API 设置，启用自定义 OpenAI Base URL。
2. 2填写 https://api.51cowork.com/v1 和控制台中的 API Key。
3. 3添加 /v1/models 返回的模型 ID，选择该模型发送测试请求。

Cherry Studio

1. 1打开设置中的模型服务，添加名为 51cowork 的服务商，类型选择 OpenAI。
2. 2API 地址填写网关根地址 https://api.51cowork.com；Cherry Studio 会自动追加 /v1/chat/completions。
3. 3填写控制台中的 API Key，获取模型列表并添加所需模型。
4. 4启用该服务商，在对话中选择模型并发送测试请求。

WorkBuddy

1. 1打开设置中的模型配置，添加自定义模型并选择 Custom。
2. 2接口地址填写完整 URL：https://api.51cowork.com/v1/chat/completions。
3. 3填写控制台中的 API Key，以及 /v1/models 返回的准确模型 ID。
4. 4在高级配置中开启自定义协议，直接使用完整地址，避免自动追加路径。
5. 5保存后在对话中选择该自定义模型，发送测试请求并在控制台核对用量。

更新 Key

1. 1在控制台创建或选择替代 Key。
2. 2把新 Key 更新到所有运行环境或用户级配置。
3. 3完全重启会缓存认证信息的客户端。
4. 4发送最小请求并在用量记录中确认成功。
5. 5确认迁移完成后再删除不再使用的 Key。

配置验收清单

• Gateway 根地址是 https://api.51cowork.com；OpenAI SDK Base URL 是 https://api.51cowork.com/v1。
• Key 没有多余空格、引号或换行。
• 模型 ID 来自当前 /v1/models。
• 客户端使用的协议与目标入口一致。
• 成功请求能在控制台使用记录中找到。