터미널 대신 VS Code 주석으로 AI 코딩 에이전트 수정하기

커뮤니티 반응

대체로 긍정적이며, 많은 사용자가 유사한 경험을 공유했습니다.

주요 논점

01찬성다수

터미널 기반의 텍스트 입력보다 IDE의 편집 기능을 활용한 피드백이 훨씬 효율적이다.

합의점 vs 논쟁점

합의점

터미널에서 AI의 계획을 일일이 수정하는 것은 비효율적이다
VS Code의 커스터마이징 기능을 활용하면 AI와의 협업 효율을 높일 수 있다

실용적 조언

ctrl-g 단축키를 사용하여 Claude Code의 실행 계획을 VS Code 마크다운 파일로 즉시 연다
자주 사용하는 피드백 형식을 VS Code 스니펫으로 등록하여 단축키 하나로 주석 블록을 생성한다

섹션별 상세

Claude Code가 생성하는 계획이 복잡해짐에 따라 터미널에서 직접 수정 사항을 입력하는 방식은 컨텍스트 재입력과 복사 붙여넣기 등의 비효율을 초래한다. 사용자는 AI의 계획 중 일부에 동의하지 않을 때 터미널에 다시 타이핑하는 대신 더 직관적인 수정 방법을 필요로 하게 되었다. 이는 대규모 리팩터링 시 소통의 병목을 일으키는 주요 원인이 된다.

ctrl-g 명령어로 AI의 계획을 VS Code에서 열고 특정 텍스트를 선택한 뒤 사용자 정의 단축키를 통해 주석 블록을 생성하여 피드백을 남기는 워크플로우를 구축했다. 선택된 텍스트를 주석 블록으로 감싸고 그 아래에 피드백을 작성하면 Claude가 이를 읽고 계획을 즉시 수정한다. 이 방식은 PR에 리뷰 댓글을 다는 것과 유사한 경험을 제공하여 협업 효율을 높인다.

VS Code의 markdown.json 설정에 선택된 텍스트를 감싸고 피드백 공간을 만드는 스니펫을 등록하여 수동 작업을 최소화했다. keybindings.json에 단축키를 할당하여 마크다운 파일 편집 중에만 작동하도록 설정함으로써 워크플로우의 일관성을 확보했다. 단 10줄의 설정만으로 AI와의 상호작용 인터페이스를 최적화할 수 있음이 확인됐다.

json

"Annotate Selection": { "prefix": "annotate", "body": [" ${TM_SELECTED_TEXT}", "", "$1", "-->$0"] }

선택한 텍스트를 주석 블록으로 감싸는 VS Code 마크다운 스니펫 설정

json

{ "key": "cmd+shift+a", "command": "editor.action.insertSnippet", "args": { "name": "Annotate Selection" }, "when": "editorTextFocus && editorLangId == markdown" }

등록한 스니펫을 실행하기 위한 VS Code 단축키 바인딩 설정

작은 AI 워크플로우 개선이 누적되어 매일 반복되는 작업에서 실질적인 생산성 향상을 가져온다. 작성자는 AI QA 도구인 Bugzy AI를 개발하며 발견한 이 패턴이 AI 코딩 에이전트와의 협업에서 발생하는 잦은 오류와 피로도를 줄여준다고 밝혔다. 이는 도구의 성능만큼이나 도구를 다루는 인터페이스의 최적화가 중요함을 시사한다.

용어 해설

코딩 에이전트(Coding Agent): — 사용자의 지시에 따라 코드를 분석, 작성, 수정 및 실행하는 자율형 AI 도구이다. 터미널이나 IDE 내에서 작동하며 복잡한 개발 태스크를 계획하고 수행하는 능력을 갖추고 있다. 개발자의 개입을 최소화하면서도 정확한 결과물을 도출하기 위해 효율적인 피드백 루프 구축이 필수적이다.
스니펫(Snippet): — 반복적으로 사용되는 코드나 텍스트의 패턴을 미리 정의해두고 짧은 키워드나 단축키로 불러오는 기능이다. VS Code와 같은 편집기에서 복잡한 구조의 코드를 빠르게 입력할 수 있게 도와주며, 사용자 정의 변수를 활용해 동적인 텍스트 삽입이 가능하다. 개발 생산성을 높이고 오타를 줄이는 데 중요한 역할을 한다.
주석/어노테이션(Annotation): — 문서나 코드의 특정 부분에 추가적인 정보, 설명, 또는 피드백을 기록하는 작업이다. 이 아티클에서는 AI가 생성한 계획서의 특정 구절에 대해 개발자가 의견을 남기는 수단으로 활용된다. AI가 이 주석 내용을 컨텍스트로 인식하여 계획을 수정하게 함으로써 소통의 정확도를 높인다.

언급된 도구

Claude Code추천

AI 코딩 에이전트

VS Code추천

코드 편집기 및 워크플로우 실행 환경

Bugzy AI중립

AI QA 도구