맥·모바일 개발Mac & mobile

macos-tcc-automation-permissions

macOS 무인 자동화가 권한이 풀려도 살아남게 하고, 암호 같은 오류 코드를 해석하는 경험 정리입니다.

어떤 문제를 푸나The problem

macOS는 자동화, 손쉬운 사용, 화면 기록 권한을 실행한 앱에 묶고, Homebrew나 Python 업그레이드가 그 권한을 조용히 지웁니다. 이 문서는 AppleScript 오류 코드를 해석하는 법과 launchd 작업에서 권한을 안정적으로 유지하는 서명된 런처 방식을 설명합니다.

실제 입력과 합성 입력의 차이, CJK 입력기에서 콘솔에 글자를 넣는 방법, 진단을 먼저 하고 보고하는 순서도 담았습니다.

이런 분께 맞습니다Who it is for

launchd나 AppleScript로 브라우저·화면·키 입력을 자동화하다가 권한 오류를 겪은 사람.

무엇을 하나What it does

오류 해석표: 자동화 거부(-1743), 손쉬운 사용 부족, 화면 기록 부족을 구분합니다.
서명된 작은 런처 앱이 작업을 자식 프로세스로 띄우면 인터프리터가 바뀌어도 권한이 유지됩니다.
실제 OS 입력과 합성 입력이 다르게 반응하는 경우와 조심할 점을 정리했습니다.
CJK 입력기가 켜져 있을 때 콘솔에 값을 넣는 방법과 진단 순서를 적었습니다.

알아둘 한계Limits

최근 macOS에서 본 경험이며 권한 화면의 문구와 오류 코드는 버전마다 다릅니다.
권한은 사람이 부여해야 하며 프로그램이 스스로 부여할 수 없습니다.

받아서 쓰기Get it

# 저장소를 받습니다
git clone https://github.com/Kein-chronicle/macos-tcc-automation-permissions.git

# Claude Code 스킬로 쓰려면 이 폴더 이름으로 받습니다
git clone https://github.com/Kein-chronicle/macos-tcc-automation-permissions.git ~/.claude/skills/macos-automation-permissions

정보Info

분류Category: 맥·모바일 개발Mac & mobile
형태Type: 지식 문서Knowledge pack
라이선스License: MIT
필요한 것Requires: 없음 (SKILL.md를 읽기만 하면 됩니다)
저장소Repository: macos-tcc-automation-permissions
토픽Topics: macos tcc applescript launchd automation accessibility claude-code claude-skills

2026-10-18 기준: 저장소의 테스트를 로컬에서 실행해 통과했고, 예제 출력은 저장소의 examples 폴더를 실제로 실행한 결과입니다.