Claude Code를 사용하며 겪었던 첫 달의 고통을 만든 5가지 실수 (Chat에서 온 사람들을 위해)

저는 Chat에서 왔고, 실제 터미널 배경 지식이 없었으며, 이 모든 실수를 저질렀습니다. 만약 여러분이 넘어오는 중이라면, 제 한 달간의 고통을 건너뛰세요.

실수 1: 너무 크고 모호한 목표를 제시하는 것. '앱을 만들어줘'는 따라갈 수 없는 거대한 혼란을 초래합니다. 저는 이제 '프로젝트 구조를 만들고 작게 작동하는 조각 하나를 만든 다음, 각 단계를 설명해 줘'로 시작하고 거기서부터 성장시킵니다. 작고 읽기 쉬운 것이 크고 인상적인 것보다 낫습니다.

실수 2: 한 번에 모든 것을 건드리도록 내버려 두는 것. 하나에 대해 물어봤을 뿐인데도 기꺼이 다섯 개의 파일을 리팩토링하고, 이제 무엇이 고장 났는지 알 수 없습니다. 저는 세션을 '이 폴더에서만 작업해 줘, 변경하기 전에 설명해 주고, 다른 파일은 건드리지 마'로 시작합니다. 이 습관 하나가 저를 가장 큰 어려움으로부터 구해주었습니다.

실수 3: 이해하지 못한 수정 사항을 적용하는 것. 무언가를 제안하고, 제가 그것을 붙여넣으면 더 심하게 고장 납니다. 이제 무언가 오류가 나면 '이것이 무엇을 의미하는지 먼저 설명해 준 다음에 수정을 제안해 줘'라고 말합니다. 이해하지 못하는 것을 방향 잡을 수는 없습니다.

실수 4: 거대하고 끝없는 대화 하나로 만드는 것. 채팅이 너무 커지면 흐름을 놓칩니다. 저는 작업을 작게 유지하고, 대화당 하나의 작업만 수행하며, 제가 무엇을 하고 있는지에 대한 일반 텍스트 메모를 남겨서 새로운 세션에서 이를 이어갈 수 있게 합니다.

실수 5: 모든 줄을 이해해야 한다고 생각하는 것. 아직은 그렇지 않습니다. 하지만 저는 왜 그런지 말할 수는 없더라도 무언가가 잘못된 것처럼 보이는지 판단하는 법을 배워야 했습니다. 그 판단력이 바로 여러분이 구축하고 있는 실제 기술이며, 위험 부담이 커지기 전에 작고 안전한 것으로 이를 쌓아 올립니다.

메타 교훈: Chat은 모호함을 용서하지만, Claude Code는 실제로 행동할 수 있기 때문에 그것에 벌을 줍니다. 범위가 좁은 것이 전부입니다. 여러분의 첫 주는 무엇으로 망가졌나요? 프로젝트가 너무 커져서 방향을 유지하는 방법을 여전히 파악하려고 노력 중입니다.