클로드 코드 터미널 문제 — 복사 실패·글자 깨짐·저절로 입력되는 글자

터미널에서 AI 코딩 도구를 쓰다 보면 나만 겪는 것 같은 이상한 증상들을 만납니다. 복사했다는데 안 붙거나, 글자가 상자로 보이거나, 시작하자마자 엉뚱한 문자가 입력돼 있거나요.

대부분은 내 설정을 잘못 만진 게 아니라 터미널 종류와 연결 방식 때문입니다. 원인이 밝혀져 있고 처방도 나와 있는데, 증상만 봐서는 어디를 봐야 할지 모르는 것들이라 한자리에 모았습니다.

📌 30초 요약

• 원격 접속에서는 복사됐다고 나와도 실제로는 안 갔을 수 있습니다.
• 격리를 켜면 복사 명령이 시스템 클립보드에 못 닿습니다.
• 글자가 상자로 보이면 그래픽 가속이 원인입니다.
• 시작할 때 저절로 입력되던 문자는 판올림으로 고쳐졌습니다.

1. 복사했다는데 안 붙을 때

원격 컴퓨터에 붙어 쓰는 경우가 가장 헷갈립니다. 원격에서 도는 프로그램은 내 노트북의 클립보드 도구를 돌릴 수 없으니까요. 그래서 글자를 특수한 신호 형태로 터미널에 보내고, 그걸 받아 클립보드에 넣을지는 터미널이 알아서 결정합니다.

⚠️ 「복사됨」이라고 떠도 도착 여부는 모릅니다

여기가 함정입니다. 복사 명령은 글자가 실제로 클립보드에 들어갔는지와 무관하게 「복사됨」이라고 알립니다. 신호를 보낸 것까지가 자기 일이고 그 뒤는 터미널 몫이라서요.

그런데 이 신호를 무시하는 터미널이 있습니다. 아이텀2는 설정에서 허용을 켜야 동작하고, 맥 기본 터미널은 아예 지원하지 않습니다. 성공 메시지를 보고 붙여넣었는데 옛날 내용이 나온다면 대개 이 경우입니다.

우회로는 둘입니다. 하나는 터미널의 원래 선택 기능을 쓰는 것입니다. 지정된 키를 누른 채 드래그하면 터미널이 직접 선택을 처리하니 평소 쓰던 복사 단축키가 그대로 먹습니다. 맥 기본 터미널은 기능 키, 아이텀2는 옵션 키고요. 다른 하나는 원격 쪽에서 마우스 처리를 아예 꺼 두는 환경 변수를 켜서 세션 내내 터미널이 선택을 맡게 하는 방법입니다.

그리고 알아 두면 편한 대비책이 하나 있습니다. 복사 명령은 복사한 내용을 파일로도 써 두고 그 경로를 알려 줍니다. 클립보드로 못 간 경우에도 그 파일을 열면 내용을 건질 수 있다는 뜻입니다. 터미널 조작 전반은 터미널 꿀팁에 정리해 뒀습니다.

2. 격리를 켰을 때의 복사

원격이 아니어도 막히는 경우가 있습니다. 격리 기능을 켜 두면 셸 명령으로 도는 클립보드 도구들이 시스템 클립보드에 못 닿습니다. 클로드가 글을 그쪽으로 흘려보내도 내 클립보드는 그대로인 채고요.

방법	되는지 여부
셸 명령으로 흘려보내기	격리를 켜면 막힘 · 오류도 없이 클립보드만 그대로
응답에 출력시킨 뒤 복사 명령	됨 · 프로그램 자신이 쓰므로 격리와 무관
예외 목록에 넣기	됨 · 그 명령만 격리 밖에서 돌게 됨

둘째 줄이 권장되는 길입니다. 복사 명령은 셸을 거치지 않고 프로그램이 직접 클립보드에 쓰기 때문에 격리에 걸리지 않습니다. 덤으로 응답 전체가 아니라 코드 덩어리 하나만 골라 복사할 수도 있고요. 셋째 줄은 그 명령을 격리 밖으로 빼는 것이라 편하지만, 그만큼 막아 두려던 범위에 구멍이 생긴다는 점은 감안하셔야 합니다.

3. 글자가 깨지거나 저절로 입력될 때

편집기에 딸린 터미널에서 글자가 상자나 번진 모양, 엉뚱한 글리프로 보인다면 범인은 대개 그래픽 가속입니다. 전용 설정 명령을 돌리면 그 항목을 꺼 주고, 직접 설정에서 끈 뒤 창을 새로 고쳐도 됩니다.

증상	원인과 처방
글자가 상자로 보임	편집기 터미널의 그래픽 가속 · 설정 명령으로 끄기
시작할 때 이상한 문자	느린 연결에서 터미널 응답이 입력창에 섞임 · 판올림으로 해결
입력창에 커서가 안 보임	터미널 기본 커서를 켠 경우 · 판올림으로 해결
화면이 두 번 그려짐	외부 편집기에서 돌아온 뒤 · 판올림으로 해결
기능키·삭제키가 안 먹음	터미널 종류마다 다르게 깨져 있었음 · 판올림으로 해결

