코드 변경하기

Claude Code로 변경 작업하기

⚠️ 중요한 업데이트: 영상에서는 think harder와 같은 옛날 키워드를 사용해 추론을 강화하는 방식이 등장하지만, 이 방식은 더 이상 지원하지 않습니다. 본 글에서는 현재 사용 가능한 /effort 명령어를 기준으로 설명합니다.

이번엔 프로젝트에 몇 가지 변경 사항을 적용해보면서, Claude Code의 유용한 기능들을 함께 살펴보겠습니다.

1. 스크린샷으로 정확하게 소통하기

가장 먼저 하고 싶은 작업은 왼쪽 영역의 placeholder 텍스트를 패널 중앙으로 옮기는 것입니다.

Claude에게 어떤 영역을 옮기고 싶은지 정확히 이해시키기 위해, 해당 부분(아래 이미지)의 스크린샷을 찍은 뒤 Claude Code에 붙여 넣겠습니다.

스크린샷 붙여넣기 단축키는 Ctrl + V 입니다. macOS에서 익숙한 Cmd + V가 아니라는 점에 주의하세요. Ctrl + V는 스크린샷을 채팅 인터페이스에 붙여넣기 위해 특별히 설계된 단축키입니다. Windows에선 Alt + V 로도 이미지를 스크린샷에 붙여 넣을 수 있습니다.

참고로 macOS에선 Cmd + Shift + 4로 화면 일부 영역의 스크린샷을 만들 수 있습니다. Windows에선Win + Shift + S로 가능합니다.

이미지를 붙여 넣은 뒤 placeholder를 가운데로 정렬해달라고 요청하면, 약간의 탐색 후 Claude가 스타일을 업데이트해주고, 브라우저에서 확인하면 깔끔하게 적용된 모습을 볼 수 있습니다.

2. 조금 더 까다로운 작업: 카드 컴포넌트와 친근한 메시지

다음으로, 제목과 설명을 표시하는 카드 컴포넌트를 만들어달라고 요청해봅시다. 카드는 문제없이 생성되지만, 한 가지 어색한 부분이 있습니다. 왼쪽 채팅 인터페이스에 str_replace_editor 라는 정보가 떠 있는데, 이는 파일이 생성되고 있다는 사실을 사용자에게 알리려는 UI입니다. 하지만 내부에서 사용되는 도구의 매우 기술적인 명칭이 그대로 노출되고 있다는 위험이 있습니다.

이 부분을 사용자에게 더 친근한 텍스트로 바꿔, "파일이 생성되고 있다"는 메시지로 치환하고, 파일 이름을 보여달라고 해봅시다. 물론 챗봇이 파일을 편집하거나 삭제하는 케이스도 함께 처리해야 합니다. Claude에게 정확하게 작업 지시를 내기리 위해, 이번에도 해당 영역의 스크린샷을 찍어 붙여 넣고, 그 텍스트를 더 사용자 친화적인 메시지로 바꿔달라고 요청합니다.

이 작업은 프로젝트 내에서 적지 않은 양의 조사를 요구하는, 다소 까다로운 작업입니다. Claude에게 더 어려운 작업을 맡길 때, Claude의 지능을 끌어올리는 두 가지 방법이 있습니다.

3. Plan Mode: 코드베이스 전반을 깊이 탐색

첫번째 방법은 Plan Mode 입니다.

Plan Mode는 Claude가 변경 사항을 구현하기 전에 프로젝트를 광범위하게 탐색하도록 만드는 기능입니다.

활성화 방법:

• /plan 명령어를 입력하거나

• Shift + Tab을 두 번 누르기 (이미 파일 편집을 자동 수락 중이라면 한 번)

Plan Mode에서 Claude는 그렇지 않을 때보다 프로젝트 내 더 많은 파일을 읽고 상세한 구현 계획을 작성합니다. 그리고 목표 달성을 위해 자신이 무엇을 하려는지를 정확히 보여주고, 여러분의 승인을 기다립니다.

1. 프로젝트 내 (더 많은) 파일을 읽음

2. 상세한 구현 계획 작성

3. 자신이 무엇을 하려는지 정확히 보여줌

4. 여러분의 승인을 기다림

이 과정에서 여러분은 계획을 검토하고 Claude가 놓친 부분이나 고려하지 않은 시나리오가 있다면 방향을 다시 잡아주면 됩니다.

