canonical_url: https://yycode.net/docs/ru/dragon-code-guide lang: ru updated_at: 2026-07-04T13:33:48.616Z source_html: https://yycode.net/docs/ru/dragon-code-guide # Руководство по использованию yycode --- ## Содержание - [1. Почему появился yycode](#一为什么会有-yycode) - [2. Что это за инструменты](#二这些工具到底是什么) - [3. Что такое терминал](#三什么是终端) - [4. Где работают эти инструменты](#四这些工具运行在哪儿) - [5. Что такое API](#五什么是-api) - [6. Почему многие знают эти инструменты, но не могут нормально ими пользоваться](#六为什么很多人知道这些工具却还是用不好) - [7. Что такое yycode](#七yycode-是什么) - [8. Что делать при ошибках — пошаговая диагностика через Doubao](#八遇到报错怎么办用豆包一步步排查) - [8.6 Проблемы с прокси/VPN — самая частая скрытая ловушка](#86-代理翻墙环境问题最常见的隐形坑) - [8.7 Частые проблемы после установки](#87-安装后常见问题排查) - [9. Начало работы — регистрация и покупка](#九开始使用注册与购买) - [10. Установка и настройка инструментов](#十安装配置工具) - [Шаг 5: скачать CC Switch](#第-5-步下载-cc-switch) - [Шаг 6: установить окружение Node.js](#第-6-步安装-nodejs-环境) - [Шаг 7: открыть CC Switch](#第-7-步打开-cc-switch) - [Шаг 8: настроить CC Switch](#第-8-步配置-cc-switch) - [Шаг 9: установить Codex CLI](#第-9-步安装-codex-cli) - [Шаг 10: установить Claude Code](#第-10-步安装-claude-code) - [11. Руководство для начинающих](#十一入门使用手册) --- ## 1. Почему появился yycode В последние два года все больше людей знакомятся с популярными зарубежными AI-инструментами для программирования, например: - `Codex` от OpenAI - `Claude Code` от Anthropic Их возможности не ограничиваются чатом: они могут напрямую встраиваться в рабочий процесс и помогать с кодом, документацией, сортировкой информации, повторяющимися задачами и другой работой. Но для пользователей в Китае настоящая проблема не в том, «насколько эти инструменты сильные», а в другом: **Многие о них знают, но стабильно пользоваться ими получается далеко не у всех.** Частые трудности: - нужен доступ к зарубежной сети - официальные подписки стоят недешево - есть риски risk control и блокировки аккаунта - возврат и апелляции сложны - API тарифицируется по факту использования, и расходы легко выходят из-под контроля Поэтому многие не то чтобы не хотят пользоваться, а скорее: **Хотят пользоваться, но не хотят платить слишком высокую цену в виде обучения, времени и рисков.** yycode появился именно для решения этой проблемы. --- ## 2. Что это за инструменты ### 2.1 Что такое OpenAI и Anthropic Сейчас в области AI-инструментов для программирования две самые представительные компании: - `OpenAI` - `Anthropic` Инструменты, упомянутые в этом документе, относятся именно к ним. ### 2.2 Что такое ChatGPT и Claude Это наиболее знакомый большинству формат продукта: **диалоговое окно на веб-странице, с которым можно напрямую общаться**. - `ChatGPT` — чат-продукт OpenAI для обычных пользователей - `Claude` — чат-продукт Anthropic для обычных пользователей ### 2.3 Что такое Codex и Claude Code Веб-версии ChatGPT и Claude в основном построены вокруг диалога, а `Codex` и `Claude Code` — это: **AI-помощники, которые могут работать за вас в терминале компьютера.** Они не просто отвечают на вопросы, а глубже участвуют в работе, например: - смотрят код и изменяют файлы - помогают анализировать ошибки - суммируют документы и структурируют материалы - помогают с повторяющимися операциями на компьютере Главное отличие от веб-AI: **Они могут напрямую работать с локальными файлами и терминальной средой: это "рабочие помощники", а не просто "помощники для вопросов и ответов".** --- ## 3. Что такое терминал **Терминал** можно понимать как **окно на компьютере, специально предназначенное для ввода команд**. Обычно он выглядит как черное или темное окно, поэтому многие называют его «черным окошком». В терминале вы в основном вводите текстовые команды, чтобы компьютер выполнял действия, вместо кликов по иконкам и кнопкам. Почему важно объяснить терминал? Потому что: **Claude Code и Codex — это инструменты, которые работают именно в терминале.** ### Как открыть терминал **Windows** - Способ 1: нажмите `Win` → введите `Terminal` → нажмите `Windows Terminal` - Способ 2: нажмите `Win` → введите `PowerShell` → нажмите `Windows PowerShell` - Способ 3: нажмите `Win + R` → введите `cmd` → Enter **Mac** - Способ 1: нажмите `Command + 空格` → введите `Terminal` → Enter - Способ 2: откройте `访达` → `应用程序` → `实用工具` → нажмите `终端` --- ## 4. Где работают эти инструменты **Локальный компьютер + облачный AI-мозг.** - `ваш компьютер`: открывает терминал, принимает команды и показывает результат - `облачная модель`: реально понимает, анализирует и генерирует содержимое Проще говоря: вы вводите инструкции локально, AI обрабатывает их в облаке и возвращает результат в терминал. Поэтому во время использования нужен интернет. --- ## 5. Что такое API Здесь API можно понимать как **канал, через который программа на вашем компьютере вызывает AI-мозг**. - Когда вы общаетесь с Claude на сайте, это **человек напрямую говорит с AI** - API — это **когда программа говорит с AI вместо вас** Терминальные инструменты вроде `Claude Code` и `Codex` по сути тоже через API отправляют ваш запрос модели и возвращают результат. --- ## 6. Почему многие знают эти инструменты, но не могут нормально ими пользоваться ### 6.1 Официальная подписка стоит денег По состоянию на апрель 2026 года официальные подписки стоят от `$20/месяц` (базовая версия) до `$200/месяц` (профессиональная версия). Даже после оплаты не всегда получается пользоваться стабильно и гладко. ### 6.2 При использовании из Китая есть риск risk control и блокировки Большинство прокси-сервисов используют IP дата-центров. Когда сервис-провайдер распознает их как источник высокого риска, могут появиться проблемы со входом, ограничения функций, блокировка аккаунта и т. п. ### 6.3 API гибкий, но расходы легко теряют контроль `100 долларов` при курсе 1:7 примерно равны `700 юаням`. Если пользоваться часто, квота расходуется очень быстро. Для многих новых пользователей легко получить высокие расходы еще до того, как они освоили инструмент. --- ## 7. Что такое yycode Позиционирование yycode: **Решение, которое помогает пользователям использовать возможности этих моделей с более низким порогом входа и более стабильным способом.** Проблемы, которые оно решает: - как снизить порог использования - как уменьшить возню с аккаунтами и сетью - как дать новичкам возможность начать пользоваться терминальными инструментами - как сделать расходы более контролируемыми - как упростить старт для пользователей Windows и Mac **Кому подходит yycode:** - тем, кто хочет попробовать продвинутые AI-инструменты, но не хочет самостоятельно возиться с зарубежными аккаунтами - тем, кто хочет использовать терминальные AI-инструменты на Windows или Mac - тем, кто хочет помощь с кодом, документацией, управлением знаниями и обработкой информации - тем, кто интересуется `Claude Code` и `Codex`, но пока имеет слабую базу - тем, кто хочет сначала запустить рабочий способ, а потом постепенно углубляться > **В одну фразу: yycode — это решение, которое помогает обычным пользователям с низким порогом входа использовать основные AI-терминальные инструменты.** --- ## 8. Что делать при ошибках — пошаговая диагностика через Doubao Во время установки и использования непонятные ошибки — нормальное явление. Не паникуйте: можно использовать **Doubao**, чтобы пошагово разобраться. ### 8.1 Чем Doubao может помочь - **Распознавать изображения**: можно прямо отправить скриншот терминала в Doubao, он поймет сообщение об ошибке - **Пошагово вести диагностику**: если дать правильный prompt, Doubao будет как удаленный помощник говорить, что делать на каждом шаге ### 8.2 Как сделать скриншот **Mac:** нажмите `Command + Shift + 4`, курсор станет крестиком, выделите область ошибки в терминале, отпустите — скриншот автоматически сохранится на рабочий стол. **Windows:** нажмите `Win + Shift + S`, курсор станет крестиком, выделите область ошибки в терминале, скриншот автоматически скопируется в буфер обмена и его можно вставить. ### 8.3 Как задавать вопросы Doubao **Главный принцип: решайте только одну проблему за раз, шаг за шагом, не уходите от цели.** Каждый раз, когда встретите ошибку, откройте в Doubao **новый диалог** и сначала отправьте prompt ниже (замените содержимое в квадратных скобках на свою реальную цель): > Я новичок в командной строке и не понимаю, что означают многие сообщения в терминале. Моя единственная цель: **[ваша цель, например "установить Node.js и убедиться, что он работает" или "установить Claude Code и убедиться, что он работает"]**. Далее я отправлю вам полное сообщение из терминала как есть или пришлю скриншот. Пожалуйста, по моим данным пошагово подскажите, что делать дальше. > > Требования: **не объяснять концепции, не уходить в сторону, только вести меня к цели.** > > 1. Всегда держаться главной цели, не отклоняться. > 2. Не давать сразу много шагов; каждый раз говорить только текущий шаг. > 3. Каждый шаг объяснять словами, понятными новичку, не предполагать, что я понимаю командную строку. > 4. Четко говорить: что сейчас ввести, какую клавишу нажать, какой результат считается нормальным. > 5. Если в терминале появляется ошибка, предупреждение, вопрос выбора или запрос прав, судить по тексту, который я прислал, а не заставлять меня угадывать. > 6. Если шаг успешен, четко сказать "этот шаг завершен, дальше нужно сделать вот что". > 7. Считай себя человеком, который удаленно сопровождает установку: я отправляю вывод терминала или скриншот, ты решаешь следующий шаг, пока цель не будет достигнута. ### 8.4 Что делать после отправки в Doubao 1. **После prompt отправьте скриншот или текст ошибки** — Doubao скажет, что сделать первым шагом. 2. **Сделайте этот шаг и отправьте результат скриншотом обратно** — Doubao оценит, успешно ли, и скажет следующий шаг. 3. **Повторяйте процесс** — пока проблема не решится. ### 8.5 Важные замечания - **Один диалог — одна проблема**: не смешивайте несколько разных вопросов в одном диалоге. - **Не перепрыгивайте шаги**: если Doubao сказал сначала сделать A, делайте A, а не переходите к B. - **Если не понимаете — делайте скриншот**: Doubao умеет распознавать изображения; скриншот точнее ручного копирования и реже теряет детали. - **Не выбирайте в ответе Doubao только понятные вам шаги**: строго следуйте порядку. > **На всех дальнейших шагах, если появится любая ошибка, используйте этот способ диагностики через Doubao.** ### 8.6 Проблемы с прокси/VPN — самая частая скрытая ловушка У многих пользователей установлены инструменты для доступа к зарубежной сети (прокси), например Clash, V2Ray, Shadowsocks, клиенты провайдеров и т. п. Иногда они **незаметно** влияют на сетевую среду терминала, из-за чего при установке или использовании появляются разные странные ошибки. Самое неприятное: **многие не знают, есть ли у них на компьютере прокси, включен ли он и как настроен.** #### Частые симптомы - `npm install` долго висит или сообщает timeout - появляется `ECONNREFUSED` (соединение отклонено) - появляется `ETIMEDOUT` (тайм-аут соединения) - появляется `UNABLE_TO_VERIFY_LEAF_SIGNATURE` или другая SSL / сертификатная ошибка - появляется `CERT_HAS_EXPIRED` или `SELF_SIGNED_CERT_IN_CHAIN` - браузер открывает сайты, но команды в терминале не подключаются #### Почему так происходит Прокси-программы обычно меняют системные настройки сетевого прокси, но терминальные программы (например npm) не всегда автоматически используют этот прокси. В результате: **браузер нормально выходит в интернет, а терминал оказывается запутан настройками прокси.** #### Самая простая быстрая попытка Если вы знаете, что на компьютере есть прокси-программа, попробуйте сначала: 1. **Полностью выйти из прокси-программы** (не свернуть, а правой кнопкой выйти / полностью закрыть) 2. **Закрыть текущее окно терминала и открыть новое** (это важно: переменные окружения в старом окне сами не обновятся) 3. Снова выполнить команду, которая раньше падала Во многих случаях выключение прокси + новый терминал решают проблему. #### Если не уверены, есть ли прокси — попросите Doubao проверить Откройте Doubao, создайте **новый диалог** и отправьте: > Я новичок в командной строке. На моем компьютере может быть установлен VPN / прокси, но я не уверен, установлен ли он и включен ли. Сейчас при выполнении команд в терминале у меня сетевые ошибки (или я хочу перед установкой проверить, чистая ли среда). Пошагово помоги проверить: > > 1. Запущено ли сейчас на моей системе прокси-приложение. > 2. Заданы ли в переменных окружения терминала прокси (HTTP_PROXY, HTTPS_PROXY, ALL_PROXY и т. п.). > 3. Есть ли прокси-настройки в глобальной конфигурации npm. > 4. По результатам скажи, что делать (выключить прокси / очистить остаточные настройки / правильно настроить, чтобы терминал тоже мог использовать прокси). > > Требование: каждый раз давай только один шаг; я выполню и пришлю результат, затем скажешь следующий. Моя система — **[Mac / Windows]**. Дальше просто выполняйте подсказки Doubao шаг за шагом. ### 8.7 Частые проблемы после установки После установки инструментов (Node.js, Codex, Claude Code) при первом использовании тоже могут возникать ошибки. Не паникуйте: у большинства проблем есть стандартный порядок диагностики. Ниже шаблоны prompt для Doubao по типам проблем; копируйте, заменяйте квадратные скобки и отправляйте. #### ① Команда не найдена (command not found / не является внутренней или внешней командой) Вроде только что установили, но терминал говорит, что команда не найдена. Откройте новый диалог Doubao и отправьте: > Я ввожу в терминале **[node / npm / codex / claude]**, но получаю "command not found" (или "не является внутренней или внешней командой"). Я только что устанавливал через npm. Помоги разобраться, почему команда не найдена, по одному шагу; после каждого шага я пришлю результат. Моя система — **[Mac / Windows]**. #### ② Проблемы с правами (Permission denied / EACCES) > При выполнении **[ваша команда]** в терминале появляется ошибка прав (Permission denied или EACCES). Пошагово помоги решить, не заставляя меня делать опасные действия, которые могут повредить систему. Моя система — **[Mac / Windows]**. #### ③ Сетевые проблемы (timeout / ECONNREFUSED / fetch failed) Такие проблемы с высокой вероятностью связаны с прокси. **Сначала проверьте прокси-среду по [разделу 8.6](#86-代理翻墙环境问题最常见的隐形坑).** Если прокси не виноват, отправьте скриншот ошибки Doubao. #### ④ Неверная версия или конфликт версий > Я установил **[название инструмента]**, но при запуске появляется сообщение о несовместимой версии / требуется более высокая версия Node.js. Текущая версия Node.js: **[вставьте вывод node -v]**. Помоги понять, нужно ли обновляться и как обновить. По одному шагу. Моя система — **[Mac / Windows]**. #### ⑤ Другие совершенно непонятные ошибки Просто отправьте скриншот Doubao вместе с текстом: > При **[установке / использовании]** **[название инструмента]** я получил такую ошибку и совершенно не понимаю ее. Помоги определить проблему и пошагово решить. По одному шагу; я выполню и пришлю результат. Моя система — **[Mac / Windows]**. #### Итог | Ключевые слова симптома | Что проверить сначала | |-----------|---------| | timeout / ECONNREFUSED / SSL / сертификат | → сначала прокси (раздел 8.6) | | command not found / не внутренняя команда | → переменные окружения / PATH (①) | | Permission denied / EACCES | → права (②) | | несовместимая версия / engine не подходит | → версия Node.js (④) | | другая непонятная английская ошибка | → скриншот в Doubao (⑤) | --- ## 9. Начало работы — регистрация и покупка Регистрация и покупка не требуют прокси. Рекомендуется открыть веб-версию Doubao или другой AI-модель под рукой (лучше ту, которая распознает изображения). **Официальный сайт: https://yycode/** ### Шаг 1: зарегистрируйте аккаунт Перейдите на https://yycode.net/register и зарегистрируйте аккаунт. Запомните свой email: при проблемах мы используем его для поиска аккаунта. После регистрации и входа откройте dashboard: ![Dashboard после входа](https://r2.yycode.net/yycode/kFc0CIk.png) ### Шаг 2: пополните баланс После регистрации и входа → левая панель «Управление кошельком» → https://yycode.net/console/topup #### Описание цен моделей > Подробные цены: https://yycode.net/pricing Наши цены указаны в китайских юанях (¥), официальные цены отмечены в долларах ($), **курс приблизительно считается 1:7** (фактический курс — по моменту оплаты), единица — миллион tokens. **Как понимать коэффициент? — сколько долларовой модели можно купить за 1 юань** Формула ценообразования yycode: `официальная долларовая цена × коэффициент = цена в юанях` (коэффициент уже включает пересчет курса). Чем ниже коэффициент, тем выше соотношение цены и качества: ### Шаг 3: обновите страницу После обновления страницы сумма справа вверху увеличится. Здесь обязательно добавьте WeChat службы поддержки и войдите в группу послепродажной поддержки. ### Шаг 4: создайте API-ключ Левая панель «Управление токенами» → Добавить токен - Имя можно написать любое, например `yycode` - Выберите группу → в зависимости от инструмента: - Используете **Codex** (инструмент OpenAI) → выберите группу `codex` - Используете **Claude Code** (инструмент Anthropic) → выберите соответствующую группу Claude - Остальное можно не заполнять - Нажмите отправить ![Окно создания ключа](https://r2.yycode.net/yycode/9KXR1Ik.png) > **Пояснение:** если хотите одновременно использовать Codex и Claude Code, нужно создать два отдельных ключа, каждый с соответствующей группой. --- ## 10. Установка и настройка инструментов > ⚠️ **Перед установкой проверьте прокси-среду:** если на компьютере установлены VPN / прокси-программы (Clash, V2Ray, клиенты провайдеров и т. п.), сначала **полностью выйдите из прокси-программы**, затем начинайте шаги ниже. Прокси — самая частая "скрытая ловушка" установки: браузер может выходить в интернет, но терминал не обязательно работает нормально. См. [раздел 8.6](#86-代理翻墙环境问题最常见的隐形坑). Если не уверены, есть ли прокси, также сначала проверьте через Doubao способом из 8.6. ### Шаг 5: скачать CC Switch CC Switch — open-source инструмент для управления и переключения API-поставщиков (автор: farion1231). **Руководство пользователя** (при проблемах можно отправить эту ссылку Doubao для диагностики): https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md **Системные требования:** - **Windows**: Windows 10 и выше - **macOS**: macOS 12 (Monterey) и выше - **Linux**: Ubuntu 22.04+ / Debian 11+ / Fedora 34+ и другие популярные дистрибутивы **Шаги скачивания:** ① Откройте https://github.com/farion1231/cc-switch/tree/main, прокрутите до README: ![① Главная страница репозитория GitHub](https://r2.bozhouai.com/dragoncode/file-20260412220125391.png) ② Нажмите ссылку на китайскую версию вверху README: ![② Нажать ссылку на китайскую версию](https://r2.bozhouai.com/dragoncode/file-20260412220127143.png) ③ Откройте китайскую версию README и нажмите кнопку содержания в правом верхнем углу: ![③ Открыть содержание документа](https://r2.bozhouai.com/dragoncode/file-20260412220129282.png) ④ Введите «скачать и установить» в поиске по содержанию и перейдите: ![④ Найти раздел скачивания и установки](https://r2.bozhouai.com/dragoncode/file-20260412220130559.png) ⑤ Перейдите к разделу скачивания и установки, увидите системные требования и ссылку Releases: ![⑤ Раздел скачивания и установки](https://r2.bozhouai.com/dragoncode/file-20260412220132616.png) --- **Скачивание для Mac:** ⑥ Нажмите Releases и откройте страницу версий; не нажимайте китайскую версию, просто прокрутите вниз: ![⑥ Страница Releases — Mac выбирает .dmg](https://r2.bozhouai.com/dragoncode/file-20260412220134661.png) ⑦ В списке Assets пользователи Mac нажимают файл `.dmg`, на который указывает зеленая стрелка: ![⑦ Список Assets — Mac выбирает .dmg](https://r2.bozhouai.com/dragoncode/file-20260412220135990.png) **Скачивание для Windows:** ⑧ Нажмите «Show all 18 assets», чтобы раскрыть полный список: ![⑧ Раскрыть все Assets](https://r2.bozhouai.com/dragoncode/file-20260412220137937.png) ⑨ После раскрытия пользователи Windows выбирают установочный пакет `Windows.msi`, на который указывает розовая стрелка: ![⑨ Windows выбирает .msi](https://r2.bozhouai.com/dragoncode/file-20260412220138781.png) --- **Установка на Mac:** откройте скачанный dmg и перетащите значок CC Switch в папку Applications: ![⑩ Mac — перетащить в Applications](https://r2.bozhouai.com/dragoncode/file-20260412220140264.png) **Установка на Windows:** дважды щелкните .msi установщик и завершите установку по подсказкам. --- ### Шаг 6: установить окружение Node.js > **Пояснение:** CLI-инструменты, которыми управляет CC Switch (Claude Code, Codex, Gemini CLI), требуют окружение Node.js. При любых проблемах используйте Doubao по [методу из раздела 8](#八遇到报错怎么办用豆包一步步排查), цель укажите: "установить на моем компьютере последнюю LTS-версию Node.js и убедиться, что она работает". **Установка Windows:** Откройте PowerShell (нажмите `Win` → введите `PowerShell` → откройте), скопируйте: ``` winget install OpenJS.NodeJS.LTS ``` Если во время установки появится подтверждение, введите `Y`. Когда терминал перестанет прокручиваться, проверьте: ``` node -v npm -v ``` Если видите два номера версий, установка успешна. Официальный сайт дает полную команду установки Windows: ![Windows — страница загрузки Node.js](https://r2.bozhouai.com/dragoncode/file-20260412220110691.png) **Установка Mac:** Откройте страницу загрузки Node.js, переключите платформу на «macOS» и выполните шаги 1-2-3 на изображении: ![Mac — страница загрузки Node.js](https://r2.bozhouai.com/dragoncode/file-20260412220113359.png) --- ### Шаг 7: открыть CC Switch **Mac:** Откройте Launchpad (сведите четыре пальца на трекпаде или нажмите значок Launchpad в Dock) → найдите CC Switch → дважды щелкните. Если появится «невозможно проверить разработчика»: значок Apple → Системные настройки → Конфиденциальность и безопасность → прокрутить вниз → нажать «Все равно открыть». Если не получается, правый клик по значку → «Открыть» → снова «Открыть». **Windows:** Откройте двойным щелчком. Если появится «Windows защитила ваш компьютер» → нажмите «Подробнее» → «Все равно выполнить» → в запросе прав нажмите «Да». --- ### Шаг 8: настроить CC Switch После открытия, если провайдеры еще не настроены, интерфейс должен быть пустым списком или показывать official; оба варианта — нормальное начальное состояние: ![① Начальный интерфейс CC Switch](https://r2.bozhouai.com/dragoncode/file-20260412220115662.png) Нажмите `+` справа вверху → на странице «Добавить нового провайдера» выберите «**Пользовательская конфигурация**»: ![② Выбрать пользовательскую конфигурацию](https://r2.bozhouai.com/dragoncode/file-20260412220117766.png) Заполните форму (прокрутите, чтобы увидеть все поля): - **Название провайдера**: `yycode` - **Примечание**: можно не заполнять - **API Key**: см. пояснение ниже - **Адрес запроса**: `https://yycode.net` (не ставьте галочку «полный URL») ![③ Заполнить форму данных провайдера](https://r2.bozhouai.com/dragoncode/file-20260412220119516.png) **Получение API Key:** откройте https://yycode.net → левая панель «Управление токенами» → нажмите кнопку копирования, на которую указывает красная стрелка: ![④ Скопировать API-ключ в консоли yycode](https://r2.yycode.net/yycode/EDOv1Ik.png) Вставьте скопированный ключ в поле API Key формы → нажмите «**+ Добавить**» в правом нижнем углу. После добавления провайдер появится в списке. Сначала нажмите синюю кнопку «**Включить**», затем вход проверки справа, на который указывает стрелка. Только когда сверху появится зеленая подсказка, настройка считается успешной. Если ошибка, отправьте ссылку на руководство пользователя CC Switch и скриншот ошибки в Doubao: ![⑤ Список провайдеров — после включения нажать проверку и завершить настройку](https://r2.yycode.net/yycode/9eCCCIk.png) --- ### Шаг 9: установить Codex CLI **Mac:** ```bash sudo npm install -g @openai/codex@latest ``` Проверка: ```bash codex --version ``` Если выводится номер версии, установка успешна. Введите `codex` в терминале и нажмите Enter, чтобы начать использование. **Windows:** ```bash npm install -g @openai/codex@latest ``` Проверка: ```bash codex --version ``` Если есть ошибка, используйте Doubao по [методу из раздела 8](#八遇到报错怎么办用豆包一步步排查); если ошибки нет, введите `codex` и нажмите Enter, чтобы начать. --- ### Шаг 10: установить Claude Code Claude Code — терминальный AI-помощник Anthropic; установка похожа на Codex. **Mac:** ```bash sudo npm install -g @anthropic-ai/claude-code@latest ``` Проверка: ```bash claude --version ``` Если выводится номер версии, установка успешна. Введите `claude` в терминале и нажмите Enter, чтобы начать. **Windows:** ```bash npm install -g @anthropic-ai/claude-code@latest ``` Проверка: ```bash claude --version ``` Если выводится номер версии, установка успешна. Введите `claude` в терминале и нажмите Enter, чтобы начать. > **Внимание:** для использования Claude Code на шаге 4 при создании ключа нужно выбрать соответствующую группу Claude. После включения провайдера CC Switch автоматически управляет API-конфигурацией Claude Code. Если есть ошибка, используйте Doubao по [методу из раздела 8](#八遇到报错怎么办用豆包一步步排查), цель укажите: "установить Claude Code и убедиться, что он работает". --- --- ## 11. Руководство для начинающих После установки и настройки выше нужно запомнить одну фразу: **`CC Switch` отвечает за переключение интерфейсов, а `claude` и `codex` в терминале — настоящие точки входа для работы.** Если вы впервые сталкиваетесь с терминалом, не пытайтесь понять все сразу. Сначала повторите шаги и запустите — это важнее всего. ### 11.1 Подготовка перед первым использованием Каждый раз перед началом проверьте 4 вещи: 1. Откройте `CC Switch` 2. Сверху переключитесь на нужный инструмент (`Claude` или `Codex`) 3. Убедитесь, что соответствующий провайдер «включен», а после проверки сверху появилась зеленая подсказка 4. Откройте терминал и введите соответствующую команду для начала > **Совет:** если `Codex` работает нормально, начинайте с `Codex`. Он обычно быстрее и прямее при диагностике проблем, а общая доступность стабильнее. ### 11.2 Что использовать сначала: Claude или Codex Простой способ выбора: | Сценарий | Рекомендуемый инструмент | |------|---------| | Хотите поговорить, структурировать мысли, спросить «что мне сейчас делать» | `Claude` | | Хотите выполнить задачу, разобраться с проблемой, сразу решить | `Codex` | Если не понимаете, запомните две фразы: **для чата и размышления — `Claude`, для выполнения и обработки — `Codex`**. Если сейчас доступен только `Codex`, используйте `Codex`. Doubao — скорее запасной вариант, когда «инструмент еще не настроен». ### 11.3 Как запустить Claude Code 1. Вверху `CC Switch` нажмите `Claude`, убедитесь, что провайдер включен и проверка успешна 2. Откройте терминал и введите: ```bash claude ``` 3. При первом запуске появится мастер инициализации; обычно можно просто нажимать Enter и использовать варианты по умолчанию После входа в `Claude Code`, если не знаете, что сказать, попробуйте: ```text Какую модель ты сейчас используешь? ``` ```text Я новичок. Какие данные мне стоит предоставить, чтобы ты лучше помог мне достичь цели? ``` ```text Я хочу выполнить [ваша цель]. Какие данные мне нужно предоставить, чтобы ты лучше провел меня шаг за шагом? ``` ### 11.4 Как запустить Codex 1. Вверху `CC Switch` нажмите `Codex`, убедитесь, что провайдер включен и проверка успешна 2. Откройте терминал и введите: ```bash codex ``` 3. При первом запуске появится мастер инициализации; обычно можно просто нажимать Enter и использовать варианты по умолчанию После входа в `Codex CLI` можно сначала попробовать базовые вопросы: ```text Какую модель ты сейчас используешь? ``` ```text Посмотри, что находится в текущей папке ``` ```text Я хочу выполнить [ваша цель], какую информацию мне сначала предоставить? ``` Если интерактивный интерфейс открывается без ошибок, значит инструмент уже можно использовать. ### 11.5 Самые частые операции **1. Переключение модели** В `Claude Code` или `Codex` введите: ```text /model ``` Выберите модель стрелками вверх/вниз и подтвердите Enter. Не уверены, чем отличаются модели? Спросите AI напрямую: ```text Для чего подходят эти модели? Какая лучше для моей текущей задачи? ``` **2. Переключение узла** Если при использовании постоянно зависает, появляются ошибки или внезапно недоступно, **нужно переключить узел (линию) на официальном сайте**. > **Важно различать:** `/model` в инструменте переключает **тип модели**; на официальном сайте переключается **узел/линия**. Это разные вещи. > > - Хотите сменить возможности модели → используйте `/model` > - Хотите решить лаги и нестабильность → переключайте узел на сайте **Конкретные шаги:** ① Откройте сайт → левая панель «Управление токенами» → нажмите редактировать → выберите новую группу. ![Переключение узла/линии на сайте](https://r2.yycode.net/yycode/YqOcCIk.png) ② В появившемся списке выберите доступный узел. ![Выбор доступного узла](https://r2.yycode.net/yycode/AeUcCIk.png) ③ После переключения подтвердите вступление в силу в таком порядке: 1. Обновите страницу сайта 2. Вернитесь в `CC Switch` 3. Повторно выполните проверку и убедитесь, что провайдер снова нормальный 4. Нажмите синюю кнопку «Включить» 5. Вернитесь в терминал и проверьте доступность Если нестабильность продолжается, уточните в группе участников, не является ли это общей проблемой. **3. Диалог стал слишком хаотичным — как структурировать** **Если модель начинает говорить бессмыслицу**, попробуйте по порядку: 1. Введите `/compact` — сжать текущий диалог, подходит, когда «контент немного хаотичен, но хочется продолжить» 2. Введите `/clear` — очистить текущий диалог, подходит, когда «тема ушла в сторону и хочется начать заново» **Если хотите полностью открыть новый диалог:** - **Mac**: `Command + N` - **Windows**: `Ctrl + N` **4. Посмотреть историю сессий** Прошлые диалоги можно найти в управлении сессиями `CC Switch`. Нажмите вход в управление сессиями в правом верхнем углу `CC Switch` (место, на которое указывает стрелка): ![Вход в управление сессиями CC Switch справа вверху](https://r2.yycode.net/yycode/Y1VDCIk.png) После входа: 1. Можно фильтровать по типу инструмента (например, только `Codex` или `Claude Code`) 2. Нажмите прошлую сессию слева, чтобы посмотреть историю диалога 3. Если нужно продолжить прошлое содержимое, нажмите кнопку «Копировать», затем вставьте команду в терминал и запустите ![Фильтрация инструмента и восстановление сессии в управлении сессиями](https://r2.yycode.net/yycode/phZDCIk.png) **5. Что делать при ошибочном действии** Сначала не спешите закрывать окно: - сначала попробуйте `Esc` - если не помогает, попробуйте `Ctrl + C` **6. Кажется, что ничего не происходит — это зависло?** При выполнении крупных задач интерфейс может выглядеть как «зависший». Не спешите считать его мертвым. Нажмите `Ctrl + O`, чтобы посмотреть фоновый вывод, подождите около 10 секунд и проверьте, обновляется ли содержимое. После проверки снова нажмите `Ctrl + O`, чтобы вернуться в исходное состояние диалога. ### 11.6 Как отправлять AI файлы и изображения Если хотите, чтобы AI посмотрел файл или изображение, не нужно вручную вводить полный путь. Самый простой способ: 1. Найдите нужный файл в файловом менеджере 2. Скопируйте файл 3. Вернитесь в окно терминального диалога и вставьте > **Подсказка:** если при вводе вы заметили, что курсор можно двигать только в конец, а нужно исправить начало — для новичка проще удалить ошибочную часть и ввести заново или просто переформулировать требование. ### 11.7 Как задавать вопросы эффективнее Проблема многих новичков не в том, что они не умеют пользоваться, а в том, что **не знают, как начать говорить**. Рекомендуется запомнить фразу: ```text Я хочу выполнить [ваша цель]. Какие данные мне нужно предоставить, чтобы ты помог мне лучше выполнить ее? ``` Плюс этой фразы: вам не нужно заранее продумывать все детали; достаточно назвать цель, а AI сам спросит нужную информацию. Также можно сказать: ```text Я новичок, веди меня пошагово и не говори слишком много за один раз. ``` ### 11.8 Что делать при красном тексте Если во время использования видите большой блок красного текста, обычно это ошибка. Не паникуйте и не закрывайте окно первым делом. Действуйте по приоритету: 1. Сделайте скриншот или скопируйте полный текст ошибки 2. Отправьте в текущий рабочий инструмент (`Codex` или `Claude`) и продолжайте спрашивать 3. Если оба неудобны, отправьте в Doubao > Если доступен `Codex`, сначала спрашивайте `Codex` — он обычно прямее в диагностике проблем. ### 11.9 Новичку достаточно запомнить эти 8 фраз 1. `claude` запускает Claude Code, `codex` запускает Codex 2. При первом запуске появляется мастер; обычно можно просто нажимать Enter 3. Сначала используйте `Codex` 4. Для чата и структурирования мыслей используйте `Claude` 5. Для выполнения и диагностики используйте `Codex` 6. Для переключения модели введите `/model`; для переключения узла сайта идите на официальный сайт 7. Если диалог хаотичен, сначала `/compact`, потом `/clear` 8. При ошибочном действии не закрывайте окно: сначала попробуйте `Esc` или `Ctrl + C` ### 11.10 Как смотреть детализацию Token Когда вы впервые видите слова `Token`, `входной Token`, `выходной Token`, `попадание в кеш`, это может сбивать с толку. На самом деле все просто. **Token — это "маленькая единица текста", по которой AI считает стоимость.** То, что вы отправляете, и то, что он отвечает, переводится в Token. ![Объяснение детализации Token](https://r2.yycode.net/yycode/DE8ECIk.png) | Термин | Значение | |------|------| | **Входной Token** | Содержимое, которое вы отправляете AI | | **Выходной Token** | Содержимое, которое AI возвращает вам | | **Попадание в кеш (создание кеша)** | Система повторно использовала ранее обработанное содержимое; эта часть экономит Token | | **Общий Token** | Сколько Token всего потратил текущий запрос | **Аналогия с поездкой на такси:** | Такси | Token | |------|-------| | Сколько требований вы сказали перед посадкой | Входной Token | | Сколько обратной связи и маршрута дал водитель | Выходной Token | | Этот маршрут уже проходили, системе не нужно считать заново | Попадание в кеш | | Сколько всего километров прошла поездка | Общий Token | Стоимость считается по этим «километрам». Проще говоря: - чем длиннее вы отправляете, тем выше входной Token - чем длиннее отвечает AI, тем выше выходной Token - чем больше попаданий в кеш, тем больше экономия Token и денег - при нескольких длинных раундах подряд общий Token будет постоянно накапливаться **В одну фразу: чем больше используете, чем длиннее говорите и чем длиннее ответ, тем выше Token и тем выше стоимость.** Несколько коротких повседневных вопросов — не повод сильно нервничать; но если постоянно заставлять AI выдавать длинные тексты, многократно переделывать и передавать большой объем контента, расходы станут заметнее. --- > **Есть проблема?** Отправьте скриншот ошибки в Doubao и разбирайте пошагово по [разделу 8](#八遇到报错怎么办用豆包一步步排查). Также можно обратиться к руководству пользователя CC Switch: > https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md --- > Информация в этом документе актуальна на **12 апреля 2026 года** и может обновляться. При вопросах добавьте службу поддержки