Базовое использование Claude Code
В этой главе представлены основные функции, наиболее часто используемые в повседневной разработке с Claude Code, включая то, как общаться с Claude, читать и изменять код, запускать команды, работать с файлами, а также некоторые практические советы, которые могут значительно повысить эффективность.
Основные методы общения
1. Интерактивный режим (наиболее часто используемый)
Запустите Claude Code в каталоге проекта, и после входа в интерактивный режим вы можете напрямую вводить вопросы или инструкции:
cd /path/to/your/project claude
В интерактивном режиме просто вводите запросы на естественном языке напрямую — специальное форматирование не требуется:
What does this project do?
帮我找出 src/auth.ts 里的 bug
给 UserService 添加一个 getUserById 方法
использование@Вы также можете указать файлы. Например, у нас есть test.html в каталоге claude-test.

Мы можем ввести claude-test:
cd claude-test
Затем спросите:
@test.html 这个文件是干嘛的

2. Режим одноразовой задачи
Если вам нужно выполнить только одну задачу и не требуется входить в интерактивный режим, вы можете добавить описание задачи прямо после команды:
claude "解释一下 package.json 里的 scripts 字段"
Он автоматически завершается после выполнения, что делает его удобным для использования в shell-скриптах или быстрых запросов.
3. Режим одиночного запроса (-p)
Используйте-pпараметр для выполнения одноразового запроса. Ответ Claude выводится непосредственно в терминал, что делает его удобным для комбинирования с другими командами:
claude -p "这段代码有什么问题" < src/utils.ts
# 将 Claude 的分析结果保存到文件 claude -p "分析项目依赖的安全风险" > security-report.md
4. Продолжить предыдущий разговор (-c)
Claude Code сохраняет историю разговоров. Используйте-cпараметр, чтобы продолжить последний незавершённый разговор в текущем каталоге, без необходимости заново собирать контекст:
claude -c
Понимание и анализ кода
1. Понимание общей ситуации проекта
Когда вы впервые попадаете в незнакомый проект, вы можете попросить Claude провести общий анализ:
What is the architecture of this project?
What main technologies and dependencies does the project use?
Please introduce the project's directory structure.
Claude Code автоматически прочитает файлы проекта для анализа.Вам не нужно вручную указывать, какие файлы читать.Он сам определит, какое содержимое нужно изучить.
2. Анализ конкретного файла или модуля
解释一下 src/middleware/auth.ts 的工作原理
UserRepository 类里有哪些方法?分别是做什么的?
这个 SQL 查询语句是什么意思?
3. Прослеживание цепочек вызовов кода
When a user logs in, what is the code execution flow? List everything from the entry point to the database.
findUserByEmail 这个函数在哪里被调用?
Which database table does the data from this interface ultimately end up in?
4. Понимание сложной логики
What does this recursive function mean? Can you give an example to illustrate?
为什么这里要用 useCallback?不用会怎样?
What format of strings can this regular expression match?
Изменение кода
1. Добавление новой функции
Опишите нужную вам функцию, и Claude найдёт подходящее место и реализует её:
在 UserService 里添加一个 updatePassword 方法,需要验证旧密码
给登录接口添加请求频率限制,同一 IP 每分钟最多 5 次
创建一个 formatCurrency 工具函数,支持传入货币代码参数
2. Исправление ошибки
Опишите симптомы проблемы, и Claude найдёт причину и предложит исправление:
After the user logs out, refreshing the page still shows the logged-in state. Help me find the cause and fix it.
This function errors when the input is an empty array. Fix it.
控制台报错 "Cannot read properties of undefined (reading 'map')",帮我定位并修复
3. Рефакторинг кода
把这个 500 行的组件拆分成更小的子组件
将 callback 风格的异步代码改为 async/await
These functions contain a lot of duplicate code. Help me extract it into a common utility function.
4. Проверка изменений
Claude Code показывает diff перед каждым изменением файла для вашей проверки. Вы можете обсудить это после того, как Claude предложит изменения:
Don't change the code yet. Just tell me how you plan to modify it.
There's a problem with your previous modification: it doesn't handle concurrency. Start over.
这个方案可以,但把函数名改成 validateUserCredentials
Claude Code отображает изменения и запрашивает ваше подтверждение перед внесением любых изменений в файлы. Вы можете выбратьПринять (да)、Отклонить (нет), или продолжить обсуждение перед подтверждением. Не считайте, что вы должны принять все изменения сразу — сначала посмотрите и подтвердите только тогда, когда вас всё устраивает.
Запуск команд и тестов
1. Разрешить Claude запускать команды
Claude Code может выполнять команды прямо в терминале. Вы можете описать, что хотите сделать, на естественном языке:
Run the tests and see if any fail.
安装 dayjs 这个依赖
Build the project and see if there are any errors.
Claude, основываясь на конфигурации проекта (например,package.jsonскрипты в, илиCLAUDE.mdкоманды в) выберет подходящую команду для выполнения.
2. Запуск конкретных тестов
运行 auth 模块的测试
Run all tests and generate a coverage report.
Why did this test fail? Help me fix it.
3. Просмотр вывода команды
Claude рассматривает вывод команды как контекст и напрямую предлагает следующие шаги на основе вывода:
运行 npm run build,如果有报错帮我修复
跑一下 lint,把所有警告都修复掉
Операции с файлами
1. Создание новых файлов
创建 src/utils/date.ts,实现日期格式化相关的工具函数
新建一个 Docker Compose 配置文件,包含 PostgreSQL 和 Redis 服务
创建 .github/workflows/ci.yml,配置 GitHub Actions 自动运行测试
2. Поиск файлов и содержимого
Is there any code in the project that handles file uploads? Where is it?
哪些地方用到了 localStorage?
找出所有使用了 console.log 的文件
3. Пакетные изменения
把所有文件里的 http://api.example.com 替换成 https://api.example.com
把 src/components/ 下所有组件的 PropTypes 改为 TypeScript 类型定义
给 src/api/ 目录下所有接口函数添加 JSDoc 注释
Операции с Git
Claude Code имеет глубокую интеграцию с Git, позволяя выполнять почти все операции с Git с помощью естественного языка.
1. Просмотр изменений
Which files did I change?
What does this change include?
最近 10 次提交都改了什么?
2. Коммит кода
Commit this change.
把这次的修改提交,commit 信息说明修复了登录验证的 bug
Claude автоматически создаёт подходящее сообщение коммита на основе фактических изменений. Вы также можете использовать быструю команду:
claude commit
3. Управление ветками
新建一个 feature/user-profile 分支
切换到 develop 分支
把 main 分支的最新改动合并进来
4. Разрешение конфликтов слияния
Help me resolve the merge conflict.
This file has conflicts. Help me check which version is correct.
Советы по управлению контекстом
1. Указание файлов вручную
Используйте@file pathсинтаксис, позволяющий явно указать Claude, на какой файл ссылаться, избегая догадок:
参考 @src/types/user.ts 里的类型定义,给 UserService 添加类型注解
对照 @docs/api-spec.md 里的规范,检查接口实现是否符合要求
2. Очистить контекст
Если разговор идёт долго или вы переключились на совершенно другую задачу, рекомендуется очистить контекст и начать заново:
/clear
После очистки «память» Claude возвращается к исходному состоянию, и на новый сеанс не влияет содержимое предыдущего разговора.
3. Сжать контекст
Когда Claude, похоже, начинает «забывать» предыдущее содержимое или разговор становится очень длинным, можно сжать контекст:
/compact
Это заставляет Claude суммировать текущий разговор в компактный дайджест, освобождая место в контексте, но сохраняя ключевую информацию для продолжения работы.
4. Разумно разделять задачи
Не описывайте сложную задачу сразу целиком; лучше разбить её на несколько шагов и выполнять их последовательно:
❌ Плохая практика: сразу вываливать на Claude слишком много требований:
Help me refactor the entire user module, including adding type annotations, splitting files, optimizing database queries, adding caching, writing tests, and updating documentation.
✅ Хорошая практика: разбить на независимые шаги в логическом порядке:
第一步:"分析 src/user/ 目录的现有结构,告诉我有哪些问题" 第二步:"先给所有函数添加 TypeScript 类型注解" 第三步:"把超过 200 行的文件拆分成更小的模块" 第四步:"优化数据库查询,添加必要的索引"
Основные слэш-команды
В интерактивном режиме введите/чтобы вызвать список всех доступных команд. Вот наиболее часто используемые слэш-команды:
| Команда | Функция | Сценарий использования |
|---|---|---|
/help |
Просмотреть все доступные команды и их описания | Когда вы не уверены, какие функции доступны |
/clear |
Очистить историю беседы и начать новую сессию | При переходе к новой задаче |
/compact |
Сжать текущий контекст беседы, чтобы освободить место | Когда беседа длинная и Claude начинает забывать |
/init |
Проанализировать проект и сгенерировать файл CLAUDE.md | При первом использовании в новом проекте |
/resume |
Выбрать и возобновить предыдущую беседу из истории | Продолжить задачу, оставшуюся незавершённой вчера |
/undo |
Отменить последнее изменение файла | Когда изменения Claude неверны |
/redo |
Повторить отменённое изменение | Когда после отмены вы понимаете, что исходный вариант был лучше |
/login |
Войти или переключить аккаунт | Когда нужно переключиться на другой аккаунт |
/config |
Просмотр и изменение конфигурации | Настройка параметров поведения Claude Code |
/cost |
Просмотр использования токенов в этом сеансе | Отслеживание расходов при использовании аккаунта API |
Практические советы
1. Сначала дайте Claude проанализировать, затем действуйте
Для сложных задач попросите Claude сначала объяснить свой подход и приступайте только после подтверждения правильного направления.
Don't modify the code. First analyze the possible causes of login failure and list your troubleshooting approach.
How do you plan to implement this feature? Describe the approach first, and I'll confirm before you write the code.
2. Предоставляйте сообщения об ошибках и логи
Когда вы сталкиваетесь с ошибкой, вставьте сообщение об ошибке прямо в диалог. Claude определит проблему по содержимому ошибки:
运行时报了这个错误,帮我分析原因:
TypeError: Cannot read properties of null (reading 'userId')
at getUserProfile (src/services/user.ts:42:18)
at async ProfileController.getProfile (src/controllers/profile.ts:15:20)
3. Описывайте проблемы интерфейса с помощью скриншотов
Claude Code поддерживает мультимодальный ввод. Вы можете вставлять скриншоты прямо в диалог, чтобы описывать проблемы, связанные с интерфейсом:
[Paste screenshot] This button does not respond when clicked, but there are no errors in the console. Help me investigate.
[粘贴设计稿截图] 按照这个设计实现 Header 组件
4. Правильно используйте "Continue"
Если ответ Claude обрезан или вам кажется, что он не закончил говорить, просто скажите "continue":
Continue.
Anything else?
Implement the remaining parts as well.
5. Запрашивайте объяснения изменений
Для важных изменений кода вы можете попросить Claude объяснить причину каждого изменения:
After making the changes, explain the purpose of each change to me.
这里为什么要用 Promise.allSettled 而不是 Promise.all?
6. Ограничивайте область операций Claude
Когда вы не хотите, чтобы Claude произвольно изменял другие файлы, вы можете явно ограничить область:
只修改 src/auth.ts 这一个文件,不要改其他地方
Only read the code, don't modify it. Help me analyze the performance bottleneck of this module.
Примеры типичных рабочих процессов
Рабочий процесс 1: Быстро разобраться в новом проекте
Пример
> Что делает этот проект? Какие технологии он использует?
# Шаг 2: Разберитесь в структуре каталогов
> Представьте структуру каталогов проекта, уделив особое внимание основным модулям
# Шаг 3: Узнайте, как его запустить
> Как мне запустить этот проект локально?
# Шаг 4: Сгенерируйте файл описания проекта
> Помогите мне сгенерировать файл CLAUDE.md, обобщающий ключевую информацию о проекте
Рабочий процесс 2: Исправление ошибки
Пример
> Отзыв пользователя: После изменения личной информации имя пользователя в верхней части страницы не обновляется в реальном времени
# Шаг 2: Попросите Claude проанализировать причину
> Сначала проанализируйте возможные причины; не изменяйте код
# Шаг 3: Исправьте после подтверждения подхода
> Вторая упомянутая вами причина кажется более вероятной. Исправьте, следуя этой логике
# Шаг 4: Проверьте исправление
> Запустите соответствующие тесты, чтобы подтвердить эффективность исправления
Рабочий процесс 3: Добавление новой функции
Пример
> Нужно добавить фильтр по статусу в список заказов. Статусы: ожидает оплаты, оплачен, отправлен, завершён
# Шаг 2: Изучите существующий код
> Сначала посмотрите на существующую структуру кода для заказов
# Шаг 3: Реализуйте функцию
> Реализуйте функцию фильтрации, не затрагивая существующую функциональность
# Шаг 4: Добавьте тесты
> Напишите тест-кейсы для этой новой функции
# Шаг 5: Сделайте коммит кода
> Сделайте коммит этого изменения
Рабочий процесс 4: Ревью кода
# 审查特定文件 > 帮我审查 src/payment/processor.ts 这个文件, > 重点关注错误处理、边界情况和安全风险 # 审查 git 改动 > 审查我这次的所有改动,看看有没有明显的问题 # 针对性检查 > 这段代码有没有 SQL 注入的风险?
Примечания
О модификации файлов:Claude Code покажет diff и запросит подтверждение перед внесением изменений.Не принимайте всё слепо, особенно для изменений, затрагивающих ключевую логику. Пожалуйста, внимательно прочитайте содержимое diff, прежде чем решать, принимать ли изменения.
О чувствительных файлах: ВCLAUDE.mdили.claude/settings.jsonчётко помечайте файлы, которые Claude не разрешено читать или изменять (например,.env, файлы ключей), чтобы избежать случайного раскрытия.
О крупных задачах: Не накапливайте слишком много незавершённых задач в одном разговоре; это легко может заставить Claude потерять фокус. Завершите одну задачу, прежде чем начинать другую, или используйте/clearчтобы перезапустить.
О качестве кода: Код, сгенерированный Claude, не всегда является оптимальным решением. Для важных модулей после выполнения рекомендуется провести раунд ревью кода, понять цель каждого изменения и убедиться, что оно соответствует принципам проектирования проекта.
Другие расширения