둘째 줄이 특히 당황스러운 증상입니다. 터미널은 시작할 때 「너 어떤 기능을 지원하니」 하고 묻는 신호를 주고받는데, 연결이 느리면 그 응답이 입력창에 글자로 섞여 들어왔습니다. 원격 접속이나 브라우저 터미널에서 주로 보였고요. 내가 안 친 문자가 프롬프트에 남아 있는 게 이 때문이었습니다.

다섯 줄 중 넷이 판올림으로 해결됐다는 점이 요점입니다. 증상이 터미널마다 달라 내 환경 탓이라고 생각하기 쉬운 것들이었고요. 원격 접속이나 이름을 못 알아보는 터미널에서 특수 단축키가 안 먹던 문제도 함께 개선됐습니다. 애초에 어떤 키는 대부분의 터미널이 아예 안 보낸다는 사정은 단축키 설정 글에서 따로 다뤘습니다.

4. 표가 잘리고 휠이 안 먹을 때

긴 표를 받으면 처음 200줄만 보이고 「몇 줄 더 있음」으로 끝납니다. 여기서 오해하기 쉬운데, 잘리는 건 화면일 뿐 대화에는 전체가 남아 있습니다. 복사 명령을 쓰면 모든 줄이 딸려 옵니다. 터미널에서 읽기엔 너무 크다면 파일로 써 달라고 하는 편이 낫고요.

전체 화면에서 마우스 휠이 한 줄씩만 움직이는 것도 자주 나오는 불편입니다. 이 모드에서는 클로드가 스크롤을 직접 처리하기 때문인데, 전용 명령이나 환경 변수로 한 번에 넘길 줄 수를 올릴 수 있습니다. 다만 젯브레인즈 편집기의 터미널에서는 둘 다 안 먹습니다. 빠르게 움직이고 싶을 뿐이라면 페이지 키로 반 화면씩 넘기거나, 고전 방식으로 되돌려 스크롤을 터미널에 넘겨 버리는 선택지도 있습니다. 느리고 파일을 못 찾는 쪽 증상은 진단이 정상이라도 놓치는 것들에서 다뤘고, 도입 순서를 잡는 중이라면 AI 도입 한 바퀴를 모아 둔 글도 보세요.

자주 묻는 질문 (FAQ)

Q. 원격에서 복사가 됐는지 확인할 방법이 있나요?

성공 메시지로는 알 수 없습니다. 대신 복사한 내용이 파일로도 저장되고 그 경로가 찍히니 그걸 믿는 편이 확실합니다. 화면에서 글자를 끌어 선택했을 때는 「몇 자를 신호로 보냈다」는 안내가 뜨는데, 이 문구 자체가 터미널에 넘겼다는 뜻이지 도착했다는 뜻이 아닙니다. 한 번 붙여넣어 보는 게 가장 빠른 확인입니다.

Q. 표가 잘렸는데 나머지를 어떻게 보나요?

세 가지 길이 있습니다. 복사 명령으로 통째로 가져오거나, 클로드에게 파일로 써 달라고 하거나, 필요한 부분만 다시 물어보거나요. 참고로 옛 판에서는 모든 줄을 다 그렸기 때문에 아주 큰 표가 있는 세션을 다시 열면 그리느라 멈추는 일이 있었습니다. 지금의 잘림은 그걸 막으려는 장치입니다.

Q. 그래픽 가속을 끄면 느려지지 않나요?

체감 차이는 크지 않습니다. 이 설정은 편집기에 딸린 터미널의 글자 그리기 방식을 바꾸는 것이라, 끄면 글자가 정상으로 보이는 대신 아주 빠른 출력에서 미세하게 덜 매끄러울 수 있는 정도입니다. 글자가 깨져 읽을 수 없는 쪽이 훨씬 큰 손해라 문서도 이 방향을 권합니다. 독립 터미널 프로그램을 쓴다면 해당 없고요.

Q. 판올림했는데도 증상이 남아 있으면요?

남는 것들은 대개 터미널 쪽 기능 지원 문제입니다. 클립보드 신호를 안 받는 터미널이나, 특수 키 조합을 안 보내는 터미널이 그렇습니다. 이건 프로그램이 고칠 수 있는 영역이 아니라 터미널 설정을 켜거나 다른 터미널로 옮기는 것이 해법입니다. 반대로 멈추거나 얼어붙는 증상은 다른 원인이니 성능 쪽 진단을 따로 보셔야 합니다.

정리하면

• 원격에서 「복사됨」은 도착 확인이 아닙니다.
• 격리를 켰다면 응답에 출력시킨 뒤 복사하세요.
• 글자가 상자로 보이면 그래픽 가속부터 끄세요.
• 저절로 입력되던 문자는 판올림이 답입니다.

※ 공개된 문제 해결 문서와 판올림 기록을 읽고 정리했습니다. 설정 항목·명령·환경 변수 이름은 우리말로 풀어 적었고, 터미널 종류별로 직접 재현해 보지는 않았습니다.

※ 어느 판부터 고쳐졌는지는 기록에 번호로 적혀 있으나 본문에서는 「판올림으로 해결」로 뭉쳤습니다. 내 환경이 해당하는지 확인하려면 지금 쓰는 판 번호와 원문을 대조하세요. 터미널별 지원 여부는 그 프로그램의 판에 따라 달라집니다.