Кратко: эта инструкция нужна, чтобы каждый смог подготовить рабочее пространство для написания кода с помощью ИИ через расширение Claude Code for VS Code и персональный API-ключ.

В отличие от обычного входа через аккаунт Anthropic, здесь расширение будет обращаться к модели через API-ключ. Все параметры подключения задаются один раз в глобальном файле настроек settings.json.

Также может быть полезна инструкция по настройке Kilo Code и официальная документация Use Claude Code in VS Code.

0. Обозначения

Visual Studio Code — это редактор кода.

Claude Code — это расширение для Visual Studio Code от Anthropic. Оно добавляет в редактор ИИ-помощника: он может писать код, работать с файлами и выполнять часть действий по задаче в агентском режиме.

Провайдер (прокси) — это адрес, на который расширение отправляет запросы к модели. В нашем случае это https://litellm.geotech.user.events.

Глобальный файл настроек — это файл settings.json в папке .claude в домашней директории пользователя. В нём хранятся адрес прокси, API-ключ и список моделей. Настройка нужна для того, чтобы Claude Code обращался к нужной модели через выданный API-ключ.

1. Установить Visual Studio Code

Как установить Visual Studio Code, описано в инструкции Как установить Visual Studio Code.

2. Установить расширение Claude Code

Расширение добавляет в Visual Studio Code панель ИИ-помощника.

Шаги

1. В Visual Studio Code откройте раздел Extensions или нажмите Ctrl+Shift+X (Windows/Linux) или Cmd+Shift+X (macOS).

2. В строке поиска введите: Claude Code

3. Выберите расширение Claude Code for VS Code, издатель — Anthropic (идентификатор anthropic.claude-code).

4. Нажмите Install.

5. Дождитесь окончания установки.

6. Если после установки значок Claude Code не появился, перезапустите Visual Studio Code или выполните команду Developer: Reload Window из палитры команд (Ctrl+Shift+P / Cmd+Shift+P).

7. Один раз откройте панель Claude Code: нажмите значок Claude Code (звёздочка) в левой панели Visual Studio Code. Расширение само создаст папку .claude, которая понадобится на следующем шаге. Если появится экран входа в аккаунт — просто закройте его, вход нам не нужен.

3. Заполнить глобальный файл настроек settings.json

Это главный шаг. В файле задаются адрес прокси, API-ключ и модели. Всё делается мышкой внутри Visual Studio Code, терминал не нужен.

Какой путь у файла

• Windows: C:\Users\<Имя пользователя>\.claude\settings.json

• macOS: /Users/<Имя пользователя>/.claude/settings.json

• Linux: /home/<Имя пользователя>/.claude/settings.json

Вместо <Имя пользователя> подставьте своё имя пользователя в системе.

Шаг 1. Открыть файл, если он уже есть

1. В Visual Studio Code откройте меню File → Open File… (Ctrl+O в Windows/Linux, Cmd+O в macOS).

2. В диалоговом окне вставьте полный путь к файлу из списка выше и нажмите Enter.

   • В Windows путь вставляется в поле Имя файла внизу окна.

   • В macOS сначала нажмите Cmd+Shift+G, затем вставьте путь.

3. Если файл открылся — переходите к шагу 3.

4. Если Visual Studio Code пишет, что файл не найден, — это нормально при первой настройке. Закройте диалог и перейдите к шагу 2.

Шаг 2. Создать файл, если его нет

1. Нажмите Ctrl+N (Windows/Linux) или Cmd+N (macOS) — откроется пустой файл.

2. Откройте меню File → Save As… (Ctrl+Shift+S / Cmd+Shift+S).

3. Вставьте в поле имени полный путь к файлу из списка выше, включая .claude\settings.json, и нажмите Save.

Папка .claude скрытая, поэтому в окне сохранения её не видно — но если вставить полный путь целиком, файл сохранится правильно. Если Visual Studio Code сообщит, что папки .claude не существует, вернитесь к пункту 7 предыдущего раздела и один раз откройте панель Claude Code: расширение создаст папку само.

Шаг 3. Вставить настройки

Скопируйте текст ниже, вставьте его в открытый settings.json и сохраните файл (Ctrl+S / Cmd+S):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://litellm.geotech.user.events",
    "ANTHROPIC_AUTH_TOKEN": "ваш-API-ключ"
  },
  "model": "geotech/gemini/gemini-3.7-flash",
  "modelPicker": {
    "options": [
      {
        "model": "geotech/gemini/gemini-3.7-flash",
        "label": "Gemini 3.7 Flash"
      },
      {
        "model": "geotech/zai/glm-5.3-flash",
        "label": "GLM-5.3 Flash"
      },
      {
        "model": "geotech/openai/gpt-5.6-luna",
        "label": "GPT Luna"
      },
      {
        "model": "geotech/gemini/gemini-3.5-flash",
        "label": "Gemini 3.5 Flash"
      },
      {
        "model": "gti-local/Qwen3.8",
        "label": "Qwen3.8 (Local)"
      }
    ]
  },
  "availableModels": [
    "geotech/gemini/gemini-3.7-flash",
    "geotech/zai/glm-5.3-flash",
    "geotech/openai/gpt-5.6-luna",
    "geotech/gemini/gemini-3.5-flash",
    "gti-local/Qwen3.8"
  ],
  "permissions": {
    "allow": [],
    "ask": [],
    "deny": []
  }
}

Обязательно замените текст ваш-API-ключ на выданный вам ключ. Остальное можно оставить как есть.

Что означают поля

ID моделей есть в списке доступных моделей. Суффикс [1m] включает увеличенное окно контекста.

Чтобы добавить ещё одну модель, впишите её и в modelPicker, и в availableModels. ID должен точно совпадать с названием модели на прокси: Claude Code передаёт его как есть и не проверяет заранее, поэтому опечатка проявится только ошибкой при первом запросе.

Важно про формат файла

• файл должен быть строгим JSON: без комментариев (//) и без запятой после последнего элемента. Ошибки Visual Studio Code подчёркивает красным прямо в файле — если подчёркиваний нет, формат в порядке;

• вставляйте API-ключ полностью, без лишних пробелов и переносов строк, кавычки вокруг ключа не удаляйте;

• после вставки обязательно сохраните файл (Ctrl+S / Cmd+S);

• перезапустите Visual Studio Code, чтобы настройки применились.

При необходимости в блок env можно добавить строку "ENABLE_TOOL_SEARCH": "true" — она включает поиск инструментов MCP, который по умолчанию отключён при работе через сторонний прокси.

4. Открыть Claude Code и выбрать модель

Шаги

1. Нажмите значок Claude Code (звёздочка) в левой панели Visual Studio Code (Activity Bar) или в правом верхнем углу редактора при открытом файле.

2. Откроется панель Claude Code.

3. Внизу поля ввода нажмите на название модели — откроется список моделей, заданных в availableModels.

4. Выберите нужную модель:

   • Sonnet — основная рабочая модель, подходит для большинства задач;

   • Opus — для сложных задач, где важна точность; расходует больше токенов;

   • Haiku — самая быстрая и дешёвая, для простых правок;

   • GPT Terra и GPT Luna — модели GPT через прокси geotech, полезны для сравнения ответов.

Модели из modelPicker (GPT Terra, GPT Luna) показываются в списке после встроенных.

В переключателе моделей: клавиша Enter меняет модель и сохраняет её как модель по умолчанию (значение model в settings.json обновится само), клавиша s меняет модель только для текущего чата.

Поэтому значение "model": "sonnet" в примере — это не ограничение, а лишь модель, с которой открывается новый чат. Если чаще нужен Opus, поменяйте эту строку на "model": "opus" или один раз выберите Opus в переключателе через Enter.

5. Проверить, что всё работает

Шаги

1. Откройте панель Claude Code.

2. Напишите простой запрос, например: «Напиши код пузырьковой сортировки на 1С». Отправьте запрос.

3. Если Claude Code ответил — настройка завершена.

6. Если возникла ошибка

Проверьте:

• установлена ли версия Visual Studio Code 1.94.0 или новее;

• установлено ли расширение Claude Code от издателя Anthropic;

• лежит ли файл settings.json именно в папке .claude в домашней директории, а не в настройках самого Visual Studio Code;

• корректен ли JSON в файле: нет комментариев, нет лишней запятой в конце, все скобки закрыты (ошибки видны в самом Visual Studio Code);

• заменён ли текст ваш-API-ключ на реальный ключ, вставлен ли ключ полностью, без пробелов;

• указан ли ANTHROPIC_BASE_URL без /v1 на конце;

• если ошибка возникает только на одной модели — совпадает ли её ID в modelPicker со списком моделей на прокси, и добавлен ли этот ID в availableModels;

• сохранён ли файл и перезапущен ли Visual Studio Code после изменения настроек;

• есть ли подключение к интернету.

Если после проверки ошибка сохраняется, напишите alsu.yarulina@geotech.in.

Важно про API-ключ

API-ключ действует на сотрудника, которому он был выдан. Не передавайте ключ никому и не публикуйте его в чатах, документах или скриншотах. Файл settings.json с ключом хранится только на вашем компьютере — не коммитьте его в репозиторий.

Дата обновления: 7 сентября 2026