VS Code: что это и зачем не-программисту

Смотри. Ты поставил ИИ-агента, открыл инструкцию — а там с первой строчки: «открой папку проекта», «запусти в терминале». И всё, приехали. Что за папка, какой терминал, где это вообще открывается.

Окно, в котором всё это происходит, называется VS Code. Оно не про программирование. Оно про то, чтобы видеть свои файлы и дать агенту место, где он будет работать.

Разберём по шагам: что это за программа, как поставить её из России (тут отдельная засада), как включить русский, как открыть папку проекта, где терминал и как посадить туда агента. Всё проверял руками 18 августа 2026 года, версия 1.130. Скриншоты с мака — где на Windows иначе, говорю перед картинкой.

Что такое VS Code простыми словами (и что он НЕ делает)

VS Code — бесплатная программа от Microsoft. Читается «ви-эс код», полное название — Visual Studio Code.

Думай так: это Word, только не для текста, а для файлов проекта. Открыл папку — видишь всё, что внутри. Кликнул на файл — читаешь и правишь.

Теперь главное — чего он НЕ делает. Не пишет код. Не думает за тебя. Это окно, а не работник. Работник — агент, которого ты в это окно посадишь.

Зачем оно не-программисту? Агент работает не «где-то в облаке», а в конкретной папке на твоём компьютере. Чтобы дать ему эту папку и видеть, что он там наделал, нужно окно. Вот оно. А чем чат отличается от агента — разобрано отдельно: чем чат отличается от редактора и от агента.

Всё окно — это четыре зоны. Больше про интерфейс знать не надо.

• Узкая полоска иконок слева. Переключает панели: файлы, поиск, расширения.
• Панель рядом с ней. Файлы той папки, которую ты открыл.
• Середина. Сам файл.
• Низ. Терминал и служебные сообщения. Пока не откроешь — его не видно.

VS Code и Visual Studio — это разные программы

Названия почти одинаковые, программы разные — путаются на этом постоянно.

Visual Studio — тяжёлая среда для профессиональной разработки, гигабайты на диске. Visual Studio Code — лёгкий редактор, пара сотен мегабайт. Тебе нужен второй.

Проверка простая: увидел «Visual Studio 2022» — ты не туда попал. Тебе нужно то, где в названии есть слово Code.

Как установить VS Code на Windows и на Mac

Здесь и застревают на первом шаге.

**Официальный сайт code.visualstudio.com из России не открывается.** Проверял 18 августа 2026 дважды, из командной строки и из обычного браузера на российском интернете: страница не грузится. Соседний ya.ru в том же браузере открылся мгновенно — дело не в твоём интернете.

Хорошая новость: сам файл лежит не на сайте, а на сервере загрузок Microsoft, и он из России качается без всякого VPN. Вот прямые ссылки, каждая проверена и отдаёт настоящий файл:

• Windows: VSCodeUserSetup-x64-1.130.0.exe — примерно 250 МБ
• Mac на процессоре Apple (M1 и новее): VSCode-darwin-arm64.zip — примерно 330 МБ
• Mac на Intel (старые модели): VSCode-darwin.zip — примерно 340 МБ

Дальше обычная установка: на Windows запускаешь файл и проходишь мастер, на маке распаковываешь архив и перетаскиваешь программу в «Программы».

И честно, без сказок. Ссылки привязаны к версии 1.130.0, актуальной в день выхода урока; слово «latest» вместо неё сервер не принимает. Сервер обновлений из России тоже не открывается, так что новая версия сама не приедет: понадобится свежая — включаешь VPN или ищешь зеркало.

Ставят ещё через магазин приложений Windows — этот путь я из России не проверял, обещать не буду.

Как включить русский язык

Первое, что стоит сделать после установки: английский интерфейс на старте отнимает больше сил, чем кажется.

Открой панель расширений: Ctrl+Shift+X на Windows, Cmd+Shift+X на маке. Набери в поиске «Russian» и поставь Russian Language Pack — тот, что от Microsoft.

После установки VS Code сам предложит перезапустить окно. Соглашайся: без перезапуска язык не переключится.

Не предложил перезапуск — нажми Ctrl+Shift+P (Cmd+Shift+P на маке), набери Configure Display Language и выбери русский.

Часть надписей останется английской: свой интерфейс расширения переводят сами, и большинство этого не делает. Это не поломка.

Дальше на скриншотах интерфейс уже русский — я включил перевод прямо по ходу. А пункты меню в тексте называю по-английски: так они выглядят у тех, кто русский не ставил. Держи пару рядом: File — «Файл», Terminal — «Терминал», Settings — «Параметры».

Как открыть папку проекта — главное действие во всём уроке

Если запомнишь из урока один шаг, пусть это будет этот.

На Windows пункт называется File → Open Folder…, сочетание — Ctrl+K, затем Ctrl+O. На маке тот же пункт называется просто File → Open…, сочетание Cmd+O. Названия разные, действие одно.

Выбирай папку целиком, а не отдельный файл. Это принципиально: агент видит то, что лежит внутри открытой папки, и не видит остального. Открыл один файл — агент работает вслепую.

Слева появится дерево файлов — это и есть твой проект. Панель прячется и возвращается по Ctrl+Shift+E (Cmd+Shift+E на маке).

