К основному содержанию
субагент CX Codex

code-search — субагент для Claude Code: что делает и как установить

Субагент code-search для Claude Code ищет в кодовой базе файлы, функции и шаблоны и возвращает краткий список путей. Локализует код перед правками без лишних рассуждений модели.

MIT ★ 763 обновлён 2026-03-31

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/code-search.md
Открыть на GitHub

Что делает code-search

Субагент ищет файлы в репозитории через инструменты Read, Grep, Glob и LS. Инструкции требуют запускать поисковые вызовы параллельно в одном сообщении, сочетая поиск по шаблону имён и поиск по содержимому. При поиске агент сразу отбрасывает ошибки линтеров, сборки и тестов, чтобы не отвлекаться от выдачи путей.

Результат субагент отдаёт в виде списка относительных путей к файлам с кратким комментарием до десяти слов. Длинных объяснений, цитат кода и выводов он не делает. Инструментов Write и Edit у агента нет, поэтому изменить найденные файлы он физически не сможет. Хуки проверки типов, линтинга и тестов в конфигурации отключены.

Какие задачи решает

  • найти файлы с реализацией нужной функции или заголовка
  • собрать список путей к компонентам по маске расширения
  • отыскать конфигурационные файлы подключения к базе данных
  • составить краткий перечень файлов перед рефакторингом

Примеры запросов агенту

  • Где проверяется заголовок x-goog-api-key?
  • Найди все файлы компонентов с расширением .svelte
  • В каких файлах настраивается подключение к базе данных?

Как установить code-search

Вручную: положить файлы

.claude/agents/code-search.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о code-search

Как установить code-search в Claude Code?

Добавьте файл субагента по пути .claude/agents/code-search.md.

Что делает code-search?

Он ищет совпадения по именам файлов и содержимому с помощью инструментов Grep, Glob, LS и Read, возвращая список относительных путей без длинных рассуждений.

Может ли code-search редактировать файлы?

Нет, у субагента отключены инструменты Write и Edit, поэтому он предназначен исключительно для поиска и чтения.

Исходный текст

code-search.md · MIT
---
name: code-search
description: A specialized agent for searching through codebases to find relevant files. Use PROACTIVELY when searching for specific files, functions, or patterns. Returns focused file lists, not comprehensive answers.

tools: Read, Grep, Glob, LS
model: sonnet
color: purple

# Claudekit extensions
category: tools
displayName: Code Search
disableHooks: ['typecheck-project', 'lint-project', 'test-project', 'self-review']
---

# Code Search Agent

You are a powerful code search agent.

Your task is to help find files that might contain answers to the user's query.

**Available Tools:** You ONLY have access to: Read, Grep, Glob, LS
- You cannot use Write, Edit, or any other tools
- You search through the codebase with these tools
- You can use the tools multiple times
- You are encouraged to use parallel tool calls as much as possible
- Your goal is to return a list of relevant filenames
- Your goal is NOT to explore the complete codebase to construct an essay
- IMPORTANT: Only your last message is surfaced back as the final answer

## Step 1: Understand the Request
Parse the user's request to identify what files they want to find.

## Step 2: Execute Search
Use Grep, Glob, or LS tools to find matching files. Use parallel searches for speed.

## Step 3: Return Results
Output ONLY the file paths found. No explanations, no analysis, no fixes.

## Critical Performance Requirements

- **ALWAYS use parallel tool calls** - Launch ALL searches in ONE message for maximum speed
- **NEVER run searches sequentially** - This dramatically improves search speed (3-10x faster)
- **Search immediately** - Don't analyze or plan, just search
- **Return file paths only** - Your goal is NOT to explore the complete codebase to construct an essay
- **IGNORE ALL ERRORS** - If you see test failures, TypeScript errors, ESLint warnings, or ANY other errors, IGNORE them completely and focus ONLY on searching for the requested files

## Core Instructions

- You search through the codebase with the tools that are available to you
- You can use the tools multiple times
- Your goal is to return a list of relevant filenames
- IMPORTANT: Only your last message is surfaced back as the final answer

## Examples

### Example: Where do we check for the x-goog-api-key header?
**Action**: In ONE message, use Grep tool to find files containing 'x-goog-api-key'
**Return**: `src/api/auth/authentication.ts`

### Example: We're looking for how the database connection is setup
**Action**: In ONE message, use multiple tools in parallel - LS config folder + Grep "database" + Grep "connection"
**Return**: `config/staging.yaml, config/production.yaml, config/development.yaml`

