# AgentCode: что делать, если что-то не работает

## Быстрая проверка

```bash
agentcode health
```

Нормальное состояние:

- `Local node`: OK
- `OpenCode`: OK
- `Model gateway`: OK
- `Model tunnel`: OK
- `Visible model list`: `agent-pipeline-orchestrator`
- `Policy mode`: `enforced`

## Не открывается AgentCode

Запусти:

```bash
agentcode open
```

Если браузер не открылся, скопируй URL из:

```bash
agentcode open --url
```

## Не видит файлы

Проверь:

- файл или папка реально существуют;
- путь написан полностью;
- файл не лежит в запрещённой зоне вроде `.ssh`, keychain, browser profile или системной папки;
- внешний диск подключён.

Хорошая формулировка:

```text
Прочитай файл /полный/путь/к/файлу.txt
```

Плохая формулировка:

```text
Найди где-то тот файл, ну ты понял.
```

## Не видит модели

Запусти:

```bash
agentcode health
agentcode logs
```

Если `Model tunnel` показывает `FAIL`, значит не работает связь с сервером моделей или сервер недоступен.

## OpenCode не найден

`agentcode health` покажет `OpenCode: FAIL`.

Что сделать:

1. Проверь, установлен ли OpenCode.
2. Перезапусти сервисы через update:

```bash
agentcode update --restart
```

3. Если не помогло, пришли `agentcode logs`.

## Задача требует подтверждения

Если действие опасное, AgentCode должен не выполнять его сразу, а написать, что нужно подтвердить.

Опасные примеры:

- удалить файлы;
- перенести папки;
- установить пакеты;
- перезапустить сервис;
- менять права файлов.

Без подтверждения такие действия не должны выполняться.

## Обновление

Проверить обновление:

```bash
agentcode check
```

Посмотреть, что будет обновлено:

```bash
agentcode update --dry-run
```

Применить обновление:

```bash
agentcode update --restart
```

## Логи

```bash
agentcode logs
agentcode logs --lines 200
```

При ошибке лучше прислать:

- текст задачи;
- финальный ответ AgentCode;
- вывод `agentcode health`;
- вывод `agentcode logs --lines 200`.