# gamedev CLI 레퍼런스 — AI Game Dev 앱 & CLI · AI Game Developer Wiki

모든 gamedev CLI 명령과 옵션: 대화형 및 헤드리스 모드, pkg, remote, daemon, acp, image-runtime, update, 그리고 터미널의 슬래시 명령을 다룹니다.

이 페이지는 영어에서 기계 번역되었습니다. [영어 원문 읽기](https://ai-game.dev/docs/wiki/app/cli).

`gamedev` CLI는 터미널에서 사용하는 AI Game Dev 에이전트로, 데스크톱 앱과 동일한 계정, 모델, 패키지, 엔진 연결을 사용합니다. 이 레퍼런스는 CLI의 모든 명령과 옵션, CLI 안에서 입력하는 슬래시 명령, 종료 코드를 정리합니다. `npm install -g @baizor/gamedev`로 설치하세요([설치](https://ai-game.dev/ko/docs/wiki/app/installation#cli) 참고).

## 한눈에 보는 사용법

```text
gamedev [<project-dir>] [options]          interactive terminal UI
gamedev --print "<prompt>"                 headless one-shot query, reply on stdout
gamedev --print -                          headless, prompt read from stdin
gamedev --headless                         headless, prompt read from stdin
gamedev update                             upgrade the CLI to the latest version
gamedev pkg <subcommand> [args]            manage packages, then exit
gamedev image-runtime [status|start]       the local image runtime
gamedev remote <subcommand> [args]         remote access and your other devices
gamedev daemon <subcommand>                the background service
gamedev --on <name|id-prefix>              the terminal UI on another computer's chats
gamedev acp [--model <model>]              Agent Client Protocol agent on stdin/stdout
gamedev --help | --version
```

## 옵션

| 옵션 | 의미 |
| --- | --- |
| `<project-dir>` | 프로젝트 폴더(`--project`와 동일); 상대 경로는 현재 디렉터리를 기준으로 해석됩니다 |
| `--project`, `-p <path>` | 프로젝트 폴더(기본값: 현재 디렉터리) |
| `--cwd <path>` | `--project`의 별칭 |
| `--model <model>` | 사용할 모델(기본값: 계정에 할당된 모델) |
| `--resume`, `-r <id>` | 이전 세션 이어서 하기 |
| `--print <prompt>` | 비대화형: 프롬프트를 보내고 응답을 stdout으로 스트리밍한 뒤 종료합니다. `-`는 stdin을 읽습니다 |
| `--headless` | 비대화형 모드 강제, stdin에서 프롬프트 읽기 |
| `--on <name>` | 페어링된 다른 컴퓨터의 채팅으로 터미널 UI 열기 |
| `--help`, `-h` | 도움말 표시 |
| `--version`, `-v` | 버전 출력 |

`--project`와 `--cwd`는 위치 인자로 지정한 폴더보다 우선합니다.

## 대화형 모드

프로젝트 폴더에서 `gamedev`를 실행하세요. 요청을 입력하고 Enter를 누릅니다. 유용한 키:

- `/`를 누르면 슬래시 명령 팔레트가 열립니다; 화살표 키로 이동하고 Tab으로 명령 이름을 완성합니다.
- 응답이 스트리밍되는 중에 Esc를 누르면 중단됩니다.
- Ctrl+C로 종료합니다(확인하려면 두 번 누르세요).
- 입력창에서 Space를 약 3분의 1초 동안 누르고 있으면 말할 수 있습니다(누르고 말하기 음성 입력).

터미널이 없으면(파이프 입력) CLI는 간단한 라인 모드로 전환됩니다.

## 헤드리스 모드와 스크립팅

헤드리스 실행은 응답만 stdout에 출력하며, CLI가 감지한 내용(예: "Unity project detected")은 stderr로 전달됩니다.

```bash
gamedev --print "List every scene in this project"
echo "Summarise the open TODOs in Assets/Scripts" | gamedev --headless
gamedev --project ./MyGame --model <model-id> --print "Run the edit-mode tests"
```

| 종료 코드 | 상황 |
| --- | --- |
| `0` | 응답이 완료됨 |
| `1` | 쿼리, 네트워크 또는 에이전트 오류, 또는 실행이 시작된 후의 Ctrl+C |
| `2` | 로그인하지 않음, 빈 프롬프트, 또는 사용할 수 없는 폴더나 플래그 |
| `130` | 실행이 시작되기 전의 Ctrl+C; 아무것도 전송되지 않음 |
| `143` | SIGTERM; CLI가 분리되고 이미 전송된 프롬프트는 백그라운드 서비스에서 계속 실행됩니다 |

## gamedev pkg

현재 디렉터리(또는 `--cwd <path>`)에 있는 프로젝트의 [패키지](https://ai-game.dev/ko/docs/wiki/app/packages)를 관리합니다. 레벨 플래그: `--user`(이 컴퓨터의 모든 프로젝트), `--project`(커밋됨, 기본값), `--local`(이 체크아웃에만).

```text
gamedev pkg list [--user]                      packages in effect (--user: the user level alone)
gamedev pkg add <input> [level]                <publisher.name>[@range] | github:<owner>/<repo>[@tag|#ref] | npm:<name> | file:<path> | URL | owner/repo | folder
gamedev pkg remove <id> [level]                delete the id's entry at that level
gamedev pkg exclude <id> [level]               turn the package off at that level
gamedev pkg include <id> [level]               undo exclude
gamedev pkg update [<id>] [--user]             newest compatible version within the declared range, now
gamedev pkg auto-update on|off <id>            this computer's auto-update preference for one package
gamedev pkg sync [--user]                      make locks and cache match the level files
gamedev pkg link <folder> [level]              use a local folder instead of the published version (default --local)
gamedev pkg unlink <id> [level]                stop using the local folder
gamedev pkg dev <folder> [level]               link, and rebuild on every source change until Ctrl+C
gamedev pkg settings <id> [<key> [<value>]]    read or write a package's settings (--unset clears a value)
```

`gamedev pkg settings`는 값이 거부되면 종료 코드 1, 사용법 오류면 2로 종료합니다. `link`와 `dev`는 [패키지 만들기](https://ai-game.dev/ko/docs/wiki/app/creating-packages#develop)를 참고하세요.

## gamedev image-runtime

```text
gamedev image-runtime status [--json]    show this computer's local image runtime coordinator
gamedev image-runtime start [--json]     start it through the background service
```

모델 자체는 CLI 안에서 `/images`로 관리합니다(아래 참고).

## gamedev remote

같은 계정으로 로그인한 컴퓨터와 기기 간의 원격 접속입니다. 대화형 CLI의 `/remote`는 같은 명령입니다.

```text
gamedev remote status                         this computer and your other devices
gamedev remote pair                           show a pairing code and QR, then approve the device that enters it
gamedev remote join <device> <code>           pair with another computer
gamedev remote allow [<device>]               allow remote control here, or let a device control chats
gamedev remote allow <device> --services      let a device use this computer's shared models
gamedev remote block [<device>] [--services]  turn remote control off, or take a device's access away
gamedev remote share [on|off]                 share this computer's models with your other computers
gamedev remote share pause|resume             stop or resume accepting images from other computers
gamedev remote forget <device>                unpin a computer you paired with
gamedev remote revoke <device>                remove a device paired with this computer
gamedev remote rename <name>                  the name your other devices see
```

기기는 이름 또는 id의 시작 부분으로 지정합니다. `pair`는 보기, 제어, 공유 모델에 대해 각각 묻습니다. 그런 다음 `gamedev --on <device>`로 해당 컴퓨터의 채팅을 엽니다; `/machine`은 컴퓨터 목록을 보거나 전환하고 `/machine this`는 이 컴퓨터로 돌아옵니다.

## gamedev daemon

데스크톱 앱과 CLI가 공유하는 백그라운드 서비스입니다.

```text
gamedev daemon status       installed and running; the Kernel, account, remote access, logs
gamedev daemon install      run it as a per-user OS service that starts at login and restarts if it stops
gamedev daemon uninstall    remove the OS service
gamedev daemon start        start the background service
gamedev daemon stop         stop it
gamedev daemon restart      stop, then start
gamedev daemon logs [kernel|service|remote|auth] [--lines N] [--follow]
```

OS 서비스는 macOS에서는 LaunchAgent, Linux에서는 systemd 사용자 유닛, Windows에서는 로그온 시 실행되는 Task Scheduler 작업이며 관리자 권한이 필요 없습니다.

## gamedev acp

`gamedev acp`는 CLI를 T3 Code, Zed, JetBrains IDE 같은 ACP 클라이언트를 위한 Agent Client Protocol 에이전트로 전환합니다. 클라이언트가 이를 실행하며, 프로토콜 메시지는 stdout을 사용하고 진단은 stderr로 전달됩니다. 클라이언트에서 명령 `gamedev`와 인자 `acp`로 사용자 지정 에이전트를 추가하세요. 이 컴퓨터의 로그인, 계정의 모델, 프로젝트의 엔진 도구를 사용합니다. [T3 Code에서 AI Game Dev를 ACP 에이전트로 사용하기](https://ai-game.dev/ko/blog/acp-agent-t3-code) 포스트에서 설정 과정을 안내합니다.

## 슬래시 명령

대화형 CLI 안에서 입력합니다. 대부분은 데스크톱 채팅에서도 작동합니다.

### 채팅 및 세션

| 명령 | 설명 |
| --- | --- |
| `/help` | 사용 가능한 명령 목록 표시 |
| `/clear` | 새 대화 시작 |
| `/reset` | 현재 세션 초기화 |
| `/reopen` | 저장된 기록에서 손실된 채팅 다시 열기(아무것도 다시 전송되지 않음) |
| `/saved` | 저장된 메시지, 설정, 이미지, 파일 또는 Git 변경 사항 복구 |
| `/model` | 모델 선택(Tab: 추론 강도) |
| `/agent` | 에이전트 목록 표시; `/agent use <id>`로 전환, `/agent refresh`로 목록 새로고침 |
| `/skills` | 이 프로젝트에서 사용 가능한 스킬 목록 표시 |
| `/context` | 컨텍스트 디버그 패널 전환 |
| `/exit` | 종료(`/quit`도 동일) |

### 계정, 설정 및 업데이트

| 명령 | 설명 |
| --- | --- |
| `/login [--switch]` | 로그인; `--switch`는 이 컴퓨터의 계정을 변경합니다 |
| `/logout` | 로그아웃 |
| `/config` | 이 세션의 **Tools**를 포함한 설정 |
| `/permissions` | AI가 도구를 실행하기 전에 언제 물어볼지 표시하거나 변경 |
| `/voice-language` | 음성 전사 언어 설정 |
| `/update [now]` | CLI 업그레이드 방법, `now`는 대기 중인 백그라운드 서비스를 업데이트 |
| `/remote`, `/machine` | 원격 접근, 컴퓨터 목록 표시 또는 전환 |

### 엔진과 프로젝트

| 명령 | 기능 |
| --- | --- |
| `/install-plugin [path]` | 현재 Unity, Godot 또는 Unreal 프로젝트에 MCP 플러그인 설치 |
| `/install-extension` | 엔진 확장 기능 탐색 및 설치 |
| `/open` | 현재 프로젝트의 에디터 열기 |
| `/create-project` | 새 게임 프로젝트 생성, 예를 들어 `/create-project unity MyGame` (엔진 `unity`, `godot` 또는 `unreal`, 이름, 선택적 상위 폴더) |
| `/file` | 프로젝트 파일 생성, 이름 변경, 이동, 복사 또는 삭제 |
| `/files [n]` | 이 채팅에서 언급된 파일 목록 표시, 파일 열기 |
| `/search`, `/replace` | 프로젝트 검색, Search Replace 저장·적용·복구 |
| `/git` | 상태, 스테이징, 커밋, 변경 폐기, 풀, 푸시, 강제 푸시 및 init |

### 확장 기능, 패키지 및 모델

| 명령 | 기능 |
| --- | --- |
| `/packages` | `gamedev pkg`와 동일한 하위 명령에 `views`, `tree <view id>`, `runs`, `cancel`, `reload` 추가 |
| `/mcp` | 프로젝트의 MCP 서버 관리: 추가, 활성화, 제거, 테스트 |
| `/plugin` | Claude 플러그인 및 마켓플레이스 관리: 설치, 활성화, 업데이트 |
| `/images` | 로컬 이미지 모델, 다운로드 및 저장 공간 (`/images help`) |
| `/image [n]` | 이 세션의 이미지 목록 표시, 이미지 열기 또는 제거 |
| `/models` | 로컬과 클라우드에서 미디어 모델을 실행하는 모든 방법, `image`, `video`, `audio` 또는 `3d` 추가 (`/models help`) |
| `/cloud` | 이 세션의 Cloud 생성 설정: `ask`, `budget <percent>` 또는 `off` |
| `/blender`, `/supercollider`, `/kb` | Blender, Music 및 Knowledge Base 패키지의 명령 |

설치된 패키지는 슬래시 명령을 더 추가할 수 있으며, `/` 팔레트에 표시됩니다.

### /images 하위 명령

```text
/images                               this computer, the runtime, storage and every image model
/images download <model> [--yes]      download a model (and the runtime when missing); asks first
/images cancel|resume <model|runtime> stop or continue a download
/images update <model> [--yes]        download a model's update
/images delete <model> [--yes]        delete a model's files from this computer
/images allow|block <model> [--user|--project]   whether the agent may use it
/images default <model|auto>          the default image model (auto = recommended for this computer)
/images stop [session|<job id>]       stop image generation and free the GPU
/images free-space [--yes]            delete model files no model uses any more
/images storage [<new folder>]        show or move the model storage folder
/images redetect                      detect the GPU, memory and driver again
/images reinstall                     set the image runtime up again
```

## 환경 변수

| 변수 | 용도 |
| --- | --- |
| `AI_GAME_DEV_MODEL` | 기본 모델 재정의 |
| `AI_GAME_DEV_ASCII_GLYPHS` | `1`로 설정하면 이모지를 잘못 측정하는 터미널에서 `/model` 선택기의 미터를 ASCII로 강제합니다 |

설정 우선순위: 명령줄 옵션, 그다음 환경 변수, 그다음 `~/.ai-game-dev/config.json`.

## 관련 항목

- 엔진 플러그인에는 자체 CLI가 있습니다: [`unity-mcp-cli`](https://ai-game.dev/ko/docs/wiki/unity/cli), [`unreal-mcp-cli`](https://ai-game.dev/ko/docs/wiki/unreal/cli), [`godot-cli`](https://ai-game.dev/ko/docs/wiki/godot/cli).
- 실제 오류와 종료 코드는 [Troubleshooting](https://ai-game.dev/ko/docs/wiki/app/troubleshooting)을 참고하세요.

---

Source (HTML): https://ai-game.dev/ko/docs/wiki/app/cli

Machine-translated (ko) from the English page: https://ai-game.dev/docs/wiki/app/cli