---
title: "에이전트에서 대용량 다운로드 전에 네트워크 확인 · Kilobat 레시피"
url: "https://kilobat.app/ko/guides/recipes/check-network-before-download"
description: "AI 에이전트가 Mac에서 모델, 이미지 또는 의존성을 다운로드하기 전에 데이터 제한 네트워크, 저데이터 모드, VPN, 손실 및 배터리를 확인하도록 하세요."
---

레시피

# 에이전트의 대용량 다운로드 전에 네트워크 확인

에이전트가 지금 대용량 전송을 하기에 좋은 때인지 Kilobat에 물을 수 있습니다. Kilobat은 약 2초 안에 한 줄의 조언으로 답합니다.

앱과 CLI에서 무료 · 확인일: 2026년 10월 29일

## 앱에서

1. Wi-Fi 메뉴를 여세요. 데이터 제한 네트워크에는 연결됨 · 데이터 제한이라고 표시됩니다.
2. Kilobat이 네트워크를 취급하는 방식을 변경하려면 데이터 비용을 자동, 데이터 요금제 연결 또는 무제한으로 설정하세요.

## CLI로 사용

1. 조건을 JSON으로 확인합니다.

   ```
   kilobat conditions --json
   ```

   출력 `metered`, `osMetered`, `lowDataMode`, `vpn`, `internetLatencyMs`, `internetLossPercent`, `power` 및 `advice`의 한 줄 요약. 예: “양호한 조건: 온라인, 데이터 무제한, 전원 연결됨.”
2. 데이터 제한 네트워크라면 먼저 사용자에게 물어보세요. 속도 테스트는 지정한 한도까지만 사용합니다.

   ```
   kilobat speedtest --budget-mb 10
   ```
3. 다운로드가 진행되는 동안 Mac이 잠들지 않게 유지하세요.

   ```
   kilobat awake -- huggingface-cli download org/model
   ```

## MCP로 사용

`claude mcp add kilobat -- kilobat mcp`로 MCP 서버를 한 번 연결하세요. 다른 클라이언트는 [문서](https://kilobat.app/ko/docs/agents#agents)를 참고하세요. 그러면 에이전트가 이 도구를 호출할 수 있습니다. 설정을 변경하는 도구는 에이전트에게 먼저 확인하도록 안내합니다.

| 도구 및 인수 | 기능 |
|---|---|
| `get_conditions` | 데이터 제한, 저데이터 모드, VPN, 지연 시간, 패킷 손실, 배터리 및 발열을 `advice`에서 확인합니다. |
| `get_updaters` | 현재 이 네트워크에서 업데이터가 일시 정지되었는지 여부. |
| `run_speedtest` `{"budget_mb": 10}` | 데이터를 사용합니다. 데이터 요금제 네트워크에서는 에이전트가 먼저 물어봐야 합니다. |
| `keep_awake` `{"minutes": 60, "reason": "Downloading the model"}` | 다운로드 중 유휴 잠자기를 막습니다. |

## 알아두면 좋은 정보

- `metered`은 Kilobat이 적용하는 값입니다. `osMetered`은 macOS가 보고하는 값입니다. `meteredSource`은 `macOS` 또는 `you`입니다.
- 지연 시간이 `null`이면 ping 응답을 받지 못했다는 뜻입니다. 인터넷이 끊겼다는 증거는 아닙니다.
- Kilobat 에이전트 스킬은 데이터 제한 네트워크에서 대용량 전송 전에 묻도록 에이전트에 지시합니다.

## 출처

- [Kilobat 문서: AI 에이전트와 MCP](https://kilobat.app/ko/docs/agents#agents)
- [Kilobat 스킬: mac-agent-runs](https://github.com/seifip/kilobat-skills/tree/main/skills/mac-agent-runs)
- [Kilobat llms.txt: CLI 및 MCP 참조](https://kilobat.app/llms.txt)

2026년 10월 29일 확인했습니다.

## 관련 가이드

- [Mac에서 저데이터 모드 사용하기](https://kilobat.app/ko/guides/low-data-mode-mac): 저데이터 모드는 해당 Wi-Fi 네트워크에서 macOS와 앱의 데이터 사용을 줄이도록 합니다.
- [Mac에서 네트워크를 데이터 요금제 연결로 취급하기](https://kilobat.app/ko/guides/metered-network-mac): macOS는 iPhone 개인용 핫스팟 같은 일부 연결을 데이터 사용 비용이 높은 연결로 표시합니다.
- [다운로드가 끝날 때까지 Mac 잠자기 방지](https://kilobat.app/ko/guides/recipes/keep-mac-awake-download): Kilobat은 전송이 진행되는 동안 Mac의 잠자기를 방지합니다.
- [Mac에서 Homebrew 또는 npm 다운로드 실패](https://kilobat.app/ko/guides/homebrew-npm-download-fails): Homebrew는 curl과 Git으로 다운로드합니다.