Guide Coding이 VS Code에서 단계별 코딩 안내를 제공한다

Guide Coding은 VS Code 확장 프로그램으로, 사용자가 직접 코드를 작성하는 동안 선택한 모델이 작업을 계획하고 한 단계씩 안내한다. 코드를 대신 작성하지 않으며, 각 단계에서 무엇을 할지, 왜 필요한지, 어디에 적용할지를 편집기 안에 보여준다.

사용자는 모델의 계획을 수정하거나 단계를 건너뛰고, 순서를 바꾸거나 추가·삭제할 수 있다. 모델은 변경된 계획에 맞춰 조정한다. 단계별 설명을 먼저 보는 Learn 모드가 기본이며, 코드부터 확인하는 Control 모드로 언제든 바꿀 수 있다. Show code, Preview, Apply는 필요할 때 선택할 수 있다. Preview는 단계를 적용했을 때의 파일 차이를 보여주고, Apply는 실행 취소할 수 있는 편집을 적용한다.

Guide Coding은 초기 버전인 0.4.1이다. 작동은 하지만 다듬어지지 않은 부분이 있을 수 있다. 문제는 피드백 페이지에 알릴 수 있다.

설치와 모델 설정

VS Code 확장 프로그램 보기에서 게시자 novian의 Guide Coding을 검색하거나 VS Code Marketplace에서 설치한다. Open VSX 지원은 추후 제공될 예정이다. 신뢰하는 폴더를 연 뒤 활동 표시줄에서 Guide Coding을 연다.

처음 실행할 때 Choose provider를 선택하거나 Guide: Choose model provider를 실행해 제공자를 고르고 API 키를 입력한다. 키 확인은 무료이며, 제공자의 모델 목록만 요청한다. 키는 운영체제의 키체인에 저장된다.

Claude Max 또는 Team을 이용한다면 플랜에 포함된 월간 API 크레딧을 사용할 수 있다. Max 5x는 $100, Max 20x는 $200, Team은 최대 $500을 공동으로 사용한다. claude.ai의 Settings → Billing에서 Claude Console 조직을 연결해 크레딧을 신청한 뒤, 해당 조직에서 API 키를 만들고 Anthropic을 선택한다. Pro, Free, Enterprise 플랜에는 이 크레딧이 포함되지 않는다. 자세한 내용은 Anthropic 안내를 참고하면 된다.

Ollama는 VRAM이 24 GiB 미만인 기기에서 기본 컨텍스트 길이가 4k 토큰이며, 긴 프롬프트의 앞부분을 알리지 않고 잘라낸다. Guide Coding에는 최소 32k가 필요하다. Ollama 앱의 컨텍스트 슬라이더를 높이거나 OLLAMA_CONTEXT_LENGTH를 설정할 수 있으며, 코딩 도구에는 64k(65536)가 권장된다. 도구 호출이 가능한 모델을 선택해야 하며, 예로 ollama pull qwen3-coder가 안내돼 있다.

사용자 지정 엔드포인트는 guide.baseUrl과 guide.apiShape를 설정한 뒤 custom을 선택한다. guide.apiShape는 openai 또는 anthropic으로 설정한다. URL은 HTTPS를 사용해야 하며, 일반 HTTP는 localhost나 127.0.0.1에만 허용된다. 키가 필요 없는 엔드포인트라면 키 입력란을 비워둘 수 있다. 예를 들어 LM Studio가 이에 해당한다. 다른 기기로 일반 HTTP를 통해 데이터를 보내지는 않는다.

가격을 확인할 수 있는 모델(Anthropic, DeepSeek 등)은 비용을 달러로 표시하고, guide.maxTaskCostUsd 한도에 도달하면 작업을 일시 중지한다. 기본 한도는 5달러다. 그 밖의 모델은 각 차례의 토큰 수를 로그에 기록한다. 키는 제공자별로 저장되며 해당 제공자에만 전송된다. Guide: Set API key와 Guide: Clear API key 명령으로 키를 관리할 수 있다.

작업 진행과 개인정보

작업을 시작하려면 Guide Coding 보기에서 Start a task를 선택하고 만들고 싶은 것을 입력한다. 모델은 코드를 읽기만 하고 계획을 제안한다. 큰 목표는 실행해 결과를 확인할 수 있는 여러 마일스톤으로 나뉘며, 다음 마일스톤의 계획은 그 단계에 도달했을 때 당시 코드 상태를 바탕으로 세운다.

현재 단계는 편집기에 표시된다. 사용자가 직접 코드를 입력한 다음 Check my work를 선택하면 모델이 변경 사항을 검토한다. 막히면 Hint로 코드의 형태를 안내받거나, 해당 단계의 말풍선에서 Ask로 질문할 수 있다. 마일스톤이 끝나면 다음 단계로 넘어가기 전에 직접 만든 결과를 시험해 보라는 체크포인트가 나온다. 맞지 않는 단계는 Split step으로 더 작은 단계로 나누거나 Finish later로 미뤄둘 수 있다.

Learn 모드는 단계의 필요성, 작동 방식, 적용 위치를 먼저 설명한다. Control 모드는 간결하게 안내하고 코드를 바로 보여준다. Guide Coding 보기의 제목 표시줄이나 guide.mode 설정에서 언제든 모드를 전환할 수 있다.

제작자 안내에 따르면 Guide Coding은 데이터를 수집하지 않고 제작자에게 전송하지 않으며, 텔레메트리도 없다. 사용자의 목표, 모델이 읽는 파일, Check 때의 변경 내용, 메시지는 선택한 모델 제공자에게만 전달되며, 해당 제공자의 약관이 적용된다. Ollama를 사용하면 데이터는 사용자 기기에 머문다. 모델은 작업 공간을 읽을 수 있지만 직접 변경할 수는 없다. 파일 쓰기는 사용자가 Apply 또는 Create file을 실행할 때만 이뤄지며, 경로 보호 기능은 열린 폴더 바깥과 .env*, *.pem, .ssh 같은 비밀 파일에 접근하지 못하도록 한다. 키는 키체인에, 작업과 대화는 사용자 기기의 VS Code 작업 공간 저장소에 보관된다. 자세한 내용은 개인정보 처리 안내와 이용 약관에서 확인할 수 있다.

필요한 환경은 데스크톱용 VS Code 1.101.2 이상, 신뢰하는 폴더로 열린 작업 공간, 그리고 위 제공자 중 하나의 API 키 또는 Ollama를 통한 로컬 모델이다. 신뢰하지 않는 작업 공간과 가상 작업 공간은 지원하지 않는다.

버그나 아이디어는 GitHub 이슈 페이지에 제출할 수 있다. 버그를 보고할 때는 VS Code 버전, 제공자와 모델, 수행한 작업을 함께 적는다. Guide: Show log output 로그를 첨부할 수 있지만, 먼저 코드와 키를 삭제해야 한다.