---
title: "Minefield: Claude Code 패널 속 지뢰찾기 미니게임"
url: "https://claudemods.dev/ko/builds/minefield-566d1f"
source: "https://github.com/reporails/arcade/tree/main/minefield"
source_type: "github"
repo: "https://github.com/reporails/arcade/tree/main/minefield"
author: "reporails"
author_handle: "reporails"
stars: 6
category: "게임 및 엔터테인먼트"
categories: ["games", "input", "notifications", "themes", "tools"]
tags: ["claude-code-mod", "game", "keyboard", "minesweeper", "mouse", "pane", "plugin"]
permission_level: 0
scan_complete: true
install: "/plugin marketplace add reporails/arcade\n/plugin install minefield@reporails-arcade"
added: "2026-10-04T10:40:37.691Z"
updated: "2026-10-16T13:11:50Z"
locale: "ko"
content_locale: "ko"
---

# Minefield: Claude Code 패널 속 지뢰찾기 미니게임

세션 사이드 패널에서 지뢰찾기를 실행하는 Claude Code 플러그인 mod: Claude가 작업하는 동안 마우스나 키보드로 플레이하며, 타이머, 최고 기록, 보드를 보고 대화를 훔쳐보는 표정 얼굴이 포함됩니다.

## Description

Minefield는 플러그인 형태로 배포된 Claude Code mod입니다. `/mines`를 실행하면 Claude Code 패널에서 9×9, 지뢰 10개인 지뢰찾기가 열리고, Claude가 작업하는 동안 마우스나 키보드로 플레이할 수 있습니다. 모델이 보는 내용을 읽거나 변경하지 않으며, `claude plugin validate`는 연결된 모든 이벤트와 호출을 나열합니다. prompt, tool 또는 attachment hook이 없고 네트워크 요청도 없습니다. 왼쪽 클릭으로 열기, 오른쪽 클릭/ctrl+alt+왼쪽 클릭으로 깃발 꽂기, `r`/`f`/`w`/`a`/`s`/`d`/`n` 등의 키 조작을 지원하며, 첫 번째 열기는 항상 안전하고 영역을 펼칩니다. 타이머는 첫 번째 열기부터 마지막까지 측정되고, 최고 기록은 플러그인 자체 store에 저장됩니다. 보드는 Claude Code 테마의 주황색으로 표정 얼굴을 그리며 게임 상태에 따라 변합니다: 움직임, 눈 깜빡임, 패널 옆 대화 훔쳐보기, 넓은 영역을 열 때의 놀람, 지뢰를 밟았을 때의 `x   x`, 클리어 후의 선글라스 웃는 얼굴. 사이드 패널과 마우스는 전체 화면 레이아웃이 필요합니다(`CLAUDE_CODE_NO_FLICKER=1` 또는 `/tui fullscreen`). Claude Code 2.1.287 이상이 필요합니다. Reporails 제작, MIT 라이선스.

## Install

```
/plugin marketplace add reporails/arcade
/plugin install minefield@reporails-arcade
```

## Original README

# Minefield

