Pilsa

Claude와 대화하며 코드를 고치고, 탭 자동완성을 받고, AI가 쓴 코드를 직접 따라 쳐 보며 익히는 VS Code 익스텐션입니다.

요구 사항

• VS Code 1.138 이상
• Anthropic API 키, 또는 이 PC에 로그인된 Claude Code
• 변경 사항 필사와 채팅 작업 필사는 git 저장소 폴더여야 합니다. 파일 전체 필사는 git 없이도 쓸 수 있습니다.

시작하기

설치 후 명령 팔레트(Cmd+Shift+P / Ctrl+Shift+P)에서 Pilsa: 시작하기를 실행하면 단계별 안내가 열립니다.

인증 방식

채팅과 탭 자동완성이 같은 방식을 씁니다. 설정 pilsa.auth.mode에서 고릅니다.

Pilsa: Agent SDK 연결 테스트를 실행하면 출력 창(Pilsa)에서 연결 결과를 확인할 수 있습니다. result: subtype=success가 나오면 준비가 끝났습니다.

기능

채팅

• 상태 바의 Pilsa 버튼, 활동 표시줄의 Pilsa 아이콘, 또는 Pilsa: 채팅 열기로 엽니다.
• 이 워크스페이스의 코드를 읽고 고치도록 요청할 수 있습니다. 도구 카드의 파일 열기와 변경 비교로 바뀐 파일을 확인합니다.

채팅 전용 모드

채팅만 크게 보는 모드입니다. macOS Cmd+Alt+C, 그 밖 Ctrl+Alt+C로 켜고 끕니다.

탭 자동완성

• 줄바꿈 직후, { ( [ = , : 뒤, 줄 끝에서 잠깐 멈추면 회색 제안이 뜹니다. Tab으로 받습니다.
• 제안이 뜬 뒤 2초 동안 그대로 두면 더 좋은 모델의 제안으로 바뀝니다. 바로 좋은 모델에 요청하려면 macOS Option+\, 그 밖 Alt+\를 누릅니다.
• 단어 중간이나 주석·문자열 안에서는 자동으로 요청하지 않고, 필사하는 동안에는 꺼집니다.

필사 모드

코드를 직접 따라 쳐 보는 기능입니다.

변경 사항 필사

터미널의 Claude Code든 다른 도구든, 누가 고쳤는지와 상관없이 커밋하지 않은 변경 사항을 마지막 커밋과 비교해서 따라 칩니다. 채팅을 쓰지 않아도 됩니다.

1. 코드를 고치면 바뀐 파일이 필사 목록 맨 위 변경 사항에 저절로 나타납니다.
2. 아래 중 한 곳에서 시작합니다.
   • 필사 목록의 변경 사항에서 파일 누르기
   • 소스 제어 뷰에서 파일 옆 버튼이나 우클릭 메뉴
   • 바뀐 파일을 열었을 때 에디터 제목 표시줄의 변경 사항 필사하기 버튼
   • 명령 팔레트의 Pilsa: 변경 사항 필사하기
3. 전용 탭에 파일 전체가 열립니다. 바뀌지 않은 줄은 흐리게 보이고, 바뀐 줄 덩어리마다 위에 수정 방향(바뀐 뒤 내용), 바로 아래에 마지막 커밋 내용이 든 편집 칸이 있습니다.
4. 편집 칸을 직접 지우고 고쳐서 수정 방향과 똑같이 만듭니다.
   • 수정 방향에서 쳐야 할 글자는 초록, 편집 칸에서 지울 글자는 빨강으로 표시되고, 고칠 때마다 바로 바뀝니다.
   • 편집 칸 안에서는 에디터처럼 커서를 옮기고 고칠 수 있습니다. Enter는 들여쓰기를 이어 주고, Tab은 들여쓰기 한 단계를 넣습니다. 덩어리 첫 줄·마지막 줄에서 ↑·↓를 누르면 앞뒤 덩어리로 옮깁니다.
   • 덩어리가 맞으면 다음 덩어리로 넘어갑니다. 위쪽에 맞춘 덩어리 수와 걸린 시간이 나옵니다.
5. 모든 덩어리를 맞추면 결과가 나오고 목록에 완료로 표시됩니다. 실제 파일은 바뀌지 않습니다.

탭을 닫거나 VS Code를 껐다 켜도 고친 내용이 남아서, 같은 파일을 다시 열면 이어서 고칩니다. 파일이 그 사이에 바뀌었으면 처음부터 시작합니다.

채팅 작업 필사

Pilsa 채팅으로 코드를 고치게 하면 응답 아래에 필사하기 버튼이 생깁니다. 누르면 그 응답 하나에서 바뀐 내용만 따라 칩니다. 필사 목록에도 작업별로 남습니다.

• 실제 파일이 그 응답 전 내용으로 돌아가고, 같은 에디터에 새로 생긴 줄은 초록, 지워야 할 줄은 빨강으로 표시됩니다.
• 표시를 보면서 파일을 직접 고칩니다. 상태 바에 진행률이 나오고, 필사 힌트 켜기/끄기로 표시를 숨기고 기억으로 쳐 볼 수도 있습니다.
• AI 결과와 똑같아지면 자동으로 끝나고 파일이 저장됩니다. 그만두려면 필사 포기를 누릅니다. 파일은 AI 결과로 돌아갑니다.
• 채팅 작업 필사는 한 번에 하나만 진행합니다.

파일 전체 필사

AI 작업과 상관없이 워크스페이스의 파일 하나를 처음부터 따라 칩니다. 타자 연습 사이트처럼 전용 타자 탭에서 치고, 실제 파일은 바뀌지 않습니다.

1. 아래 중 한 곳에서 시작합니다.
   • 에디터 제목 표시줄의 이 파일 필사하기 버튼(연필 아이콘)
   • 에디터나 탐색기의 우클릭 메뉴
   • 명령 팔레트의 Pilsa: 이 파일 필사하기
   • 필사 목록 제목 표시줄의 필사할 파일 고르기 버튼
2. 타자 탭에 파일 내용이 흐린 글씨로 깔립니다. 들여쓰기와 줄바꿈(Enter)까지 그대로 따라 칩니다.
   • 맞은 글자는 밝아지고, 틀린 글자는 빨갛게 남습니다. 틀려도 멈추지 않고, Backspace로 고칠 수 있습니다.
   • Tab을 누르면 커서가 있는 어절이 자동으로 채워집니다. 어절 지우기는 macOS Option+Backspace, 그 밖 Ctrl+Backspace입니다.
   • 위쪽에 진행률, 정확도, 걸린 시간이 나옵니다.
3. 마지막 글자까지 치면 결과(정확도, 시간, 맞은·틀린 글자 수, 오타 수)가 나옵니다.

탭을 닫거나 VS Code를 껐다 켜도 친 내용이 남아서, 같은 파일을 다시 열면 이어서 칩니다. 파일 내용이 그 사이에 바뀌었으면 처음부터 시작합니다. 필사한 파일은 필사 목록 맨 위의 직접 고른 파일에 남고, 누르면 다시 필사할 수 있습니다.

설정

단축키

라이선스

MIT(LICENSE 파일). Pilsa 코드에만 적용되며, 함께 들어가는 Claude Agent SDK와 실행 파일은 각 패키지의 라이선스를 따릅니다.