Привычка, которая экономит нервы: одна задача — одна папка. Не сваливай всё в «Загрузки». А когда файлов много, ищи не глазами, а поиском по всей папке.

Где здесь терминал и зачем он тебе

Терминал — то самое чёрное окно, которое пугает новичков. В VS Code он встроен и открывается внизу, под файлами: меню Terminal → New Terminal или сочетание ` Ctrl+ ` — клавиша с буквой Ё. На маке тут **тоже** Ctrl, а не Cmd`.

Прежде чем смотреть на картинку. На Windows в терминале будет строчка вида PS C:\Users\Имя\проект>, на маке — название папки и знак %. Выглядит по-разному, работает одинаково: если у тебя не как в кадре, всё в порядке.

Польза вот в чём: терминал открывается сразу внутри твоей папки. Никуда переходить не надо, команду вставляешь прямо здесь.

Хочешь запускать агента из терминала — установка разобрана по шагам отдельно: поставить Claude Code в терминал по шагам.

Расширения: что это и какие нужны не-программисту

Расширение — маленькая программа внутри редактора. Русский язык, который ты поставил, — тоже расширение. Магазин встроен в окно, ходить никуда не нужно.

И вот парадокс: сайт VS Code из России не открывается, а магазин расширений работает. Проверял 18 августа 2026 — расширение по имени ставится, без VPN.

Не-программисту нужны из магазина две вещи: русский язык и ИИ-агент. Остальное — под конкретную задачу, когда она появится. Не набирай впрок: через неделю не вспомнишь, что откуда взялось.

Как в VS Code живёт ИИ-агент: Claude Code и Codex

Ради этого всё и затевалось.

Открой панель расширений (Ctrl+Shift+X на Windows, Cmd+Shift+X на маке), набери «Claude Code» и поставь расширение от Anthropic.

Что знать до установки:

• Нужен VS Code 1.94 или новее — в той, что ты скачал, 1.130, с запасом.
• Вход по платной подписке Claude. API-ключ не нужен, достаточно войти в аккаунт.
• Отдельно ставить агента не надо: расширение несёт свою копию внутри. Отдельная установка нужна, только если запускать его из терминала.

Агент открывается панелью сбоку: слева файлы, справа разговор. Пишешь задачу словами — он читает файлы и правит их.

Разница с чатом в браузере: там ответ остаётся в окне, здесь агент правит файлы на диске по-настоящему. Поэтому и важно, какую папку ты открыл.

У OpenAI своё расширение с тем же смыслом: что такое Codex и какие у него лимиты. А если ещё выбираешь, где работать — в браузере, в приложении или здесь: чат, Cowork и Code — три способа работать с Claude.

Пять настроек, которые стоит сделать сразу

1. Автосохранение. Настройки — Ctrl+, на Windows, Cmd+, на маке. В поиске набери Auto Save, поставь afterDelay: файл сохранится сам, вскоре после того как перестал печатать.

Это не про удобство. Агент читает файлы с диска: пока не сохранил, он смотрит на старую версию. Отсюда девять из десяти «почему он не видит мои правки».

2. Палитра команд. Ctrl+Shift+P на Windows, Cmd+Shift+P на маке. Окно, где есть всё, что редактор умеет: набираешь слово — видишь команды. Не помнишь, где кнопка, — иди сюда.

3. Тема. Ctrl+K, затем Ctrl+T на Windows; Cmd+K, затем Cmd+T на маке. Тёмная, светлая — бери ту, от которой глаза к вечеру не устают.

4. Шесть сочетаний, которые реально пригодятся. Остальные — потом.

• Файлы проекта: Ctrl+Shift+E / Cmd+Shift+E
• Поиск по папке: Ctrl+Shift+F / Cmd+Shift+F
• Расширения: Ctrl+Shift+X / Cmd+Shift+X
• Терминал: ` Ctrl+ ` (на маке тоже Ctrl`)
• Палитра команд: Ctrl+Shift+P / Cmd+Shift+P
• Сохранить: Ctrl+S / Cmd+S

5. Всё остальное не трогай. В настройках тысячи пунктов, и почти все не про тебя. Полезешь настраивать всё на старте — потратишь вечер и сломаешь то, что работало.

Если что-то пошло не так

• Сайт не открывается. Это не у тебя интернет сломался — бери прямые ссылки из раздела про установку.
• Поставил, а всё на английском. Языковому пакету нужен перезапуск окна. Перезапустил, а язык прежний — Ctrl+Shift+P / Cmd+Shift+P, команда Configure Display Language.
• Агент не видит файлы или правит не то. Почти всегда открыта не та папка: открой нужную и проверь, что слева в дереве твой проект. Второе по частоте — файл не сохранён (Ctrl+S / Cmd+S и включи автосохранение).
• Случайно закрыл панель с файлами. Ctrl+Shift+E / Cmd+Shift+E. Тут вообще ничего нельзя сломать необратимо: любая панель возвращается одним сочетанием.

Что дальше

Не дочитывай — открой. Скачай файл, поставь, включи русский, открой любую свою папку. Двадцать минут, и страх «там всё сложно» проходит сам.

Потом поставь агента и дай ему мелкую задачу: пусть посмотрит, что лежит в папке, и расскажет словами. Действует лучше любой теории.

А хочется системно, а не наощупь — есть курс по Claude Code для не-программистов.

Погнали. Руками потрогать всегда быстрее, чем читать про это.