Youyun API Youyun API Документы

Инструмент автоматической настройки YYCode

Эта статья решает одну задачу: одной командой установить Claude Code или Codex и подключить их к YYCode. Даже если на вашем компьютере еще нет Node.js, можно продолжать настройку.

1. Создайте API Key

Во время выполнения скрипт попросит ввести API Key, поэтому заранее создайте его в консоли YYCode.

Войдите в консоль YYCode, откройте страницу Управление токенами и нажмите Добавить токен.


Заполните имя ключа и выберите группу в зависимости от инструмента:

  • Настройка Claude Code: выберите группу, связанную с Claude
  • Настройка Codex: выберите группу codex
  • Настройка обоих инструментов: нужно создать два отдельных Key, каждый для соответствующей группы выше

IP-белый список, лимит квоты, ограничение моделей и срок действия можно настроить по необходимости. Новичкам рекомендуется использовать настройки по умолчанию.

После создания нажмите в списке кнопку Копировать рядом с ключом, чтобы получить полный API Key, и позже вставьте его в интерактивном вводе скрипта.

Совет по безопасности: API Key эквивалентен учетным данным аккаунта. Храните его бережно, не отправляйте в репозиторий кода и не публикуйте.

2. Рекомендуемое использование

macOS / Linux

Выполните напрямую:

curl -fsSL https://yycode.net/auto-config/install.sh | bash

Скрипт автоматически выполнит следующие действия:

  • Проверит, есть ли в текущей системе доступный Node.js
  • Если нет, установит локальный runtime Node.js в каталог текущего пользователя
  • Переключит зеркало npm на китайский источник, чтобы снизить вероятность сбоя загрузки без прокси
  • Установит Claude Code и Codex
  • Запишет соответствующие конфигурационные файлы
  • В конце выполнит проверку версий, чтобы убедиться, что команды запускаются

Windows PowerShell

Выполните напрямую:

irm https://yycode.net/auto-config/install.ps1 | iex

3. Часто используемые параметры

Если нужен полностью неинтерактивный запуск, можно сразу указать параметры в команде.

Внимание: Claude Code и Codex используют разные API Key. При настройке all нужно отдельно предоставить два Key.

Настроить только Claude Code

macOS / Linux:

curl -fsSL https://yycode.net/auto-config/install.sh | bash -s -- --api-key YOUR_CLAUDE_KEY --tools claude

Windows PowerShell (передача параметров в режиме pipeline через переменные окружения):

$env:YYCODE_CLAUDE_API_KEY='YOUR_CLAUDE_KEY'; $env:YYCODE_TOOLS='claude'; irm https://yycode.net/auto-config/install.ps1 | iex

Windows PowerShell (скачать и выполнить напрямую):

.\install.ps1 --api-key YOUR_CLAUDE_KEY --tools claude

Настроить только Codex

macOS / Linux:

curl -fsSL https://yycode.net/auto-config/install.sh | bash -s -- --codex-api-key YOUR_CODEX_KEY --tools codex

Windows PowerShell (pipeline-режим):

$env:YYCODE_CODEX_API_KEY='YOUR_CODEX_KEY'; $env:YYCODE_TOOLS='codex'; irm https://yycode.net/auto-config/install.ps1 | iex

Windows PowerShell (скачать и выполнить напрямую):

.\install.ps1 --codex-api-key YOUR_CODEX_KEY --tools codex

Настроить Claude Code и Codex одновременно

macOS / Linux:

curl -fsSL https://yycode.net/auto-config/install.sh | bash -s -- --api-key YOUR_CLAUDE_KEY --codex-api-key YOUR_CODEX_KEY

Windows PowerShell (pipeline-режим):

$env:YYCODE_CLAUDE_API_KEY='YOUR_CLAUDE_KEY'; $env:YYCODE_CODEX_API_KEY='YOUR_CODEX_KEY'; irm https://yycode.net/auto-config/install.ps1 | iex

Windows PowerShell (скачать и выполнить напрямую):

.\install.ps1 --api-key YOUR_CLAUDE_KEY --codex-api-key YOUR_CODEX_KEY

Пользовательский API-адрес

Если вы развернули собственный домен, можно переопределить адрес по умолчанию:

curl -fsSL https://yycode.net/auto-config/install.sh | bash -s -- --api-key YOUR_CLAUDE_KEY --base-url https://your-domain.example.com

4. Какие файлы записывает скрипт

Claude Code

Скрипт запишет:

~/.claude/settings.json

Ключевые поля:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://yycode.net",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}

Codex

Скрипт запишет:

~/.codex/auth.json
~/.codex/config.toml

auth.json:

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

config.toml:

model_provider = "yycode"
model = "gpt-5.5"
network_access = "enabled"

[model_providers.yycode]
name = "yycode"
base_url = "https://yycode.net/v1"
wire_api = "responses"
requires_openai_auth = true

5. Нужны ли права администратора?

По умолчанию не нужны.

Скрипт в первую очередь использует уже установленный системный Node.js; если его нет, он устанавливает Node.js в каталог текущего пользователя:

  • macOS / Linux: ~/.yycode/node
  • Windows: %USERPROFILE%\.yycode\node

Клиентские пакеты также устанавливаются в каталог текущего пользователя, а не глобально в систему.

6. Что сделать после первого запуска

macOS / Linux

После завершения скрипта рекомендуется выполнить:

source ~/.zshrc

Если вы используете не zsh, выполните source для фактического profile-файла, который скрипт вывел в конце.

Windows

Достаточно заново открыть окно PowerShell.

7. Как убедиться, что все успешно

Claude Code

claude --version

Codex

codex --version

Если команда выводит номер версии, обычно это означает, что цепочка установки уже работает.

8. Резервные копии и откат

Если на вашем компьютере уже есть старая конфигурация, скрипт перед первым перезаписыванием автоматически создаст резервную копию .bak, например:

  • ~/.claude/settings.json.bak
  • ~/.codex/auth.json.bak
  • ~/.codex/config.toml.bak

Если нужен откат, просто восстановите соответствующий файл .bak.

9. Частые вопросы

В Windows появляется сообщение, что нужен git-bash

Claude Code в Windows зависит от git-bash. Скрипт автоматически проверит и установит Git for Windows (с приоритетной загрузкой с китайского зеркала npmmirror), вручную ничего делать не нужно.

Как передавать параметры в pipeline-режиме Windows (irm | iex)

После irm ... | iex нельзя напрямую добавлять параметры. Их нужно передавать через переменные окружения:

$env:YYCODE_TOOLS='claude'; $env:YYCODE_CLAUDE_API_KEY='YOUR_KEY'; irm https://yycode.net/auto-config/install.ps1 | iex

Если переменные окружения не переданы, скрипт интерактивно попросит ввести API Key.

Если нет прокси, скрипт сможет работать?

По умолчанию скрипт сначала использует китайские зеркала:

  • Node.js сначала скачивается с npmmirror
  • npm registry по умолчанию переключается на https://registry.npmmirror.com

Если зеркало не сработает, скрипт попробует официальный источник.

Я хочу только записать конфигурацию, без установки клиента

Можно добавить:

--skip-client-install

Подходит, если у вас уже установлен claude или codex, и нужно только заново записать конфигурационные файлы.

API-адрес не https://yycode.net

Используйте --base-url, чтобы переопределить адрес.

Что делать, если старая конфигурация была перезаписана?

Сначала проверьте файлы резервных копий .bak в том же каталоге. Первая версия скрипта уже оставляет путь отката для перезаписи конфигурации.

10. Следующий шаг

Вся страница скопирована