К основному содержимому

Ваш первый день в Claude Code

Обновлено сегодня

Цель: Примерно за 15 минут вы установите Claude Code, войдёте в систему и выполните свой первый AI-ассистируемый изменение. Это руководство охватывает только необходимое в первый день; ссылки на более подробный материал находятся в конце.


Шаг 1: Установка Claude Code (2 минуты)

Выберите команду, соответствующую вашей системе, и вставьте её в терминал.

Ваша установка

Команда

macOS / Linux / WSL

Windows (PowerShell)

Homebrew

brew install --cask claude-code

npm (Node 18+)

npm install -g @anthropic-ai/claude-code

Совет: Не запускайте npm install с sudo, так как это вызывает проблемы с разрешениями файлов позже.

Проверьте установку:

claude --version


Шаг 2: Вход в систему (2 минуты)

Способ аутентификации зависит от того, как ваша организация предоставила доступ. Выберите один из следующих вариантов:

Если ваша организация использует…

Сделайте это

Claude Enterprise лицензии

Запустите claude, затем /login и одобрите запрос в браузере (включая SSO, если потребуется). Это наиболее распространённый способ.

API ключ Anthropic Console

Запустите export ANTHROPIC_API_KEY=sk-ant-…, затем запустите claude.

Amazon Bedrock

Запустите export CLAUDE_CODE_USE_BEDROCK=1, настройте учётные данные AWS, затем запустите claude.

Google Vertex AI

Запустите export CLAUDE_CODE_USE_VERTEX=1, настройте учётные данные GCP, затем запустите claude.

Если вы не уверены, какой метод применяется, проконсультируйтесь с администратором или сначала попробуйте /login, что является стандартным для большинства организаций.


Шаг 3: Откройте проект (1 минута)

cd path/to/your/project claude

Claude Code читает ваши файлы по требованию, поэтому нет необходимости загружать или прикреплять что-либо. Просто запустите его из репозитория, над которым вы хотите работать.


Шаг 4: Поймите одно правило безопасности (1 минута)

Claude всегда спросит перед изменением файла или выполнением команды. Когда он предлагает изменение, вы увидите diff и три варианта:

  • Да — применить это одно изменение.

  • Да, и больше не спрашивать для редактирования — автоматически одобрять редактирование файлов на оставшуюся часть сеанса.

  • Нет — отклонить изменение и объяснить почему.

Вы можете нажать Shift+Tab в любое время, чтобы переключаться между режимами (План → Принять редактирование → по умолчанию). Если изменение дает неожиданный результат, ваша история git остаётся нетронутой до тех пор, пока вы не выполните commit, поэтому git checkout отменит его.


Шаг 5: Пять вещей для первой попытки

Копируйте и вставляйте их в подсказку по одному. Каждый пример демонстрирует различную основную возможность.

1. Ориентируйтесь

Give me a 5-bullet summary of what this codebase does and where the entry point is.

Почему это полезно: Это показывает, как Claude самостоятельно исследует файлы, не указывая на конкретные пути.

2. Найдите что-нибудь

Where is user authentication handled? Show me the file and the key function.

Почему это полезно: Это часто быстрее, чем grep, когда вы не знаете точный символ или имя файла.

3. Сделайте безопасное редактирование

Add a docstring to the function <name> in <file>. Keep it to 2 lines.

Почему это полезно: Это позволяет вам потренироваться в проверке и одобрении diff при низкорисковом изменении.

4. Исправьте что-нибудь реальное

This test is failing: <paste the error>. Find the cause and fix it.

Почему это полезно: Это основной рабочий процесс — вы описываете симптом, а Claude исследует и предлагает исправление.

5. Позвольте ему управлять git

Stage my changes and write a commit message that follows our existing style.

Почему это полезно: Claude может запускать git от вашего имени (с одобрением) и будет соответствовать существующим соглашениям о коммитах вашего репозитория.


Шаг 6: Перед тем как закончить на день

Запустите это один раз для каждого проекта:

/init

Это генерирует файл CLAUDE.md в корне вашего проекта, который фиксирует соглашения вашей кодовой базы. Claude автоматически читает его в начале каждого сеанса, поэтому будущие ответы уже будут адаптированы к вашему проекту. Это единственный наиболее ценный шаг настройки, который вы можете предпринять.


Следующие шаги

Вы теперь установили Claude Code, аутентифицировались, выполнили редактирование и настроили память проекта. Когда вы будете готовы идти дальше, официальная документация охватывает память и CLAUDE.md, команды слэша и сочетания клавиш интерактивного режима в деталях.

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

Нашли ответ на свой вопрос?