![Minefield docked beside a Claude Code session: the board in big tiles, the face looking over at Claude's answer](https://raw.githubusercontent.com/reporails/arcade/main/docs/minefield.png)

Minesweeper in a Claude Code pane. A mod, shipped as a plugin: `/mines` opens a board you play with the mouse or the keys while Claude works. It reads and changes nothing the model sees: `claude plugin validate ./minefield` lists every event it hooks and every call it makes, before any of its code runs.

```text
❯ ./register.ts hooks: session.start, command.run{command=mines}, ui.render{component=Pane}, ui.message
❯ ./register.ts calls: $.clock.after (via focusSoon), $.clock.now (via deal), $.command.register, $.session.surfaces, $.store.get, $.store.set (via recordWin), $.ui.invalidate, $.ui.open (via openPane), $.ui.panes (via refocus), $.ui.resolve
❯ ./register.ts surface modules: hooks/board.ts
```

No prompt, tool or attachment hook, and no network call.

```text
               1  ▆▆ ▆▆ ▆▆
               2  ⚑  ▆▆ ▆▆
               2  ▆▆ ▆▆ ▆▆
               1  1  ▆▆ ▆▆
1  1  1           1  ▆▆ ⚑
▆▆ ▆▆ 2  2  1  1  1  ▆▆ ▆▆
▆▆ ▆▆ ▆▆ ▆▆ ▆▆ ▆▆ ▆▆ ▆▆ ▆▆
▆▆ ▆▆ ▆▆ ▆▆ ▆▆ ▆▆ ▆▆ ▆▆ ▆▆
▆▆ ▆▆ ▆▆ ▆▆ ▆▆ ▆▆ ▆▆ ▆▆ ▆▆

 ▄▄▄▄▄▄▄
  ●   ●    Mines 8 · Time 0:17 · Best 0:42 · By Reporails
    ω      34 safe cells left.
 ▀▀▀▀▀▀▀
```

## Install

In a Claude Code session:

```text
/plugin marketplace add reporails/arcade
/plugin install minefield@reporails-arcade
```

Or from your shell, then `/reload-plugins` in any session already open:

```bash
claude plugin marketplace add reporails/arcade
claude plugin install minefield@reporails-arcade
```

Then run `/mines`. To play from a checkout instead: `claude --plugin-dir ./minefield`.

Mods need Claude Code 2.1.287 or later, where they are on by default. For the side pane and the mouse, start Claude Code with `CLAUDE_CODE_NO_FLICKER=1`: that is the fullscreen layout, the one where Claude Code reports the mouse, and the pane docks on the right beside the transcript and takes clicks. Without it the pane sits above the prompt and the game is played with the keys alone.

## Commands

| Input | What it does |
|---|---|
| `/mines` | Opens the pane. If a game is in play, it stays as it is. |

One board, 9×9 with 10 mines: a game for the few minutes Claude works.

`/mines` is an immediate command, so it works while Claude is mid-turn.

## Playing

| Input | What it does |
|---|---|
| Left click | Reveals the cell. On an open number with all its flags set, opens the cells around it. |
| Right click, or ctrl/alt + left click | Sets or clears a flag. |
| `r` | Reveals the cell under the cursor. |
| `f` | Flags the cell under the cursor. |
| `w` `a` `s` `d` | Move the cursor. |
| `n` | New game. |
| Arrow keys, `h` `j` `k` `l`, space, return | Move and reveal, once a click has given the board the keyboard. |
| `Esc` | Hands the keyboard back to the prompt; the game stays. `ctrl+x tab` gives the pane the keys again. Close the pane with its `✕` or `ctrl+x x`. |

The letter keys work as soon as `/mines` has opened the pane; nothing needs a click first. The mouse needs the fullscreen layout (`/tui fullscreen` turns it on); the line under the buttons says which you have.

The board grows into the room the pane has. Docked beside the transcript, it is drawn as big square tiles, three rows a cell where the pane is tall enough, two where it is not, and one in a short terminal. Above the prompt, where rows are few, a cell is one row, its hidden tile a smaller box, and the face and the status move beside the board instead of under it, so nothing is cut off.

The first reveal is always safe and opens an area: the mines are laid after it, away from that cell and the eight around it. The clock runs from the first reveal to the last. The best time is kept between sessions in the plugin's own store.

Closing the pane ends the game in play.

The status line ends with a **By Reporails** link to the [Reporails CLI](https://github.com/reporails/cli) on GitHub. Your terminal opens it; the mod itself makes no network call.

## The face

A face under the board shows how the game is going, drawn in Claude Code's own orange (the theme's `claude` colour, so it follows your theme). It is this mod's own drawing; the Claude logo at the top of a session is not something a mod can redraw.

| When | The face |
|---|---|
| You are playing | Follows the cursor to its side of the board. |
| Two seconds without a move | Looks around: up at you, at the cursor's side, or left at the transcript beside the pane. |
| Six seconds without a move | Reads the transcript, as far as a face can: eyes half shut, following a few lines along in short steps and jumping back to each line's start. It only looks; the mod sees nothing of the transcript. |
| Always | Blinks every few seconds, sometimes twice, often as its gaze jumps. The mouth leans after the eyes. |
| A reveal | Wide eyes and a round mouth; delight when a reveal opens ten cells or more. |
| A flag | A wink. |
| Stepped on a mine | `x   x` and a flat mouth. |
| Board cleared | Delight, then sunglasses and a wide grin. |

## Files

```text
minefield/
├── .claude-plugin/plugin.json
├── hooks/
│   ├── hooks.json      points at register.ts
│   ├── register.ts     the hooks: the command, the pane, the buttons, the best time
│   ├── board.ts        the surface module: draws the board and the face, takes the pointer and keys
│   └── lib.ts          pure functions: the game rules, the cell styles, parsing
├── tests/minefield.test.ts  runs with `claude plugin test`
└── README.md
```

The game lives in the board's local state. The hooks module deals the game, its mines laid from the time it is dealt, hands down the best time, and draws the buttons; the board posts back a win.

Four things a live session showed that the test kit did not:

- A pane takes the keyboard only over an empty prompt, and a command's own text is still there while it runs. So `/mines` opens the pane, then asks for the keyboard again, up to three times over the next two seconds, only while the pane is open and still without it.
- A pane's hotkeys reach only buttons the hooks module draws, not buttons a surface module draws. So the control buttons live in `register.ts` and hand each move to the board as a numbered `act` prop.
- A row of boxes shrinks every box to fit, and a face one column short wraps each of its rows in two. So the face's column has a fixed width and the text beside it is the part that gets cut.
- The mouse exists only in the fullscreen layout: on the main screen Claude Code asks the terminal for no pointer reporting at all. So every action has a key, and the letter keys work the moment the pane opens.

The face runs on the board's own timer, five beats a second, as pure functions in `lib.ts` (`nextMood`, `attend`, `react`, `looks`) driven by a die seeded from the deal, so the tests replay it exactly. The board's size is one pure function too (`fitFor`), from the pane's columns and rows.

## Tested on

- Claude Code 2.1.288, where mods are on by default: `claude plugin validate --strict` passes and `claude plugin test` passes 31 of 31, from a logged-out config, the way CI runs them.
- Claude Code 2.1.285: strict `tsc` passes on the code and the tests against that build's typings, and the same 31 tests pass. CI runs both builds. The tests cover the rules (safe first reveal, numbers, flags, opening around a number, winning, losing, the clock), the face's gaze, reading, blinks and reactions, the board's fit to the pane and the pane's size, and the mod driven through its pane on the terminal and desktop surfaces: pointer, keys, buttons, `/mines` bringing back the game in play, a win stored as the best time.
- Played in the terminal in both layouts, through a loss; the big tiles, the face's reading and its blinks watched live in a docked pane. A win and its stored best time are covered by the tests, since a live win writes to the real store.
- Not yet tried: the desktop app outside the test kit.

## If it does not start

- `claude --version` must be 2.1.287 or later.
- `/plugin` shows a dim `mod active` line naming the mods that loaded. If minefield is not on it, run `claude plugin test` in an empty folder: `no hooks module to load` means mods load for you; `hooks modules are turned off` means Anthropic has them off for your account, and no local setting changes that. An organization can also limit which mods load (`allowManagedModsOnly`).
- In VS Code's chat panel and `claude -p` there is nothing to draw a board on; `/mines` says so.

Made by [Reporails](https://reporails.com/?utm_source=arcade&utm_medium=readme), diagnostics for the instructions that steer Claude Code. MIT.
