한국형 기업용 AI 코딩 에이전트 비즈코더(BizCoder)를 에디터에서 바로 실행하는 확장입니다.
VS Code·Cursor·Windsurf·VSCodium 모두 지원합니다 — 확장 탭에서 BizCoder를 검색해 설치하세요.
로컬 파일·터미널·디버깅과 함께 쓰는 AI 코딩 — 웹 기반 AI의 한계 없이 개발 워크플로에 통합됩니다.
이 확장은 BizCoder CLI 0.3.x 와 0.4.x 모두에서 동작합니다. CLI 를 언제 올리든 확장은 그대로 쓰면 됩니다.
확장이 설치된 bizcoder 의 버전을 스스로 확인해(창마다 한 번) 그 버전에 맞는 방식으로 띄웁니다. 따로 설정할 것은 없습니다.
CLI 를 올리거나 내리면 다음에 여는 BizCoder 터미널부터 새 버전의 방식으로 동작합니다(이미 열려 있는 터미널은 그대로 둡니다).
bizcoder 를 찾지 못하면 설치 안내가 뜹니다. PATH 밖에 설치했다면 설정 bizcoder.server.command 에 전체 경로를 적어 주세요.
CLI 0.3.x
CLI 0.4.x
실행
bizcoder --port <포트> (터미널마다 서버)
bizcoder --session <ID> (백그라운드 서비스 하나를 함께 씀)
열 때 보던 파일 자동 입력
지원
지원 (에디터의 셸 통합이 켜져 있을 때 — 기본값)
파일 참조 단축키
지원
지원
실시간 변경사항 보기
터미널별
세션별
서버 설정(bizcoder.server.mode·registrationFile)
해당 없음
지원
기능 (Features)
바로 실행: Cmd+Esc(Mac) / Ctrl+Esc(Windows·Linux)로 분할 터미널에 BizCoder를 엽니다. 이미 실행 중이면 해당 세션에 포커스합니다.
보던 파일 자동 입력: BizCoder를 열면 그때 보고 있던 파일(과 선택 영역)이 입력줄에 In @File#L37-42 처럼 미리 들어갑니다. 보내지는 않으니 이어서 요청을 적으면 됩니다.
새 세션: Cmd+Shift+Esc(Mac) / Ctrl+Shift+Esc(Windows·Linux)로 새 BizCoder 터미널 세션을 시작합니다. 에디터 상단의 BizCoder 버튼으로도 열 수 있습니다.
파일 참조 단축키: Cmd+Option+K(Mac) / Ctrl+Alt+K(Windows·Linux)로 현재 파일(과 선택 영역)의 참조를 BizCoder 터미널 입력줄에 넣습니다. 예: @File#L37-42.
실시간 변경사항 보기: BizCoder가 고친 파일이 탐색기 아래 「BizCoder 변경사항」 뷰에 모입니다(추가·삭제 줄 수, 추가/수정/삭제 표시). 파일을 누르면 VS Code 기본 diff 에디터로 「변경 전 ↔ 현재」를 바로 대조할 수 있어, 따로 Git 도구를 열 필요가 없습니다. 모델이 한 단계를 마칠 때마다 갱신됩니다.
상태바 알림: 변경된 파일이 생기면 BizCoder: N개 파일 변경이 상태바에 나타나고, 누르면 변경사항 뷰가 열립니다. 변경이 없으면 숨겨집니다.
자동 열기(선택): 설정 bizcoder.diff.autoOpen을 켜면, 파일이 바뀔 때마다 마지막으로 바뀐 파일의 diff를 옆 창에 자동으로 엽니다(입력 중인 창의 포커스는 가져가지 않습니다). 기본값은 꺼짐입니다.
세션별 변경사항(CLI 0.4.x): 변경 목록은 BizCoder 세션 단위로 따로 관리되고, 이 작업영역 폴더와 겹치는 위치의 세션만 보여 줍니다. 한 세션 안에서 여러 번 고친 파일은 「처음 상태 ↔ 지금」의 순변화로 합쳐집니다(확장이 연 터미널의 세션은 첫 요청부터, 다른 곳에서 이어 가는 옛 세션은 확장이 처음 본 요청부터 — 며칠 전에 한 일이 이미 커밋됐는데 다시 보이지 않게 합니다). BizCoder 터미널을 닫으면 그 터미널의 세션이 목록에서 빠지고, 마지막 터미널을 닫으면 서버 연결도 정리됩니다. 연결이 끊기면 조용히 다시 연결합니다. CLI 0.3.x 에서는 변경 목록이 터미널 단위로 관리됩니다(터미널이 여럿이면 「BizCoder 터미널 N」 아래에 모입니다).
변경사항 보기는 git 저장소 안에서 동작합니다(BizCoder가 git 기준으로 변경을 기록합니다). 새로고침이 필요하면 뷰 제목줄의 ↻ 또는 명령 BizCoder: 변경사항 새로고침을 사용하세요. 명령 팔레트에서 BizCoder: 변경사항 보기로도 열 수 있습니다.
BizCoder 서버와의 연결 (CLI 0.4.x)
CLI 0.3.x 는 터미널마다 서버를 따로 띄웁니다(bizcoder --port <포트>). 확장이 포트를 정해 주고 그 서버에 직접 붙으므로 아래 설정 중 bizcoder.server.command 만 적용됩니다.
BizCoder CLI 0.4.x는 터미널마다 서버를 따로 띄우지 않고 하나의 백그라운드 서비스를 함께 씁니다(기본).
확장은 서비스가 남기는 등록 파일(~/.local/state/bizcoder/service.json)을 읽어 그 서비스의 이벤트 스트림에 붙습니다 — 서비스를 대신 띄우거나 끄지는 않습니다.
설정
설명
bizcoder.server.mode
auto(기본): 백그라운드 서비스를 함께 씁니다. 서비스를 꺼 둔 환경(bizcoder service set disabled true)이면 private으로 동작합니다. shared: 항상 백그라운드 서비스를 씁니다. private: 터미널마다 확장이 전용 서버를 따로 띄워 bizcoder --server <주소> 로 붙습니다(--standalone처럼 서로 격리됩니다).
bizcoder.server.command
터미널에서 실행할 명령(기본 bizcoder). PATH에 없으면 전체 경로를 적습니다.
bizcoder.server.registrationFile
서비스 등록 파일 위치. 셸에서 XDG_STATE_HOME을 바꿔 쓰면 VS Code가 그 값을 몰라 서비스를 못 찾을 수 있으니, 그때 직접 지정합니다.
터미널에서 직접 bizcoder --standalone 으로 띄운 세션은 서버 주소를 확장이 알 수 없어 변경사항 뷰에 나타나지 않습니다. 변경사항 뷰가 필요하면 확장의 「BizCoder 열기」로 연 터미널을 쓰세요(서비스를 꺼 둔 경우는 자동으로, 그 밖에는 bizcoder.server.mode 를 private 으로 하면 전용 서버가 쓰입니다).
확장이 연 BizCoder 터미널은 bizcoder --session <ID> 로 실행되어, 첫 요청이 그 ID로 세션을 만듭니다(터미널 ↔ 세션이 이어져 변경사항 뷰에 「터미널 N」 으로 표시됩니다).
보던 파일 자동 입력은 BizCoder 화면이 뜬 것을 터미널 출력으로 확인한 뒤에 넣습니다. 에디터의 셸 통합(terminal.integrated.shellIntegration.enabled, 기본 켜짐)을 꺼 두었거나 셸 통합이 없는 셸에서는 자동으로 넣지 않으니, 파일 참조 단축키(Cmd+Option+K / Ctrl+Alt+K)를 쓰세요.
bun install — sdks/bizcoder-vscode 디렉토리 안에서 실행합니다.
F5로 디버깅 시작 — 확장이 로드된 새 VS Code 창이 열립니다.
시험
단위 시험(순수 로직: CLI 세대 판정, SSE 파서, 이벤트 해석, 서버 발견, patch→변경 전 내용 복원, 연결/재시도, 세션 장부, 0.3.x 서버 규약 src/unit/v1): bun run test:unit
실서버 시험: bun run test:e2e — 이 저장소의 BizCoder 서버를 소스로 띄우고(가짜 모델·임시 HOME) 확장의 연결·변경 목록 로직을 실제 이벤트로 검증합니다. VS Code는 필요 없습니다.
진짜 VS Code + 진짜 CLI 끝단 시험: bun run test:real -- --cli v1 --bin <0.3.x 실행 파일> --vsix <확장.vsix> (그리고 --cli v2 --bin <0.4.x 실행 파일>) — 격리된 프로필에 VSIX 를 설치하고, 단축키·타이핑·클릭으로 「열기 → 파일 참조 → 모델이 파일 수정 → 변경사항·diff」 를 확인하며 단계마다 화면을 찍습니다(e2e/real-vscode.ts). VSIX 는 script/package <경로> 로 만듭니다.
통합 시험(실제 VS Code 안에서 트리·상태바·diff 에디터까지): bun run compile-tests && bun run test — 지원하는 가장 낮은 버전(1.94.2)을 내려받아 돌고, 다른 버전은 VSCODE_TEST_VERSION=stable 처럼 고릅니다. 내려받지 않고 설치된 VS Code로 돌리려면 VSCODE_TEST_EXECUTABLE="/Applications/Visual Studio Code.app/Contents/MacOS/Code" 를 줍니다(사용자 데이터·확장 폴더는 임시 폴더로 격리됩니다).
변경 사항 반영
디버깅 중 tsc·esbuild 워처가 자동 실행되어 변경 사항을 백그라운드에서 다시 빌드합니다.
디버그 VS Code 창에서 Cmd+Shift+P
Developer: Reload Window 검색
리로드하면 디버그 세션 재시작 없이 변경 사항이 반영됩니다.
구조 (CLI 두 세대)
src/cli/detect.ts — 설치된 CLI 의 세대 판정(0.4.0 미만 = v1). 실행 파일 옆 package.json → --version → 로그인 셸 순서로 알아내고, 실행 파일이 바뀌거나 실행이 실패하면 다시 알아냅니다.
src/backend/v1.ts · src/backend/v2.ts — 세대별 뒷단(같은 인터페이스 backend/types.ts). v1 의 서버 규약은 src/v1/(확장 0.2.0 에서 옮겨 온 코드), v2 는 src/diff/·src/v2/.
src/diff/ui.ts — 변경사항 화면. 두 세대의 서버를 ChangeSource(src/diff/source.ts) 하나로 봅니다.
발행
script/publish — VS Code 마켓플레이스와 Open VSX 두 곳에 같은 버전을 올립니다(자격: VSCE_PAT, OPENVSX_TOKEN). 버전 정본은 package.json의 version 입니다.