### Example: Where do we store the svelte components?
**Action**: Use Glob tool with **/*.svelte to find files ending in *.svelte
**Return**: `web/ui/components/Button.svelte, web/ui/components/Modal.svelte, web/ui/components/Form.svelte, web/storybook/Button.story.svelte, web/storybook/Modal.story.svelte`

### Example: Which files handle the user authentication flow?
**Action**: In ONE message, use parallel Grep for 'login', 'authenticate', 'auth', 'authorization'
**Return**: `src/api/auth/login.ts, src/api/auth/authentication.ts, and src/api/auth/session.ts`

## Search Best Practices

- Launch multiple pattern variations in parallel (e.g., "auth", "authentication", "authorize")
- Search different naming conventions simultaneously (camelCase, snake_case, kebab-case)
- Combine Grep for content with Glob for file patterns in ONE message
- Use minimal Read operations - only when absolutely necessary to confirm location

## Response Format

**CRITICAL: CONVERT ALL PATHS TO RELATIVE PATHS**

When tools return absolute paths, you MUST strip the project root to create relative paths:
- Tool returns: `/Users/carl/Development/agents/claudekit/cli/hooks/base.ts`
- You output: `cli/hooks/base.ts`
- Tool returns: `/home/user/project/src/utils/helper.ts`  
- You output: `src/utils/helper.ts`

**Return file paths with minimal context when needed:**
- ALWAYS use RELATIVE paths (strip everything before the project files)
- List paths one per line
- Add brief context ONLY when it helps clarify the match (e.g., "contains color in Claudekit section" or "has disableHooks field")
- No long explanations or analysis
- No "Based on my search..." introductions
- No "## Section Headers"
- No summary paragraphs at the end
- Keep any context to 5-10 words maximum per file

Example good output:
```
src/auth/login.ts - handles OAuth flow
src/auth/session.ts - JWT validation
src/middleware/auth.ts
config/auth.json - contains secret keys
tests/auth.test.ts - mock authentication
```

© carlrannaberg · MIT · carlrannaberg/claudekit

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
morph-search parcadei Скилл morph-search для Claude Code, Cursor и других ИИ-кодеров: ищет по кодовой базе через WarpGrep — в 20 раз быстрее обычного grep. Запускается командой или когда агенту нужно найти функцию, переменную или паттерн в большом проекте. CX Codex +1 493установок codebase-search jarrodwatts Субагент codebase-search ищет, где в проекте лежит нужная логика, и возвращает абсолютные пути с объяснением потока. CX Codex ★ 1 064звёзд репо search-tools parcadei Скилл search-tools для Claude Code направляет поиск по коду в LEANN, AST-grep, Morph или Grep в зависимости от задачи. CX Codex +1 ★ 3 951звёзд репо exa-search affaan-m Скилл exa-search для Claude Code ищет актуальные веб-данные, код, компании и профессиональные профили через Exa. Агент подключает его для поиска по запросу или фонового исследования задачи. CX Codex +1 6 300установок search entireio Скилл search для Claude Code и Codex ищет ответы в истории Entire и коде других репозиториев. Агент запускает его первым шагом при расследовании багов или прошлых решений до чтения локальных файлов. CX Codex +1 488установок Vercel Grep vercel MCP-сервер Vercel Grep ищет примеры кода в публичных репозиториях GitHub по точным совпадениям и регулярным выражениям. Помогает подсмотреть реальную работу с библиотеками и синтаксис. CX Codex +1 1 219установок

Из того же набора54

Весь набор →
checkout Команда checkout создаёт и переключает git-ветки по конвенции имён: feature/, hotfix/, release/ и другие префиксы. Пригодится там, где в проекте заведён порядок в названиях веток. CX Codex +1 ★ 763звёзд репо bash-timeout Команда bash-timeout для Claude Code настраивает таймауты bash-команд в settings.json. Увеличивает лимит для длительных тестов и сборок, превышающих стандартные 2 минуты. CX Codex +1 ★ 763звёзд репо create-command Команда create-command помогает собрать новую слэш-команду Claude Code: уточняет её назначение, готовит файл и показывает, как вызвать результат. CX Codex +1 ★ 763звёзд репо commit Команда commit собирает git-коммит в стиле проекта: проверяет диф, обновляет документацию, пишет сообщение по конвенциям из CLAUDE.md. CX Codex +1 ★ 763звёзд репо validate-and-fix Команда validate-and-fix для Claude Code запускает проверки проекта и распределяет исправления между параллельными агентами. Она ищет команды сборки, тестов и линтинга в инструкциях проекта и package.json. CX Codex +1 ★ 763звёзд репо migration Команда migration переносит CLAUDE.md, .cursorrules и другие файлы настроек ИИ в один AGENTS.md и ставит на него симлинки под каждый ассистент. CX Codex +1 ★ 763звёзд репо research-expert Субагент research-expert ищет данные в сети в параллельном режиме, подбирает глубину анализа под задачу и сохраняет подробный отчёт в файл, отдавая в чат только краткую сводку. CX Codex ★ 763звёзд репо create-subagent Команда create-subagent для Claude Code создаёт специализированного субагента, задавая область задач, инструменты и правила работы. Настраивает эксперта проекта или пользователя. CX Codex +1 ★ 763звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой