99명

최근 30분간 동시 방문자 수를 표시합니다. (~)

최고 동시 방문자 수 -
어제: 0명 / 오늘: 0명

Claude 데스크톱 앱의 개발자 메뉴 켜고 끄기

ClaudeClaude DesktopMCP
한 시간 전
0
0
0

Claude 데스크톱 앱에서 개발자 모드(Developer Mode)를 켤 수 있습니다.
개발자 메뉴는 MCP 서버나 확장 프로그램을 연결하고, 앱이 예상대로 동작하지 않는 원인을 찾을 때 사용합니다.
일반적인 대화나 작업에는 필요하지 않습니다.

개발자 메뉴의 항목

항목 용도
MCP 로그 파일 열기 MCP 서버의 연결 기록과 오류 확인
MCP 구성 새로고침 수정한 MCP 서버 설정을 앱 재시작 없이 다시 읽기
확장 프로그램 확장 프로그램 파일이나 폴더를 직접 설치
앱 설정 파일 열기 MCP 서버 목록이 저장된 claude_desktop_config.json 파일 열기
개발자 설정 파일 열기 개발자 모드 여부가 저장된 developer_settings.json 파일 열기
개발자 도구 표시 앱 화면의 콘솔, 네트워크 요청 등을 크롬 개발자 도구로 확인(Option+Cmd+I)
Enable Main Process Debugger 앱의 메인 프로세스에 디버거를 켜고, 크롬의 chrome://inspect 페이지 열기
Record Performance Trace 앱의 성능 기록 시작, 다시 선택하면 기록을 멈추고 파일로 저장
Record Rendering Trace (rolling) 화면 렌더링 과정을 최근 구간만 남기며 계속 기록, 다시 선택하면 파일로 저장
Write Main Process Heap Snapshot 메인 프로세스의 현재 메모리 상태를 .heapsnapshot 파일로 저장
Record Memory Trace (auto-stop) 메모리 사용 기록을 시작하고, 3분 후 자동으로 멈춰 파일로 저장
Trigger 1Password connect nudge 1Password 연결 안내를 바로 표시(1Password 연동 환경에서만 보임)

영어 항목은 앱 자체를 디버깅하거나 성능과 메모리를 기록하는 기능으로, 앱의 문제를 깊이 추적할 때 사용합니다.
기록 파일은 ~/Library/Logs/Claude/traces 폴더에 저장되며, 저장이 끝나면 Finder에서 파일 위치를 보여 줍니다.
.pftrace 파일은 Perfetto에서, .heapsnapshot 파일은 크롬 개발자 도구의 Memory 탭에서 열어 볼 수 있습니다.

# 켜기

도움말 > 문제 해결 > 개발자 모드 활성화...를 선택합니다.

도움말 > 문제 해결 > 개발자 모드 활성화

개발자 도구와 디버깅 기능에 접근할 수 있다는 확인 창이 나타나면 활성화를 선택합니다.

개발자 모드 확인 창

앱이 자동으로 종료된 후 다시 실행되고, 메뉴 막대에 개발자 메뉴가 나타납니다.
선택 결과는 ~/Library/Application Support/Claude/developer_settings.json 파일에 저장됩니다.

developer_settings.json
JSON
1
2
3
{ "allowDevTools": true }

문제 해결 메뉴에 개발자 모드 활성화... 항목이 없다면 이미 개발자 모드가 켜져 있는 상태이거나, 조직이나 팀 계정에서 관리자가 정책으로 개발자 모드를 허용하지 않아 항목이 보이지 않을 수 있습니다.

# 끄기

클로드 데스크톱 앱에서는 개발자 모드를 끄는 메뉴 항목은 따로 없습니다.
개발자 > 개발자 설정 파일 열기로 developer_settings.json 파일을 열고, allowDevTools 값을 false로 수정한 후 저장합니다.

developer_settings.json
JSON
1
2
3
{ "allowDevTools": false }

파일을 저장해도 개발자 메뉴는 바로 사라지지 않습니다.
메뉴는 앱을 시작할 때 읽은 값으로 표시되기 때문에, Claude > Claude 종료(Cmd+Q)로 앱을 완전히 종료한 후 다시 실행해야 메뉴가 사라집니다.
developer_settings.json 파일을 삭제한 후 다시 실행해도 결과는 같습니다.