TL;DR

  • Claude Mods는 Claude Code가 작업하는 동안 별도 창에서 즐기는 클래식 데스크톱 게임 모음이며, 게임별 플러그인으로 원하는 게임만 설치하는 구조임.
  • 지뢰찾기 플러그인 minefield는 클릭이나 키보드로 보드를 열고, 최고 기록과 커서를 바라보는 얼굴 표시 기능을 제공함.
  • 설치에는 Claude Code 2.1.287 이상과 터미널 또는 Claude Code 데스크톱 앱이 필요하며, 사이드 창과 마우스를 사용하려면 전체 화면 레이아웃을 설정해야 함.
  • 게임 플러그인은 별도 창을 그리고 자체 저장소에 최고 기록을 보관하며, 프롬프트·도구·첨부 파일을 연결하거나 모델이 보는 내용을 읽고 바꾸지 않고 네트워크 호출도 하지 않음.
  • 게임은 엄격한 TypeScript로 작성되며, 플러그인 검증·테스트와 두 버전에서 실행되는 지속적 통합(CI)을 거침.

게임

  • arcade는 Claude가 작업하는 동안 창에서 플레이할 수 있는 클래식 데스크톱 게임을 Claude Code 모드로 제공함.

게임 소개

  • 지뢰찾기 게임은 /mines로 실행하며, 클릭이나 키를 사용해 보드를 열 수 있음.
  • 최고 기록을 저장하고, 커서를 바라보며 가끔 대화 기록 쪽을 흘끗 보는 얼굴 표시 기능을 포함함.
  • 각 게임은 독립된 플러그인이므로 원하는 게임만 설치하면 됨.

설치

  • Claude Code 세션에서 reporails/arcade 마켓플레이스를 추가한 뒤 minefield@reporails-arcade를 설치할 수 있음.
  • 셸에서 claude plugin marketplace add reporails/arcade와 claude plugin install minefield@reporails-arcade를 실행해 설치할 수도 있음.
  • 이미 열려 있는 세션에서는 설치 후 /reload-plugins를 실행하고, /mines 같은 게임 명령을 입력해 실행함.

요구 사항

  • 모드가 기본 활성화된 Claude Code 2.1.287 이상이 필요하며, 실행되지 않는 경우 확인할 사항은 각 게임의 README에 설명돼 있음.
  • 보드를 표시할 터미널 또는 Claude Code 데스크톱 앱이 필요함. VS Code와 claude -p에는 보드를 그릴 화면이 없음.
  • 사이드 창과 마우스를 사용하려면 CLAUDE_CODE_NO_FLICKER=1로 Claude Code를 시작해 전체 화면 레이아웃을 사용해야 함. 이 설정이 없으면 창이 프롬프트 위에 놓이며 키보드만으로 게임을 플레이함.

게임이 볼 수 있는 항목

  • 모드는 창을 그리고 자체 저장소에 최고 기록을 보관함.
  • 프롬프트·도구·첨부 파일을 연결하지 않으므로 모델이 보는 내용을 읽거나 바꾸지 않으며, 네트워크 호출도 하지 않음.
  • 코드가 실행되기 전에 claude plugin validate <game>을 실행하면 해당 게임이 연결하고 호출하는 항목을 정확히 확인할 수 있음.
  • 모델이 읽는 내용에는 CLAUDE.md와 나머지 지침이 포함됨. Claude가 실제로 어떤 지침을 따르는지 확인하는 주소는 reporails.com임.

개발

  • 게임은 엄격한 TypeScript로 작성되며, 각 게임 폴더가 완전한 플러그인임.
  • claude --plugin-dir ./minefield로 체크아웃한 게임을 플레이하고, claude -p "/plugin-types" < /dev/null로 현재 Claude Code 빌드용 타입 정의를 .claude/types/에 생성함.
  • npx -p typescript@5.9.3 tsc -p .는 모든 게임과 테스트의 타입을 검사함.
  • claude plugin validate --strict ./minefield는 플러그인의 연결·호출 항목과 엔진이 거부할 사항을 검사하며, claude plugin test ./minefield는 테스트를 실행함.
  • /plugin-types는 2.1.285에서 로그인 없이 실행되며 CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 설정이 필요함. 2.1.287부터는 claude -p 실행 시 로그인을 요구함.
  • CI는 .github/workflows/check.yml에서 main 브랜치에 대한 푸시와 모든 풀 리퀘스트마다 실행됨. 작업 하나는 2.1.285에서 타입 검사·검증·테스트를 수행하고, 다른 작업은 모드가 기본 활성화된 2.1.288에서 검증과 테스트를 다시 수행함.
  • 타입 정의는 생성되며 저장소에 커밋되지 않음. Claude Code 자체 라이선스가 타입 정의의 재배포를 허용하지 않기 때문임.
  • 새 게임은 새 폴더를 추가하고 .claude-plugin/marketplace.json에 항목 하나를 추가하는 방식임.

라이선스

  • MIT 라이선스이며, Claude Code의 지침 진단 도구를 만드는 Reporails가 제작함.