CleanText: 클립보드 텍스트 정제 및 Claude Code 출력 정리 도구

핵심 요약

CleanText는 클립보드에 복사된 텍스트의 서식을 자동으로 정리해 주는 오픈소스 도구이다. 텍스트의 앞뒤 공백을 제거하고 강제로 줄바꿈된 문장을 자연스러운 단락으로 복원하며, 특히 AI 코딩 에이전트인 Claude Code의 출력물에 포함된 특수 마커를 삭제하는 기능을 갖추고 있다. macOS, Linux, Windows를 모두 지원하며 각 환경에 맞는 스크립트와 단축키 설정을 통해 텍스트 편집 효율을 극대화한다.

배경

기본적인 터미널 사용법, 운영체제별 스크립트 실행 환경 (Python, PowerShell 등)

대상 독자

Claude Code 또는 LLM 출력물을 자주 다루는 개발자 및 기술 문서 작성자

의미 / 영향

AI 코딩 에이전트의 활용이 늘어남에 따라 터미널 출력물을 실제 코드베이스나 문서에 통합하는 과정의 불편함을 해결하려는 시도이다. 이러한 작은 유틸리티들이 AI 도구의 실무 생산성을 보완하는 중요한 역할을 한다.

섹션별 상세

CleanText는 텍스트의 구조를 지능적으로 파악하여 정제 작업을 수행한다. 줄 끝의 공백을 제거하고 하드 래핑된 문장을 하나의 흐르는 단락으로 합치면서도, 리스트 항목이나 이중 줄바꿈으로 구분된 단락 구분은 정확히 유지한다. 특히 Claude Code 사용 시 발생하는 특수 마커를 제거하여 결과물을 즉시 문서나 코드에 활용할 수 있게 돕는다. 이는 AI 출력물을 수동으로 편집해야 하는 번거로움을 크게 줄여준다.

다양한 운영체제 환경에서 원활하게 작동하도록 설계되었다. macOS에서는 메뉴바 앱으로 실행되어 전용 단축키를 제공하며, Linux에서는 xclip이나 Wayland 환경의 wl-clipboard를 활용하는 파이썬 스크립트로 작동한다. Windows 사용자는 파워쉘 스크립트를 AutoHotkey와 연동하여 시스템 전역에서 간편하게 텍스트를 정리할 수 있다. 각 환경에 맞는 빌드 스크립트와 설치 가이드가 포함되어 있어 사용자가 직접 환경을 구축하기 용이하다.

</> 코드 예제 포함

실무 Takeaway

AI 에이전트 출력물의 특수 기호와 서식 오류를 수동으로 수정하는 시간을 절약할 수 있다.
운영체제별 단축키 연동을 통해 텍스트 정제 워크플로우를 시스템 전역에서 자동화할 수 있다.