한국어 · English
읽던 문장을 선택하고 ⌘C를 두 번. 쓰던 AI 구독으로 번역하는 Mac 메뉴 막대 앱입니다.
brew install --cask Geuni620/tap/deepk다른 앱에서 텍스트를 선택하고 ⌘C를 두 번 누르면 번역 창이 열립니다. 번역문을 복사하거나 원래 입력 위치에 명시적으로 삽입할 수 있습니다. ChatGPT로 로그인한 Codex CLI 또는 Claude 구독으로 로그인한 Claude Code를 사용해 한국어와 영어를 번역합니다.
Apple Silicon Mac과 macOS 15 이상이 필요합니다. Intel Mac용 파일은 아직 제공하지 않습니다.
Homebrew
brew install --cask Geuni620/tap/deepk직접 내려받기
최신 릴리스에서 deepK-distribution-*.zip을 내려받아 압축을 풀고 deepK.app을 응용 프로그램 폴더로 옮깁니다. Developer ID로 서명하고 Apple 공증을 받은 앱입니다. 함께 올린 .sha256 파일로 내려받은 파일을 확인할 수 있습니다.
shasum -a 256 deepK-distribution-*.zip설치 후 번역에 사용할 Codex CLI 또는 Claude Code를 설치하고, 이 Mac에서 구독 계정으로 로그인한 뒤 처음 사용할 때를 따릅니다. 제공자의 구독 조건과 사용량 제한은 별도로 적용됩니다.
업데이트와 삭제
- Homebrew: 앱을 종료한 뒤
brew update && brew upgrade --cask Geuni620/tap/deepk - 직접 내려받기: 새 릴리스의 앱으로 교체. 0.1.1부터 배포 이름은
deepK.app이며, 이전 릴리스의DeepK.app과 중복으로 실행하지 않습니다. - 삭제:
brew uninstall --cask Geuni620/tap/deepk또는 응용 프로그램 폴더에서deepK.app(이전 릴리스는DeepK.app) 삭제
초기 배포 단계의 앱입니다. 번역 속도는 제공자·모델·입력에 따라 달라집니다.
- 원문 입력과 자동 번역, 자동·수동 언어 방향 선택
- 코드 블록·인라인 코드·링크를 유지하는 결과 표시와 복사
- 구분선(
---)으로 나눈 문단의 이어서 번역 - 메뉴 막대 상주, 원래 앱 복귀와 명시적 삽입
deepK는 메뉴 막대에 상주하는 앱입니다. 실행해도 Dock 아이콘은 나타나지 않고, 화면 오른쪽 위 메뉴 막대에 아이콘이 추가됩니다. 처음 실행했을 때 단축키 권한이 준비되지 않았으면 설정 창이 한 번 열립니다.
- 응용 프로그램 폴더에서 deepK를 열거나 터미널에서
open /Applications/deepK.app을 실행한 뒤, 메뉴 막대의 deepK 아이콘을 찾습니다. - 메뉴 막대에서 설정을 열고 Codex 또는 Claude Code를 선택한 뒤 연결을 확인합니다.
- 설정 → 일반 → 권한에서 입력 모니터링의 ‘설정 열기…’를 누릅니다. 함께 열리는 안내 창의 deepK 아이콘을 시스템 설정 목록으로 끌어다 놓고 스위치를 켭니다. 원래 위치 삽입에 필요한 손쉬운 사용 권한도 같은 방법으로 허용합니다.
- 다른 앱에서 텍스트를 선택하고 ⌘C를 두 번 누릅니다. 직접 입력으로도 번역할 수 있습니다.
- 번역문을 확인한 뒤 복사하거나 삽입합니다. 앱 종료는 메뉴의 종료 또는 ⌘Q입니다.
새 설치에서는 두 번 복사 자동 번역이 켜져 있습니다. 설정에서 끌 수 있습니다. 권한을 허용한 뒤에도 입력 감시가 연결되지 않으면 설정 → 일반 → 권한의 ‘감시 다시 연결’이나 ‘앱 다시 열기…’를 사용합니다. 소스에서 실행하는 개발 앱은 deepK Dev로 표시되며, 설치된 deepK와 권한·앱 설정이 분리됩니다.
실행해도 아무것도 보이지 않을 때
- 메뉴 막대 아이콘이 많으면 deepK 아이콘이 노치나 다른 아이콘 뒤로 가려질 수 있습니다. 메뉴 막대 아이콘 일부를 숨기거나 정리한 뒤 다시 확인합니다.
- 이전 릴리스의
DeepK.app이 남아 있으면 새deepK.app과 함께 실행하지 않습니다.pgrep -ifl deepk로 실행 중인 앱 경로를 확인하고, 이전 앱을 메뉴의 종료로 끈 뒤 삭제합니다. - 시스템 설정 목록에 deepK가 둘 이상 보이면 실제로 사용하는
/Applications/deepK.app의 권한을 켭니다. 개발 앱은deepK Dev로 따로 표시됩니다.
번역 지시와 원문을 선택한 제공자에게 보냅니다. deepK는 사용자가 로그인한 공식 CLI를 이용하며 다른 제공자나 API 키 과금으로 자동 전환하지 않습니다. 인증정보·로컬 환경 파일·서명 키는 저장소에 포함하지 않습니다.
- Codex 전역 지침:
~/.codex/AGENTS.md가 있으면 그 내용도 요청에 포함됩니다. 회사 기밀·토큰을 전역 지침에 넣지 마세요. 프로젝트 지침과 설치된 스킬 차단은 이 전역 파일을 제거하지 않습니다. - 민감한 복사: 비밀번호 관리자가 숨김·임시 표시를 붙인 복사는 거절합니다. 표시가 늦게 붙거나 표시가 없는 복사, 원문 창에 직접 붙여넣은 내용까지 보호하지는 못합니다. 실제 비밀번호 관리자별 검증은 남아 있습니다.
- 번역 캐시: 성공한 결과를 메모리에 최대 32개·5분간 보관하며 앱 재시작 시 비워집니다.
- 검증 범위: 오프라인 테스트·합성 요청 검증과 실제 계정·앱·권한 검증을 구분합니다. 전체 실환경 보안 검증 완료를 뜻하지 않습니다.
환경 변수 전달 범위는 개발 안내, 알려진 한계는 보안 점검 기록을 참고하세요. 원문·토큰·인증 파일을 공개 이슈나 로그에 올리지 마세요.
macOS 15 이상, 전체 Xcode와 Swift 6가 필요합니다. 기존 검증 환경은 Xcode 26.1.1 / Swift 6.2.1입니다. 사용할 제공자의 CLI를 별도로 설치하고 해당 Mac에서 구독 계정으로 로그인해야 합니다.
git clone https://github.com/Geuni620/deepK.git
cd deepK
./scripts/build-and-run.sh이 스크립트는 실행 중인 deepK Dev만 종료한 뒤 개발 앱을 빌드·서명·실행합니다. 설치된 deepK는 계속 실행됩니다. 개발 앱에 열려 있던 번역창 내용은 유지되지 않습니다. 빌드만 하려면 ./scripts/build.sh를 사용합니다.
- Codex CLI 준비
- Claude Code 준비: 앱 전용 설치 스크립트에는 Node.js와 npm이 필요합니다.
- 이후 업데이트:
git pull --ff-only후./scripts/build-and-run.sh
Git 이력이 없는 소스 ZIP은 빌드 시 DEEPK_BUILD_NUMBER를 명시해야 합니다. 새 Git 이력의 빌드 번호와 기존 설치에 배포할 때의 주의점은 개발 안내를 참고하세요.
deepK/
├── DeepK/ # Mac 앱 소스와 리소스
├── DeepKTests/ # 앱 테스트와 합성 fixture
├── DeepK.xcodeproj/ # Xcode 프로젝트
├── scripts/ # 빌드·검증·패키징 도구
├── docs/ # 개발·배포 안내와 검증 자료
├── plans/ # 앱 개발 계획과 이전 기록
├── benchmarks/ # 측정 표본과 기록
└── landing/ # Astro 랜딩페이지와 계획
설치 파일은 이 저장소의 GitHub Releases에서, Homebrew 설치 정보는 Geuni620/homebrew-tap에서 배포합니다. 랜딩페이지의 실행·검증 방법은 랜딩 안내를 참고하세요.
./scripts/test.sh
./scripts/build.sh
node --test scripts/fixture-server.test.mjs
python3 scripts/test-app-bundle-contents.py테스트 도구에는 rg와 Python 3가 필요합니다. 개발용 fixture 서버 검증에는 Node.js도 사용합니다. test.sh는 로직·가짜 통신·화면 밖 렌더링을 검사하며 실제 구독을 호출하지 않습니다. 실제 계정·GUI를 사용하는 검증은 별도의 명시적 실행 옵션이 필요합니다.
이 저장소는 현재 소스에서 새 Git 이력으로 시작합니다. 과거 개발 문서의 PR 번호와 커밋 참조는 이전 비공개 개발 기록에 속합니다.
한자 독음 표에는 Unicode Unihan 데이터가 포함되어 있습니다. Unicode License v3 전문은 제3자 고지와 데이터 소스에 유지합니다. 프로젝트 전체의 재사용 라이선스는 별도로 정합니다.