Files

김보곤 1407893c26 docs: [guides] Claude Code → 슬랙 붙여넣기 가이드 추가

- 터미널 줄바꿈 혼재, Markdown vs mrkdwn 차이, 슬랙 공백 처리 원인 분석
- 클코 to 슬랙 변환기 사용법 안내
- 리치 텍스트 복사 작동 원리 설명

2026-03-11 09:35:39 +09:00

Claude Code CLI 출력을 슬랙에 전달하는 방법

작성일: 2026-03-11 대상: 슬랙으로 협업하는 모든 팀원

1. 문제

Claude Code CLI에서 복사한 텍스트를 슬랙 채팅창에 붙여넣으면 줄바꿈이 깨지고, 마크다운 문법이 원본 그대로 노출된다.

텍스트가 깨지는 원인은 3가지가 복합적으로 작용한다.

터미널에는 2종류의 줄바꿈이 존재한다.

종류	설명	복사 시 동작
Hard wrap	원본 텍스트의 실제 `\n`	보통 유지됨
Soft wrap	터미널 창 너비에 의한 시각적 줄바꿈	유실되거나 불필요하게 추가됨

Claude Code CLI는 터미널에서 실행되므로, 드래그 복사 시 실제 줄바꿈과 시각적 줄바꿈이 뒤섞여 클립보드에 들어간다. 그 결과 어떤 줄은 합쳐지고, 어떤 줄은 엉뚱한 곳에서 끊어진다.

Claude Code는 표준 Markdown을 출력하지만, 슬랙은 자체 마크업 문법(mrkdwn)을 사용한다.

요소	Markdown (Claude Code)	Slack mrkdwn	직접 붙여넣기 시
볼드	`텍스트`	`텍스트`	`텍스트` 그대로 표시
이탤릭	`텍스트`	`_텍스트_`	슬랙에서 볼드로 오인식
제목	`## 제목`	지원 안 함	`## 제목` 그대로 표시
취소선	`~~텍스트~~`	`~텍스트~`	`~~텍스트~~` 그대로 표시
링크	`[텍스트](URL)`	`<URL\|텍스트>`	원본 문법 그대로 표시
구분선	`---`	지원 안 함	`---` 대시 3개로 표시
코드블록	```lang ```	``` ```	언어 지정자가 텍스트로 노출될 수 있음

슬랙의 메시지 입력창은 붙여넣기 시 다음 처리를 수행한다:

이 3가지가 합쳐지면 줄 합침, 문법 노출, 공백 손실이 동시에 발생한다.

MNG 관리자 패널에 변환 도구가 있다.

환경	URL
로컬	`http://mng.sam.kr/rd/cc-to-slack`
개발 서버	`https://admin.codebridge-x.com/rd/cc-to-slack`
운영 서버	`https://mng.codebridge-x.com/rd/cc-to-slack`

메뉴 위치: 연구개발 > 클코 to 슬랙형태

변환기가 정상 작동하는 핵심 이유는 리치 텍스트(HTML) 복사 방식을 사용하기 때문이다.

일반 텍스트 복사 (plain text)
  → 슬랙이 자체적으로 재해석 → 줄바꿈 깨짐, 문법 노출

리치 텍스트 복사 (HTML)
  → 슬랙이 HTML 서식을 그대로 수용 → 볼드, 코드블록, 줄바꿈 보존

브라우저의 Selection API로 DOM 요소를 선택하면 클립보드에 text/html과 text/plain 두 가지 형식이 동시에 저장된다. 슬랙은 text/html 버전을 읽어서 <b>, <code>, <br> 등의 서식을 그대로 적용한다.