Claude Code Learning 스타일로 직접 구현에 참여하기

Claude Code의 Learning 스타일은 설명과 함께 사용자가 일부 코드를 직접 작성하도록 요청합니다. 완성된 코드를 읽는 데서 그치지 않고 오류 처리나 업무 규칙의 조건을 구현하고 검사할 때 사용할 수 있습니다.

Lydia Hallie가 사이드 프로젝트에서 활용한다고 소개한 방식입니다. 공식 출력 스타일 문서는 Learning이 작은 코드 조각을 사용자에게 맡기고, 작성이 끝났다는 응답을 기다린 뒤 작업을 이어간다고 설명합니다. 학습할 동작을 정하고 그 부분을 직접 구현하도록 작업을 나눌 수 있습니다.

설명과 함께 남겨지는 TODO(human)

Learning 스타일의 Claude Code는 구현 과정에서 어떤 선택을 했는지 설명하고, 사용자가 작성할 작은 부분에 TODO(human) 표시를 남깁니다. 예를 들어 파일 업로드 화면의 기본 구조는 Claude가 만들고, 파일 종류에 따른 검증 조건은 사용자가 작성하는 식으로 나눌 수 있습니다.

학습할 부분에는 오류 반환, 자료구조 선택, 업무 규칙의 조건처럼 입력을 바꿔 결과를 비교할 수 있는 코드를 고릅니다. TODO(human) 위치를 작성하기 전에 필요한 입력과 기대하는 반환값을 정합니다.

표시가 남아 있다는 사실은 기능이 완료됐다는 뜻이 아닙니다. 해당 부분을 작성하고 동작을 검사해야 합니다. 작성 후에는 자신의 코드가 기존 흐름과 맞는지 설명을 받고, 실패 입력도 확인합니다.

직접 만든 학습 과제 예시입니다. TODO(human)은 작성할 위치이며, 아래 입력은 결과를 비교할 검사 대상입니다. 실제 Claude Code 응답이 아닙니다.

작은 입력으로 비교하는 구현

새 라이브러리와 큰 코드베이스를 동시에 배우면 어느 개념에서 막혔는지 찾기 어렵습니다. 학습할 영역 하나와 확인할 동작을 정한 뒤 작업을 맡겨보세요.

목표: 업로드 검증 함수를 이해하며 구현합니다.
이미 처리할 부분: 화면과 파일 선택 흐름은 만들어주세요.
직접 작성할 부분: 파일 크기와 확장자 검증은 제가 구현합니다.
확인할 결과: 정상 파일과 제한을 넘는 파일의 반환값을 비교합니다.

이 예시는 작업 분할을 설명하기 위한 요청입니다. 실제 업로드에서는 확장자만으로 파일 형식을 신뢰할 수 없고, 서버에서도 검증해야 합니다. Learning으로 작성한 코드가 어떤 검증을 담당하는지 확인하면 설명에서 다룬 조건이 실제 설계에 반영됐는지 비교할 수 있습니다.

처음에는 두세 개의 입력만 골라 반환값을 예상해보세요. 작성한 뒤 예상과 실제 반환값을 비교하면 빠진 조건을 발견할 수 있습니다. 예상과 다른 결과가 나왔다면 어떤 조건 때문에 달라졌는지 코드에서 찾아보고 설명을 요청합니다.

출력 스타일과 학습 목표

터미널의 /config에서 Output style을 선택해 Learning으로 바꿀 수 있습니다. 사용하는 환경과 버전에 따라 메뉴와 적용 시점이 다를 수 있으므로, 변경 후 실제 응답에 설명과 직접 작성할 요청이 나타나는지 확인합니다.

출력 스타일은 모델의 응답 방식에 관한 설정입니다. 도구 권한이나 코드의 정확성을 보장하는 설정은 아닙니다. 학습할 부분, 수정 범위, 확인할 테스트는 별도로 전달해야 합니다.

설명만 필요하면 Explanatory 스타일도 비교할 수 있습니다. Learning은 설명과 함께 사용자의 구현 참여를 요구한다는 점이 다릅니다. 오늘 필요한 결과가 개념 이해인지, 기존 작업의 빠른 완료인지에 따라 선택하면 됩니다.

작성한 코드의 조건을 설명하기

작업을 마치면 TODO(human)이 남지 않았는지와 필요한 검사가 통과했는지 확인합니다. 업로드 검증 함수를 작성했다면 정상 파일과 제한을 넘는 파일의 반환값을 비교하고, 예상과 다른 조건을 고칩니다. 이어서는 코드에서 시선을 떼고 입력과 결과의 관계를 자신의 말로 설명해보세요.

설명하지 못한 조건은 입력을 바꿔 다시 검사합니다. 학습 기록에는 직접 구현한 조건, 예상한 반환값, 실제 결과를 남깁니다. TODO를 채웠다는 사실과 조건을 이해했다는 판단을 구분해야 합니다.