콘텐츠로 이동

디버깅 (Unity · Node · Python)

AgentManager 는 DAP(Debug Adapter Protocol) 디버거를 내장합니다. 따로 IDE 를 열지 않고 Unity · Node · Python 프로그램을 멈추고 변수를 볼 수 있습니다. 멈춘 상태는 그대로 AI 에게 넘겨 원인을 묻습니다.

프로젝트 화면 상단 툴바의 🐞 Debug 를 누릅니다. 패널은 도킹되며 별도 창으로 떼어 낼 수도 있습니다.

패널 구성:

  • 툴바: 언어 선택 · 포트 · 실행 제어 · 🤖 분석 · 🔴 BP
  • 호출 스택 · 변수 2열
언어 준비물 연결 방법
🎮 Unity .NET 런타임 + VS Code Unity 확장(visualstudiotoolsforunity.vstuc) 열려 있는 Unity Editor 에 자동 attach
🟢 Node Node.js + ~/.vscode/extensions 에 설치한 ms-vscode.js-debug(또는 nightly) 확장. VS Code 에 내장된 사본은 인식하지 않습니다 node --inspect-brk=9229 app.js 로 실행 후 attach
🐍 Python Python + debugpy python -m debugpy --listen 5678 --wait-for-client app.py 로 실행 후 attach

Node 와 Python 은 툴바의 port 칸에 포트를 넣습니다(기본 9229 · 5678). Unity 는 포트가 필요 없습니다.

어댑터를 못 찾으면 무엇이 빠졌는지 알림이 뜹니다.

  • .NET 런타임을 찾지 못했습니다. dotnet 을 설치하세요.
  • VSCode 의 Unity 디버그 확장(visualstudiotoolsforunity.vstuc)이 필요합니다 → 마켓플레이스 열기
  • debugpy 가 설치되지 않았습니다. 터미널에서: pip install debugpy

자동 탐색이 계속 실패하면 Settings > 편집 > Unity 디버그 어댑터 (옵션) 에 어댑터 절대 경로를 지정합니다.

키 동작
F5 계속 실행 (멈춘 상태에서만. 처음 시작은 툴바 Start)
F10 Step Over
F11 Step Into
Shift+F11 Step Out
Shift+F5 Stop

디버그 세션은 프로젝트마다 따로 돕니다. 한 프로젝트의 이벤트가 다른 프로젝트로 섞이지 않습니다. 떼어 낸 창에서는 보기만 되고 조작은 메인 창에서 합니다.

  • 코드 편집기의 줄 번호 영역을 클릭하거나 F9 로 토글
  • 조건부 브레이크포인트와 logpoint 지원
  • 🔴 BP 로 브레이크포인트 목록 패널을 엽니다. 확인된(verified) 것과 미확인(pending) 것을 색으로 구분합니다. 클릭하면 그 줄로, ✕ 로 제거

브레이크포인트는 프로젝트별로 저장돼 앱을 다시 켜도 남습니다.

브레이크포인트에 걸리면:

  • 해당 파일이 자동으로 열리고 멈춘 줄이 노란색으로 표시됩니다.
  • 호출 스택에서 프레임을 고르면 그 프레임의 변수를 봅니다.
  • 편집기에서 변수 위에 마우스를 올리면 값이 툴팁으로 나옵니다.
  • 채팅 위에 파일:줄 에서 멈춤 줄이 뜹니다.

두 가지 방법이 있습니다.

🤖 분석 버튼은 멈춘 상태(스택 + 변수 + 소스 ±15줄)를 claude -p 로 보내 진단을 받습니다. 질문은 선택입니다. 90초 안에 답이 없으면 실패합니다.

채팅 위 멈춤 줄의 Claude 에게 물어보기 는 멈춘 위치를 입력창에 미리 채워 줍니다. 지금 대화에서 이어서 묻고 싶을 때 씁니다. 버튼의 Claude 는 프로젝트 provider 이름으로 바뀝니다.

Unity · C# 프로젝트에서는 C# Language Server 로 코드 탐색을 씁니다.

  • 자동완성 · hover · 정의로 이동
  • F12 정의로 이동, Shift+F12 참조 찾기
  • 프로젝트를 열면 심볼 인덱스를 백그라운드에서 만듭니다. 우측 하단에 C# 심볼 인덱싱… 진행률이 보이고, 끝나면 심볼 인덱스 준비됨
  • 파일이 바뀌면 인덱스를 다시 맞춥니다.

VS Code C# 확장(v2.0 이상)이 있으면 자동으로 찾습니다. 없으면 csharp-ls 를 쓰거나 Settings > 편집 > C# Language Server 에 경로를 지정합니다. 못 찾으면 ✗ C# LSP 미감지 로 표시됩니다.

앱 자체 문제를 볼 때는 Settings > 디버그 탭의 디버그 로그 를 봅니다. 서버 프로세스 출력이 매일 새 파일로 저장되고 14일 보관됩니다. 필터 · 새로고침 · 자동 · 복사 · 폴더 열기 를 지원합니다.