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

bash-timeout — команда для Claude Code: что делает и как установить

Команда bash-timeout для Claude Code настраивает таймауты bash-команд в settings.json. Увеличивает лимит для длительных тестов и сборок, превышающих стандартные 2 минуты.

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

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

Что делает bash-timeout

По умолчанию Claude Code прерывает выполнение bash-команд через 2 минуты (120000 мс). Для долгих сборок или прогона тестов этого лимита часто не хватает. Команда bash-timeout автоматизирует обновление параметров в settings.json, избавляя от ручного редактирования конфигурации.

Команда принимает длительность (например, 10min или 600s) и необязательную область видимости. Она переводит указанное время в миллисекунды и выставляет переменную BASH_DEFAULT_TIMEOUT_MS. Параметр BASH_MAX_TIMEOUT_MS рассчитывается автоматически — вдвое больше базового таймаута, но не менее 20 минут (1200000 мс). Существующие хуки и другие переменные в блоке env сохраняются.

Область user меняет глобальный файл ~/.claude/settings.json, а project создаёт или обновляет .claude/settings.json в текущем репозитории. Проектные настройки всегда имеют приоритет над пользовательскими.

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

  • поднять лимит времени для долгих тестов и сборок
  • настроить таймауты bash для отдельного проекта в .claude/settings.json
  • задать глобальный лимит выполнения в ~/.claude/settings.json
  • предотвратить аварийное завершение скриптов по стандартному лимиту в 2 минуты

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

  • /bash-timeout 10min
  • /bash-timeout 20min project
  • /bash-timeout 600s user

Как установить bash-timeout

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

.claude/commands/bash-timeout.md

Вызов — /bash-timeout. Для всех проектов — ~/.claude/commands/

Вопросы о bash-timeout

Как установить bash-timeout в Claude Code?

Сохраните файл команды по пути .claude/commands/bash-timeout.md в корне проекта. После этого команда /bash-timeout станет доступна в Claude Code.

Что делает команда bash-timeout?

Она обновляет параметры BASH_DEFAULT_TIMEOUT_MS и BASH_MAX_TIMEOUT_MS в конфигурационном файле settings.json. Это предотвращает принудительную остановку длительных shell-команд.

В чём разница между областями user и project?

Область user сохраняет значения в ~/.claude/settings.json и действует на все ваши проекты. Область project записывает настройки в локальный .claude/settings.json, переопределяя глобальную конфигурацию для конкретного репозитория.

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

bash-timeout.md · MIT
---
description: Configure bash timeout values in Claude Code settings
category: claude-setup
allowed-tools: Read, Edit, Write
argument-hint: "<duration> [scope]"
---

# Configure Bash Timeout Settings

Configure the bash command timeout values in your Claude Code settings.json file. The default timeout is 2 minutes (120000ms), which is often insufficient for long-running operations like builds, tests, or deployments.

## Current Settings

User settings: !if [ -f ~/.claude/settings.json ]; then if command -v jq &>/dev/null; then cat ~/.claude/settings.json | jq '.env // {}' 2>/dev/null; else cat ~/.claude/settings.json | grep -A 10 '"env"' 2>/dev/null || echo "No env settings found"; fi; else echo "No user settings file"; fi
Project settings: !if [ -f .claude/settings.json ]; then if command -v jq &>/dev/null; then cat .claude/settings.json | jq '.env // {}' 2>/dev/null; else cat .claude/settings.json | grep -A 10 '"env"' 2>/dev/null || echo "No env settings found"; fi; else echo "No project settings file"; fi

## Available Timeout Settings

- **BASH_DEFAULT_TIMEOUT_MS**: The default timeout for bash commands (in milliseconds)
- **BASH_MAX_TIMEOUT_MS**: The maximum timeout that can be set for bash commands (in milliseconds)

## Common Timeout Values

- 2 minutes: 120000 (default)
- 5 minutes: 300000
- 10 minutes: 600000
- 15 minutes: 900000
- 20 minutes: 1200000
- 30 minutes: 1800000

## Configure Settings

1. First, check if settings.json exists in the appropriate location
2. Read the current settings to preserve existing configuration
3. Add or update the `env` section with the desired timeout values
4. Maintain all existing settings (hooks, etc.)

### For User-Level Settings (~/.claude/settings.json)
- Applies to all projects for the current user
- Location: `~/.claude/settings.json`

### For Project-Level Settings (.claude/settings.json)
- Applies only to the current project
- Location: `.claude/settings.json`
- Project settings override user settings

## Arguments

