클립보드 텍스트 정제 및 Claude Code 마커 제거 도구 'CleanText'

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

텍스트를 복사할 때 발생하는 불필요한 하드 줄바꿈과 공백은 문서의 구조를 망가뜨리는 주요 원인이다. CleanText는 클립보드에 저장된 텍스트의 선행/후행 공백을 제거하고, 강제로 끊긴 줄을 하나의 단락으로 다시 연결하면서도 리스트 구조와 단락 구분은 유지한다. 특히 Anthropic의 Claude Code 도구에서 출력되는 특수 마커(⏺)를 자동으로 제거하는 기능을 포함하여 AI 개발자의 워크플로우를 보조한다. 각 운영체제별로 최적화된 스크립트와 앱 형태를 지원하여 전역 단축키로 즉각적인 텍스트 정제가 가능하다.

배경

macOS: build.sh 실행 권한, Linux: Python 3, xclip 또는 wl-clipboard 설치, Windows: PowerShell 실행 권한

대상 독자

LLM 출력물이나 터미널 기반 AI 도구를 자주 사용하는 개발자 및 문서 작성자

의미 / 영향

이 도구는 AI 에이전트와 인간의 협업 과정에서 발생하는 사소하지만 반복적인 텍스트 포맷팅 문제를 해결한다. 특히 Claude Code와 같은 최신 AI 도구의 특성을 반영하여 개발 생산성을 높이는 유틸리티로서 가치가 있다.

섹션별 상세

CleanText는 텍스트의 의미적 구조를 파악하여 클립보드 내용을 정제한다. 각 줄의 시작과 끝에 있는 공백을 제거하고, 고정된 너비로 인해 발생한 하드 줄바꿈(Hard-wrapped lines)을 유동적인 단락으로 복원한다. 이때 이중 줄바꿈으로 구분된 단락 경계와 하이픈(-), 별표(*), 숫자로 시작하는 리스트 항목은 원본 구조를 유지하도록 설계되었다.

AI 코딩 에이전트인 Claude Code 사용자를 위한 전용 필터링 기능을 갖추고 있다. Claude Code의 터미널 출력물에 포함되는 ⏺ 마커를 자동으로 탐색하여 제거함으로써, 생성된 코드나 설명을 다른 문서에 붙여넣을 때 발생하는 불필요한 기호를 사전에 차단한다.

운영체제 환경에 따른 맞춤형 실행 환경을 지원한다. macOS에서는 메뉴바 앱 형태로 상주하며 Ctrl + Option + C 단축키를 통해 작동한다. Linux 환경에서는 Python 3 스크립트를 기반으로 xclip 또는 wl-clipboard와 연동되며, Windows에서는 PowerShell 스크립트를 AutoHotkey와 결합하여 시스템 전역에서 호출할 수 있다.

bash

cd mac
./build.sh
cp -r build/CleanText.app /Applications/

macOS에서 CleanText 앱을 빌드하고 애플리케이션 폴더로 복사하는 과정

bash

# copy to somewhere on your PATH
cp linux/cleantext ~/.local/bin/
# sway: bindsym Ctrl+Alt+c exec cleantext
# i3: bindsym Ctrl+Mod1+c exec cleantext

Linux 환경에서 스크립트를 설치하고 창 관리자(sway, i3)에 단축키를 바인딩하는 예시

powershell

# run directly
powershell -File windows\cleantext.ps1
# AutoHotkey binding (Ctrl+Alt+C):
# ^!c::Run, powershell -WindowStyle Hidden -File "C:\path\to\cleantext.ps1"

Windows에서 PowerShell 스크립트를 실행하거나 AutoHotkey를 통해 단축키를 설정하는 방법

실무 Takeaway

LLM이 생성한 텍스트의 줄바꿈 오류를 수정하려면 CleanText의 단락 복원 기능을 활용하여 가독성을 높일 수 있다.
Claude Code의 출력물을 자주 복사하는 개발자는 이 도구를 통해 특수 마커 제거 과정을 자동화하여 편집 시간을 단축할 수 있다.
각 OS별 네이티브 스크립트 방식을 지원하므로 사용 중인 창 관리자나 IDE의 단축키 설정에 통합하여 즉각적인 텍스트 정제 파이프라인을 구축할 수 있다.