51cowork APIДокументация
Открыть навигацию

Client guides

Настройка AI-инструментов

Эти конфигурации используют текущий публичный шлюз https://api.51cowork.com. Key и модели берутся из панели управления; перед сохранением проверьте права файла и Git.

Краткий ответ

Для CLI используйте переменные среды или пользовательские файлы. В Cursor, Cherry Studio и WorkBuddy укажите адрес, API Key и ID модели в настройках. Не сохраняйте ключи в Git.

Claude Code
Переменные Anthropic
Codex
config.toml + auth.json
OpenCode
opencode.json
Cursor
OpenAI Base URL
Cherry Studio
Свой провайдер
WorkBuddy
Своя модель
01

Перед началом

  1. 1Создайте или откройте текущий Key в панели управления.
  2. 2Используйте https://api.51cowork.com и выберите модель через https://api.51cowork.com/v1/models.
  3. 3Сделайте резервную копию конфигурации и объединяйте, а не перезаписывайте provider.
  4. 4CLI проверяйте во временной shell-сессии. В настольном клиенте сохраните настройки, выберите модель и отправьте тестовый запрос.
02

Claude Code

Claude Code использует корень Gateway и ANTHROPIC_AUTH_TOKEN.

macOS / Linux · Terminalbash
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
Windows · PowerShellpowershell
$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.

~/.claude/settings.jsonjson
{
  "$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"
  }
}
03

Codex CLI / Extension

Codex использует Responses wire API.

Добавьте provider в ~/.codex/config.toml; в Windows — %USERPROFILE%\.codex\config.toml. Подставьте модель из текущего шлюза.

~/.codex/config.tomltoml
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
~/.codex/auth.jsonjson
{
  "OPENAI_API_KEY": "<key-from-dashboard>"
}
  • Создайте каталог, если его нет.
  • Не удаляйте другие provider и пользовательские настройки.
  • Полностью перезапустите CLI или расширение и создайте новую задачу.
04

OpenCode

Сохраните OpenAI-совместимый provider в ~/.config/opencode/opencode.json или opencode.jsonc. Используйте реальный ID модели из /v1/models.

~/.config/opencode/opencode.jsonjson
{
  "$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>"
      }
    }
  }
}
05

Cursor

  1. 1Откройте настройки моделей или API и включите свой OpenAI Base URL.
  2. 2Укажите https://api.51cowork.com/v1 и API Key из панели управления.
  3. 3Добавьте ID модели из /v1/models, выберите её и отправьте тестовый запрос.
06

Cherry Studio

  1. 1В настройках откройте сервисы моделей и добавьте провайдера 51cowork типа OpenAI.
  2. 2В поле API Address укажите корень шлюза https://api.51cowork.com; Cherry Studio автоматически добавит /v1/chat/completions.
  3. 3Введите API Key из панели управления, загрузите список моделей и добавьте нужные.
  4. 4Включите провайдера, выберите модель в чате и отправьте тестовый запрос.
07

WorkBuddy

  1. 1В настройках моделей добавьте свою модель и выберите Custom.
  2. 2Укажите полный URL: https://api.51cowork.com/v1/chat/completions.
  3. 3Введите API Key из панели управления и точный ID модели из /v1/models.
  4. 4В расширенных настройках включите Custom Protocol, чтобы использовать полный URL без добавления пути.
  5. 5Сохраните настройки, выберите модель в чате, отправьте запрос и проверьте Usage в панели управления.
08

Обновление Key

  1. 1Создайте или выберите новый Key в панели управления.
  2. 2Обновите Key во всех средах и пользовательских файлах.
  3. 3Полностью перезапустите клиенты, кэширующие авторизацию.
  4. 4Отправьте минимальный запрос и найдите его в Usage.
  5. 5Удаляйте старый Key только после завершения перехода.
09

Проверка конфигурации

  • Корень Gateway: https://api.51cowork.com; Base URL OpenAI SDK: https://api.51cowork.com/v1.
  • В ключе нет лишних пробелов, кавычек или переносов.
  • ID модели получен из /v1/models.
  • Протокол клиента соответствует endpoint.
  • Успешный запрос появился в Usage панели управления.