설치

패키지 관리자

OS	설치본	포터블
macOS	`brew install --cask kiros33/tap/nexa-clip`	`brew install kiros33/tap/nexa-clip-portable`
Linux	`.deb`(아래 직접 받기)	`brew install kiros33/tap/nexa-clip-portable` 또는 `.tar.gz`
Windows	직접 받기(아래)	직접 받기(아래)

macOS는 brew Cask를 권합니다. 설치 시점에 격리 표식을 떼 주어 경고 없이 바로 실행됩니다.
winget·Chocolatey는 아직 제출하지 않았습니다(v0.1.0~0.1.2). 매니페스트는 릴리스 자산(…-package-manifests.zip)에 함께 올라가 있으며, 제출을 시작하면 이 페이지에 명령을 적겠습니다.

https://github.com/SosomLab/nexa-clip/releases 에서 운영체제에 맞는 파일을 받습니다.

OS	설치본	포터블
Windows x64 / ARM64	`…windows-x64-setup.exe` / `…windows-arm64-setup.exe` (+ 같은 파일의 `.zip`)	`…-portable.zip`
macOS Apple Silicon / Intel	`…macos-arm64.dmg` / `…macos-x64.dmg`	`…-portable.tar.gz`
Linux x86_64	`…linux-x64.deb`	`…-portable.tar.gz`

SHA256SUMS.txt로 받은 파일이 맞는지 확인할 수 있습니다. Linux .deb는 배포판에 매이지 않게(glibc 2.17 기준) 링크돼 있습니다.

배포본은 정식 코드 서명이 없습니다(macOS는 애드혹 서명).

macOS: .dmg로 직접 설치했다면 격리 표식을 떼야 실행됩니다.
```
xattr -dr com.apple.quarantine "/Applications/Nexa Clip.app"
```
Windows: SmartScreen 화면에서 추가 정보 → 실행.

OS	무엇을	언제	비고
macOS	손쉬운 사용(붙여넣기 주입 ⌘V)	첫 실행 또는 첫 붙여넣기 때 대화상자	시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용. 앱을 새로 설치해 서명이 바뀌면 다시 허용해야 할 수 있습니다(문제 해결)
Linux (GNOME/Wayland)	전역 단축키(포털 GlobalShortcuts)	첫 실행 때 승인 창	앱 이름 단위로 저장됩니다
Linux (GNOME/Wayland)	붙여넣기 주입(포털 RemoteDesktop)	첫 붙여넣기 때 승인 창	승인 토큰을 사용자 설정 폴더에 저장해 이후 버전을 올려도 다시 묻지 않습니다(v0.1.2). 상단 바에 "화면 공유" 표시가 뜨는 것은 정상입니다
Windows	방화벽(동기화를 켠 경우)	첫 연결 때	같은 네트워크 직결

OS	설치 위치	데이터
Windows 설치본	`%LOCALAPPDATA%\Programs\NexaClip`(사용자 단위 · 관리자 권한 불필요)	실행 파일 옆 `data\`
macOS	`/Applications/Nexa Clip.app`	`~/Library/Application Support/nexa-clip`
Linux `.deb`	`/usr/bin/nexa-clip` + 앱 메뉴 아이콘 · 자동 시작	`~/.config/nexa-clip`
포터블(전 OS)	푼 폴더	실행 파일 옆 `data/`

데이터 폴더에 설정 · 암호화 이력 · 동기화 신원 키 · 기기 목록 · 승인 상태가 있습니다. 비밀이 실리는 파일은 소유자만 읽을 수 있게(0600) 만듭니다.
두 실행 파일(nexa-clip, nclip-imgdec)이 함께 설치됩니다. 후자는 이미지 디코드를 격리해서 돌리는 보조 프로그램입니다.