💡 팁: 계획을 검토할 때 Ctrl + G 를 누르면 텍스트 에디터에서 계획을 열 수 있습니다. 여러분은 텍스트 에디터에서 Claude가 제시한 구현 계획을 승인하기 전에 계획을 직접 정밀하게 수정할 수 있습니다. 당연히 Claude는 여러분이 제출한 최종 버전을 보고 작업을 수행합니다.

4. Effort Level: Claude가 얼마나 깊이 생각할지 조절하기

기본적으로 Claude는 답변을 내놓기 전에 문제에 대해 추론합니다. 작업 중에 "still thinking"과 같은 힌트가 보이는 이유죠.

Claude가 작업 중에 Ctrl + O 를 누르면 실제 추론 과정을 펼쳐서 볼 수 있습니다. Claude가 어떻게 생각하고 있는지 확인할 수 있습니다.

문제를 해결하는 추론의 깊이는 effort level로 제어할 수 있습니다.

• /effort 를 실행하면 현재 레벨을 확인하고 조정할 수 있습니다.

  

• low: 더 빠르고 비용이 저렴함

• max: 어려운 문제에 대해 가장 오래 추론함

• 기본값은 사용 중인 모델과 플랜에 따라 다르며, /effort로 본인의 기본값을 확인할 수 있습니다.

ultrathink: 단발성 깊은 추론 신호

특정 한 번의 프롬프트에서만 Claude가 더 깊이 생각하길 원한다면, 프롬프트 안에 ultrathink 라는 키워드를 포함하면 됩니다.

이렇게 하면 Claude는 해당 턴에서 더 많은 추론을 하라는 신호를 사용자가 주고 있다고 인지하고 더 깊게 추론 후 결과를 생성합니다.이때 세션 전체의 effort level이 변경되지는 않습니다.

• 참고

  

5. Planning vs Effort, 언제 무엇을 쓸까?

이 두 기능은 서로 다른 종류의 복잡도를 다룹니다. Breadth(폭) 과 Depth(깊이) 의 관점으로 생각하면 좋습니다.

Plan Mode가 적합한 경우 (폭)

• 코드베이스 전반에 대한 광범위한 이해가 필요한 작업

• 여러 단계로 나뉜 구현 작업

• 여러 파일이나 컴포넌트에 영향을 주는 변경

더 높은 Effort Level이 적합한 경우 (깊이)

• 복잡한 로직 문제

• 어려운 버그의 디버깅

• 알고리즘적 난제

폭과 깊이가 모두 필요한 작업이라면 두 기능을 함께 사용할 수 있습니다. 다만 두 기능 모두 추가 토큰을 소비하므로 사용 시 비용이 발생한다는 점을 염두에 두세요.

6. 결과 확인

몇 분간의 작업 끝에 기능 구현이 완료된 듯합니다. 에디터로 돌아가 테스트해보면, 이전보다 더 명확한 상태 정보가 표시되는 것을 바로 확인할 수 있습니다.

이제 사용자에게 "파일이 생성 중(Creatring...)"이라는 메시지가 안내되고, 후속 요청(예: 제목 변경)을 보내면 "파일을 편집 중(Editing...)"이라는 메시지가 나타납니다. app.jsx 파일을 편집 중이라는 안내가 노출되는 모습을 보니, Claude가 이 기능을 성공적으로 구현했다고 말할 수 있겠네요!

7. 변경 사항 커밋하기

프로젝트에 변경 사항을 적용했으니, 이제 커밋을 할 차례입니다.

Claude Code는 훌륭한 Git 보조 도구이기도 합니다. 변경 사항을 stage하고 commit해달라고 요청하면, Claude가 적절하고 설명적인 커밋 메시지까지 작성해줍니다.

핵심 요약

• 스크린샷 붙여넣기 (Ctrl + V): UI 영역을 정확히 지칭

• Plan Mode (/plan 또는 Shift + Tab 2회): 광범위한 코드베이스 탐색

• 계획을 에디터에서 편집 (Ctrl + G): 계획을 직접 정밀 수정

• 추론 단계 펼쳐 보기 (Ctrl + O): Claude의 생각을 확인

• Effort Level 설정 (/effort (low / max 등)): 추론 깊이 영구 조절

• 단발성 깊은 추론 (프롬프트에 ultrathink): 한 턴만 깊이 생각