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
- Своя модель
Перед началом
- 1Создайте или откройте текущий Key в панели управления.
- 2Используйте https://api.51cowork.com и выберите модель через https://api.51cowork.com/v1/models.
- 3Сделайте резервную копию конфигурации и объединяйте, а не перезаписывайте provider.
- 4CLI проверяйте во временной shell-сессии. В настольном клиенте сохраните настройки, выберите модель и отправьте тестовый запрос.
Claude Code
Claude Code использует корень Gateway и ANTHROPIC_AUTH_TOKEN.
bashexport 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
claudepowershell$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.
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. Подставьте модель из текущего шлюза.
tomlmodel_provider = "51cowork"
model = "<model-from-gateway>"
[model_providers."51cowork"]
name = "51cowork"
base_url = "https://api.51cowork.com"
wire_api = "responses"
requires_openai_auth = truejson{
"OPENAI_API_KEY": "<key-from-dashboard>"
}- Создайте каталог, если его нет.
- Не удаляйте другие provider и пользовательские настройки.
- Полностью перезапустите CLI или расширение и создайте новую задачу.
OpenCode
Сохраните OpenAI-совместимый provider в ~/.config/opencode/opencode.json или opencode.jsonc. Используйте реальный ID модели из /v1/models.
json{
"$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Откройте настройки моделей или API и включите свой OpenAI Base URL.
- 2Укажите https://api.51cowork.com/v1 и API Key из панели управления.
- 3Добавьте ID модели из /v1/models, выберите её и отправьте тестовый запрос.
Cherry Studio
- 1В настройках откройте сервисы моделей и добавьте провайдера 51cowork типа OpenAI.
- 2В поле API Address укажите корень шлюза https://api.51cowork.com; Cherry Studio автоматически добавит /v1/chat/completions.
- 3Введите API Key из панели управления, загрузите список моделей и добавьте нужные.
- 4Включите провайдера, выберите модель в чате и отправьте тестовый запрос.
WorkBuddy
- 1В настройках моделей добавьте свою модель и выберите Custom.
- 2Укажите полный URL: https://api.51cowork.com/v1/chat/completions.
- 3Введите API Key из панели управления и точный ID модели из /v1/models.
- 4В расширенных настройках включите Custom Protocol, чтобы использовать полный URL без добавления пути.
- 5Сохраните настройки, выберите модель в чате, отправьте запрос и проверьте Usage в панели управления.
Обновление Key
- 1Создайте или выберите новый Key в панели управления.
- 2Обновите Key во всех средах и пользовательских файлах.
- 3Полностью перезапустите клиенты, кэширующие авторизацию.
- 4Отправьте минимальный запрос и найдите его в Usage.
- 5Удаляйте старый Key только после завершения перехода.
Проверка конфигурации
- Корень Gateway: https://api.51cowork.com; Base URL OpenAI SDK: https://api.51cowork.com/v1.
- В ключе нет лишних пробелов, кавычек или переносов.
- ID модели получен из /v1/models.
- Протокол клиента соответствует endpoint.
- Успешный запрос появился в Usage панели управления.
