Claude Code에 에러를 복붙하지 말아야 하는 이유
Claude Code와 같은 코딩 에이전트를 사용할 때 터미널의 에러 메시지를 직접 복사해서 붙여넣는 것은 작업의 자동화 흐름을 끊는 안 좋은 습관입니다. 개발자는 수동으로 에러를 전달하기보다 데이터베이스 접근 권한이나 헤드리스 브라우저 등 필요한 환경과 API 키를 에이전트에 직접 제공하여 스스로 문제를 찾고 테스트하도록 수정해야 합니다. 소프트웨어 엔지니어의 역할은 에이전트가 개입 없이도 자율적으로 오랫동안 작동하도록 병목 현상을 진단하고 해결하는 것으로 변화하고 있습니다.
블로그로 돌아가기 2026년 6월 29일 Claude Code에 에러를 복붙하면 절대 안 되는 이유: 자동화 루프를 사랑하게 된 과정
Claude Code가 작성한 코드에 문제가 생겨 작동이 중단되었을 때, 우리가 흔히 하는 반응은 터미널에서 에러 메시지를 복사해 다시 AI에게 붙여넣는 것입니다. 이러지 마세요.
그럴 때마다 작업 속도는 늦춰집니다. 코드를 작성하기 위해 Claude는 수천 번의 자율적인 도구 호출(tool call)과 파일 편집을 수행했습니다. 또한 bash 명령어, 단위 테스트(unit test) 등을 실행하여 자체적인 능력 선에서(비록 충분하지는 않겠지만) 로컬에서 작업물을 테스트했습니다. 이는 인류가 지금까지 만들어본 것 중 가장 환상적으로 빠른 엔지니어링 경험입니다. 그런데 바로 그 한가운데서 당신의 통통한 손가락이 ctrl-c, ctrl-v를 누르고 있는 셈이죠.
이는 제가 지난주 병원에서 본 의사 선생님을 떠올리게 합니다. 그분은 진료 시간의 10%를 환자 진단에 쓰고, 나머지 90%의 시간 동안 키보드를 콕콕 찔러가며 무려 10분을 소비한 끝에 단 3줄의 문장을 적었습니다.
코딩 에이전트를 사용하는 핵심 목적은 개발자인 당신이 그 길을 비켜서는 것에 있습니다! 만약 당신이 에러 메시지를 직접 복사해서 붙여넣고 있다면, 이는 명백히 에이전트가 자신의 작업 결과를 제대로 검증하지 못했다는 뜻입니다. 그럼 왜 그런지 잠시 멈춰서 자문해 보세요:
실제 데이터베이스에 연결하여 웹 서버를 엔드투엔드(end-to-end)로 구동해 보니 Claude가 찾지 못한 문제를 당신이 발견한 건가요? 좋습니다. 그렇다면 이제 Claude Code에게 데이터베이스 API 키를 제공하고 당신은 방에서 비켜서세요. 다음부터는 복사-붙여넣기가 필요 없어질 것입니다.
Claude는 인지하지 못했지만 당신이 브라우저를 열어 시각적인 버그를 발견했나요? 쉽습니다. Claude Code에게 헤드리스 브라우저(headless browser)와 로그인 자격 증명을 제공하세요.
당신이 개발 중인 AI 에이전트를 실행해 보니, 에이전트가 잘못된 대답을 내놓는 실패 사례를 발견했나요? 훌륭합니다. Claude에게 LLM API 키를 주어 에이전트를 직접 실행하게 하세요. 그리고 평가(evals)를 작성하고 엔드투엔드로 시나리오를 재현한 뒤 스스로 문제를 해결하게 두세요. 우리는 HolmesGPT를 개발할 때 매일 이 방식을 사용하고 있으며 매우 훌륭한 결과를 얻고 있습니다.
전체 AWS 계정이나 K8s(Kubernetes) 클러스터 없이는 앱을 끝까지 테스트할 수 없나요? 우리는 Claude Code가 HolmesGPT를 테스트할 수 있도록 격리된 클라우드 계정 API 키를 제공합니다. 여러분도 똑같이 할 수 있습니다. 이를 직접 구현해 보고 싶다면, 제가 정리한 몇 가지 팁을 확인해 보세요.
기억하세요: 2026년 시점에서 소프트웨어 엔지니어로서 당신의 역할은 텍스트를 복사하고 붙여넣는 것이 아닙니다. 애초에 당신이 해야 했던 본연의 역할, 즉 컴퓨터가 최대한 안정적으로 무언가를 자동으로 수행하도록 만드는 일에 집중해야 합니다.
이는 당신의 개입이 필요해서 AI의 작동이 지연되는 지점을 파악하고(진단하고), 당신 없이도 에이전트가 더 오래 자율적으로 실행되도록 고치는 것을 의미합니다. AI가 당신의 도움을 필요로 해서 속도가 늦춰지는 부분을 찾아내세요. 그리고 고치고, 다른 병목 현상을 찾은 뒤 다시 비켜서는 겁니다.
자, 이제 저는 제 Claude Code로 돌아가겠습니다. 이 글을 쓰기 시작할 때 몇 가지 새로운 기능 구현을 시작했는데, 지금쯤이면 모두 완성되고 테스트도 끝났을 것입니다. 가벼운 수동 확인은 하겠지만, 지난 경험상 아무 문제도 찾지 못할 가능성이 큽니다. Claude Code가 첫 시도부터 버그 없는 완벽한 코드를 작성하지는 않았겠지만, 지금쯤 이미 스스로 버그를 찾아 수정했을 테니까요.
- Natan Yellin, CEO. Natan은 15년 이상 소프트웨어를 개발해 왔으며, 링크드인(LinkedIn)에 정기적으로 글을 올립니다.
고객님의 환경에서 직접 실행해 보세요. 당사가 클러스터에 Robusta를 설치하도록 도우며, 실제 사고 대응 과정을 안내해 드립니다. 지금 사용해 보기
먼저 당사에 인프라 설정에 대해 알리고 싶으신가요? 업무용 이메일 또는 인프라에 대해 알려주기 / 담당자에게 연락하기
원문 보기 (영어)
Anthropic and Gov. Newsom forge deal allowing California government to use Claude at half price
[요약 오류] Anthropic and Gov. Newsom forge deal allowing California government to use Claude at half price
I used Claude Code to get a second opinion on my MRI
[요약 오류] I used Claude Code to get a second opinion on my MRI