Specify the timeout duration (e.g., "10min", "20min", "5m", "600s") and optionally the scope:
- `$ARGUMENTS` format: `[duration] [scope]`
- Duration: Required (e.g., "10min", "20min", "300s")
- Scope: Optional - "user" (default) or "project"

Examples:
- `/bash-timeout 10min` - Set user-level timeout to 10 minutes
- `/bash-timeout 20min project` - Set project-level timeout to 20 minutes
- `/bash-timeout 600s user` - Set user-level timeout to 600 seconds

## Implementation Steps

1. Parse the arguments to extract duration and scope
2. Convert duration to milliseconds
3. Determine the settings file path based on scope
4. Read existing settings if the file exists
5. Update or add the env section with new timeout values
6. Set BASH_DEFAULT_TIMEOUT_MS to the specified value
7. Set BASH_MAX_TIMEOUT_MS to 2x the default value (or at least 20 minutes)
8. Write the updated settings back to the file
9. Confirm the changes to the user

## Example Configuration

```json
{
  "env": {
    "BASH_DEFAULT_TIMEOUT_MS": "600000",
    "BASH_MAX_TIMEOUT_MS": "1200000"
  },
  "hooks": {
    // existing hooks configuration...
  }
}
```

This sets:
- Default timeout: 10 minutes (600000ms)
- Maximum timeout: 20 minutes (1200000ms)

© carlrannaberg · MIT · carlrannaberg/claudekit

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
hook-developer parcadei Скилл hook-developer для Claude Code — справочник по хукам: схемы входных и выходных данных, регистрация в settings.json, тестирование. Разработка собственных хуков. CX Codex +1 507установок claude-code-bash-patterns secondsky Скилл claude-code-bash-patterns обучает агента безопасно запускать CLI-команды, связывать их через && и настраивать хуки pretooluse. Помогает избежать сбоев при сборке и запретить опасный вызов rm -rf. CX Codex +1 414установок bash-linux davila7 Скилл bash-linux для Claude Code — справочник по Bash в macOS и Linux: команды, файлы, процессы и обработка ошибок. Помогает править скрипты и разбирать логи. CX Codex +1 215установок mcp-server-bash-sdk reason-machines Скилл mcp-server-bash-sdk помогает проектировать серверы Model Context Protocol на чистом Bash без тяжёлых сред исполнения вроде Node.js или Python. CX Codex +1 171установок bash-defensive-patterns Ryan Snodgrass Скилл bash-defensive-patterns для Claude Code помогает писать Bash-скрипты с обработкой ошибок и безопасной работой с данными. Включается при создании CI/CD-скриптов и системных утилит. CX Codex +1 13 409установок bash-guard.en zuiho-kai Правило bash-guard.en для Claude Code запрещает опасные команды терминала и настраивает таймауты фоновых задач. CX Codex +1 ★ 262звёзд репо

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

Весь набор →
push Слэш-команда push для Claude: проверяет ветку, remote и upstream, а потом пушит — сразу, если рабочая копия чистая. CX Codex +1 ★ 763звёзд репо status Команда status анализирует состояние Git-репозитория, группирует изменённые файлы по назначению и даёт подсказки перед коммитом или ребейзом. CX Codex +1 ★ 763звёзд репо cli Проверяет наличие CLI-утилиты и добавляет её справку в CLAUDE.md, чтобы агент видел команды и параметры инструментов проекта. CX Codex +1 ★ 763звёзд репо checkout Команда checkout создаёт и переключает git-ветки по конвенции имён: feature/, hotfix/, release/ и другие префиксы. Пригодится там, где в проекте заведён порядок в названиях веток. CX Codex +1 ★ 763звёзд репо create-command Команда create-command помогает собрать новую слэш-команду Claude Code: уточняет её назначение, готовит файл и показывает, как вызвать результат. CX Codex +1 ★ 763звёзд репо commit Команда commit собирает git-коммит в стиле проекта: проверяет диф, обновляет документацию, пишет сообщение по конвенциям из CLAUDE.md. CX Codex +1 ★ 763звёзд репо code-search Субагент code-search для Claude Code ищет в кодовой базе файлы, функции и шаблоны и возвращает краткий список путей. Локализует код перед правками без лишних рассуждений модели. CX Codex ★ 763звёзд репо validate-and-fix Команда validate-and-fix для Claude Code запускает проверки проекта и распределяет исправления между параллельными агентами. Она ищет команды сборки, тестов и линтинга в инструкциях проекта и package.json. CX Codex +1 ★ 763звёзд репо

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

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