Интерфейс командной строки долгое время оставался священной территорией классических утилит: grep, find, git и bash-скрипты десятилетиями служили главным арсеналом разработчика. Но появление официального терминального агента Claude Code от компании Anthropic полностью перевернуло работу в консоли. Теперь нейросеть не просто подсказывает флаги команд, а сама изучает архитектуру репозитория, правит код по месту, прогоняет компиляторы и локализует ошибки в логах.
Однако если запустить Claude Code в вакууме, ты быстро упрешься в ограничение: терминальный процесс закрывается, и агент забывает общие договоренности команды. Чтобы превратить CLI-инструмент в устойчивую персональную операционную среду (Agent OS), его связывают с локальной базой знаний в Obsidian, представленной в виде трехмерного графа заметок. Давай разберем, как устроен этот тандем и как настроить его за семь понятных шагов.
От изоляции CLI к полноценной операционной среде
Обычный диалог с моделью в веб-интерфейсе заставляет тебя вручную копировать фрагменты файлов, вставлять выводы терминала и переносить сгенерированный дифф обратно в редактор. Терминальный Claude Code избавляет от этого трения: он нативно исполняет команды в рабочей директории проекта.
Но настоящая мощь раскрывается тогда, когда агент получает доступ к корпоративной базе знаний. В связке с хранилищем Obsidian агент перед началом рефакторинга автоматически сканирует проектные соглашения: какие библиотеки разрешены, как оформлять миграции баз данных, где хранятся тестовые моки. Архитектурный граф из более чем 3 200 взаимосвязанных заметок считывается мгновенно, избавляя человека от необходимости повторять одни и те же вводные в каждом промпте.
7 шагов настройки Claude Code в терминале
Развертывание рабочего окружения занимает считанные минуты и состоит из семи последовательных действий:
- Подготовка окружения: убедись, что на компьютере установлена среда Node.js версии 18.0 или выше.
- Глобальная установка утилиты через пакетный менеджер:
npm install -g @anthropic-ai/claude-code
- Авторизация в облаке Anthropic Console:
claude-code login
Команда откроет защищенное окно браузера для подтверждения сессии либо предложит вставить API-токен.
- Переход в каталог целевого проекта и первичная инициализация:
cd ~/projects/my-web-platform && claude-code init
В корне проекта создается сервисный каталог .claude/ и файл базовых правил CLAUDE.md.
- Настройка файла
CLAUDE.md: пропиши в нем используемый технологический стек, команды запуска тестов и путь к локальному графу заметок Obsidian. - Интерактивный запуск сессии:
claude-code
- Верификация прав и первый тест: отправь агенту задачу на поиск и устранение бага, убедившись, что он корректно запрашивает подтверждения на изменение файлов.
Границы безопасности: песочница и белый список команд
Предоставить автономному агенту доступ к терминалу — шаг смелый. Если модель галлюцинирует и выполнит деструктивную команду вроде rm -rf или отправит секретный ключ на внешний сервер, последствия могут быть катастрофическими.
Поэтому в конфигурации .claude/config.json критически важно жестко разграничить уровни доверия:
{
"version": "1.0",
"projectSettings": {
"autoApprove": [
"read_file",
"glob",
"grep",
"npm test",
"git diff",
"git status"
],
"requireConfirmation": [
"write_file",
"edit_file",
"npm install",
"git commit",
"git push"
],
"blockedCommands": [
"rm -rf *",
"curl * | bash",
"sudo *"
]
},
"knowledgeBase": {
"vaultPath": "../ObsidianVault/EngineeringSpecs",
"indexTags": ["Architecture", "Conventions", "Security"]
}
}
Такая конфигурация позволяет агенту свободно исследовать репозиторий, читать файлы и прогонять юнит-тесты без постоянных всплывающих окон. Но как только дело доходит до коммита, перезаписи файлов или установки внешних пакетов, Claude Code обязательно делает паузу и спрашивает явного разрешения у человека.
Трехмерная галактика памяти: связка с графом Obsidian
Визуализация базы знаний в виде трехмерного графа Obsidian играет не только эстетическую роль. Когда проекты масштабируются, человеку становится физически сложно удерживать в голове карту всех взаимосвязей между микросервисами, контрактами API и техническими долгами.
В графе узлы представляют собой спецификации сервисов, архитектурные гайдлайны и отчеты о багах, соединенные двусторонними ссылками. В агентном рантайме выделяются субагенты с четкими зонами ответственности: например, координатор Jarvis ведет системный журнал спринта, а ассистент Apollo обрабатывает надиктованные технические требования с мобильных устройств.
Терминальный Claude Code берет задачу из входящей папки, ищет по графу связанные архитектурные заметки, считывает контекст предыдущих рефакторингов и только затем приступает к кодингу. Закончив правки, агент сам обновляет статус тикета в Markdown-файле и привязывает сгенерированный коммит к узлу графа.
Если в процессе сборки возникает конфликт версий или тест падает с непредвиденной ошибкой, Claude Code не мечется по случайным файлам, а обращается к узлу инцидентов в графе, проверяя, не решалась ли схожая проблема месяц назад. В результате рутинная нагрузка на инженера сокращается на 85%: ты перестаешь вручную вбивать десятки сервисных команд и получаешь терминал, который думает, помнит контекст и уважает безопасность твоего кода.



