---
title: "Claude Code, Codex, Cursor 및 기타 AI 에이전트에 Kilobat 설정하기"
url: "https://kilobat.app/ko/agents"
description: "Mac에서 AI 에이전트를 Kilobat에 연결하세요. Claude Code, Codex, Hermes, OpenClaw, OpenCode, Copilot CLI 등을 위한 MCP, 스킬 및 실행 추적을 제공합니다."
---

AI 에이전트

# AI 에이전트에 Kilobat 설정하기

Kilobat은 Mac의 네트워크를 코딩 에이전트와 어시스턴트가 사용할 수 있는 도구로 제공합니다. 앱별 트래픽, Wi-Fi, DNS, 호스트 연결 실패 원인, 데이터 제한 여부와 장시간 실행을 위한 잠자기 방지를 확인할 수 있습니다. 에이전트를 선택해 해당 설정 방법을 확인하세요.

무료 CLI 및 MCP 서버 · 설정 13가지 · 확인일: 2026년 10월 30일

## 에이전트 선택

- [Claude Code](https://kilobat.app/ko/agents/claude-code): Claude Code에서 Mac의 네트워크를 도구로 사용하세요. 앱별 트래픽, Wi-Fi, DNS, 호스트 연결 실패 원인과 잠자기 방지를 이용할 수 있습니다.
- [Codex CLI](https://kilobat.app/ko/agents/codex): Codex는 대용량 다운로드 전에 네트워크를 확인하고, 자신의 요청이 멈추는 이유를 찾으며, 긴 작업 중 Mac의 잠자기를 방지할 수 있습니다.
- [Cursor](https://kilobat.app/ko/agents/cursor): Cursor 에이전트가 패키지 다운로드가 멈추는 이유와 연결을 사용 중인 앱을 파악하고, 대용량 다운로드 전에 네트워크의 데이터 제한 여부를 확인하도록 하세요.
- [Gemini CLI](https://kilobat.app/ko/agents/gemini-cli): Gemini CLI는 Mac의 네트워크를 진단하고 Wi-Fi를 검색하며 작업 중 Mac의 잠자기를 방지할 수 있습니다.
- [Claude Desktop](https://kilobat.app/ko/agents/claude-desktop): Claude에게 Wi-Fi가 느린 이유, 핫스팟 데이터를 사용한 항목 또는 VPN이 모든 트래픽을 전달하는지 물어보세요. Mac에서 답을 읽어옵니다.
- [Windsurf](https://kilobat.app/ko/agents/windsurf): Cascade는 Kilobat의 MCP 서버를 통해 의존성이 다운로드되지 않는 이유를 찾고, DNS를 확인하고, Mac에서 경로를 추적할 수 있습니다.
- [Cline](https://kilobat.app/ko/agents/cline): Cline은 Mac의 네트워크를 확인하고 작업 중 잠자기를 방지할 수 있습니다.
- [Zed](https://kilobat.app/ko/agents/zed): Zed 에이전트는 Kilobat의 MCP 서버를 통해 Mac의 네트워크를 측정하고 경로를 추적하며 DNS 리졸버를 비교할 수 있습니다.
- [Hermes Agent](https://kilobat.app/ko/agents/hermes): 로컬 MCP 서버를 통해 Hermes Agent에 Mac의 네트워크 측정, 연결 진단 및 잠자기 방지 도구를 제공하세요.
- [OpenClaw](https://kilobat.app/ko/agents/openclaw): 로컬 MCP 도구와 Kilobat 스킬로 OpenClaw가 Mac의 연결 및 데이터 사용량을 확인하도록 하세요.
- [OpenCode](https://kilobat.app/ko/agents/opencode): OpenCode는 Kilobat으로 Mac의 트래픽을 살펴보고 연결 실패를 설명하며 긴 작업 중 잠자기를 방지할 수 있습니다.
- [GitHub Copilot CLI](https://kilobat.app/ko/agents/copilot-cli): Copilot CLI는 Kilobat의 로컬 MCP 서버를 사용해 Mac의 대역폭, DNS 및 다운로드 실패를 확인할 수 있습니다.
- [모든 MCP 클라이언트](https://kilobat.app/ko/agents/mcp-client): Kilobat의 MCP 서버는 로컬 stdio 명령인 kilobat mcp입니다.

## 한눈에 보기

| 에이전트 | MCP 서버 추가 | 실행 추적 |
|---|---|---|
| [Claude Code](https://kilobat.app/ko/agents/claude-code) | `claude mcp add --scope user kilobat -- kilobat mcp` | 훅 |
| [Codex CLI](https://kilobat.app/ko/agents/codex) | `codex mcp add kilobat -- kilobat mcp` | 알림 또는 훅 |
| [Cursor](https://kilobat.app/ko/agents/cursor) | `mcp.json` | 트래픽 및 CPU |
| [Gemini CLI](https://kilobat.app/ko/agents/gemini-cli) | `gemini mcp add -s user kilobat kilobat mcp` | 훅 |
| [Claude Desktop](https://kilobat.app/ko/agents/claude-desktop) | `.mcpb` 확장 프로그램 또는 `claude_desktop_config.json` | 트래픽 및 CPU |
| [Windsurf](https://kilobat.app/ko/agents/windsurf) | `mcp_config.json` | 트래픽 및 CPU |
| [Cline](https://kilobat.app/ko/agents/cline) | `cline mcp add kilobat --yes -- kilobat mcp` | 플러그인 |
| [Zed](https://kilobat.app/ko/agents/zed) | 설정의 `context_servers` | 트래픽 및 CPU |
| [Hermes Agent](https://kilobat.app/ko/agents/hermes) | `hermes mcp test kilobat` | 수동 이벤트 |
| [OpenClaw](https://kilobat.app/ko/agents/openclaw) | `openclaw mcp add kilobat --command kilobat --arg mcp --approval prompt` | 수동 이벤트 |
| [OpenCode](https://kilobat.app/ko/agents/opencode) | `opencode mcp list` | 트래픽 및 CPU |
| [GitHub Copilot CLI](https://kilobat.app/ko/agents/copilot-cli) | `copilot mcp add kilobat -- kilobat mcp` | 트래픽 및 CPU |
| [모든 MCP 클라이언트](https://kilobat.app/ko/agents/mcp-client) | `kilobat mcp` | 트래픽 및 CPU |

실행 추적은 에이전트가 작업 중인지, 입력을 기다리는지, 완료했는지 Kilobat에 알려 에이전트가 바쁠 때만 Mac의 잠자기를 방지합니다. 훅이 없으면 Kilobat은 에이전트의 트래픽과 CPU를 기준으로 판단합니다. 에이전트와 실행한 명령이 접속한 모든 호스트를 보려면 [에이전트 네트워크 로그](https://kilobat.app/ko/ai-coding-agents)를 확인하세요.

## 모든 설정

1. MCP 서버가 포함된 CLI를 설치하세요.

   ```
   brew install seifip/kilobat/kilobat
   ```
2. `kilobat mcp`를 에이전트에 로컬 stdio 서버로 추가하세요.

   ```
   {
     "mcpServers": {
       "kilobat": {
         "command": "kilobat",
         "args": [
           "mcp"
         ]
       }
     }
   }
   ```
3. 에이전트가 결과를 읽고 설정을 변경하기 전에 묻도록 알려주는 스킬을 추가하세요.

   ```
   npx skills add seifip/kilobat-skills
   ```

Kilobat Pro에서 네트워크 필터를 켜면 보호가 에이전트와 그 에이전트가 시작한 모든 프로세스가 알려진 악성코드, 피싱 및 사기 호스트에 접속하지 못하도록 막고 “차단됨: npm (Claude Code에서 시작)”처럼 접속을 시도한 명령을 알려줍니다. 선택 사항인 에이전트 가드는 붙여넣기 사이트, 터널, 원시 IP 주소 및 새 호스트로의 대용량 업로드도 추가합니다. 에이전트는 `check_host_reputation`로 호스트를 먼저 확인할 수 있습니다. [보호](https://kilobat.app/ko/mac-malware-blocker)을 참조하세요.

개발자를 위해 Kilobat은 각 SSH, Mosh 또는 원격 데스크톱 세션 후에 입력 지연 원인과 Mosh가 도움이 되는 상황을 설명하는 보고서도 작성합니다. 에이전트는 `kilobat remote --json`와 마찬가지로 `get_remote_session_reports`를 사용해 보고서를 읽습니다. [SSH 및 원격 데스크톱](https://kilobat.app/ko/ssh-remote-desktop)을 참조하세요.

읽기 전용 도구는 자유롭게 실행됩니다. 설정을 변경하는 도구에는 파괴적 작업이라는 표시가 있으며 에이전트에게 먼저 사용자에게 묻도록 안내합니다. 모든 도구는 문서의 [AI 에이전트와 MCP](https://kilobat.app/ko/docs/agents#agents)를, 전체 문서를 하나의 Markdown 파일로 보려면 [llms-full.txt](https://kilobat.app/llms-full.txt)를 참조하세요.

에이전트가 자체 제공업체에 반복해서 연결하지 못하면 Kilobat이 제공업체의 문제인지 알려줍니다. 회선은 정상인데 Claude Code, Codex, Copilot, Cursor 또는 Gemini CLI가 연결에 실패하면 에이전트가 사용하는 부분의 제공업체 상태 페이지를 확인하고 “Claude Code: Anthropic이 장애를 보고했습니다. 연결 문제는 아닙니다.”처럼 한 번 알립니다. 에이전트도 `service_status` 도구로 같은 내용을 확인할 수 있습니다. [서비스가 중단되었나요?](https://kilobat.app/ko/is-it-down#ai-agents)를 참조하세요.