Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
ZCode JetBrains 플러그인은 코딩 도우미 ZCode를 JetBrains IDE에 통합하여 개발 워크플로우를 개선합니다. 사용자는 에디터에서 벗어나지 않고도 하나의 창에서 세션, 대화, 모델 및 작업 관리를 할 수 있습니다. 이 플러그인은 터미널 전환 없이 자연스러운 AI 코딩 경험을 제공하는 것을 목표로 합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기간체 중국어 · English
GitHub Stars GitHub Forks GitHub Issues License
ZCode 코딩 도우미를 JetBrains IDE에 가져오세요: 터미널 전환 없이, 에디터에서 벗어나지 않고 세션, 대화, 모델 및 작업 관리를 하나의 도구 창에서 완료할 수 있습니다. AI의 브라우저 사용 기능은 플러그인 내장 브라우저를 직접 구동하여 작업을 수행할 수도 있습니다.
🙏 오픈 소스 프로젝트 CC GUI (jetbrains-cc-gui)(MIT)에 깊이 감사드립니다. 본 프로젝트 작성자는 CC GUI + Claude Code 워크플로우의 장기 사용자이며, UI 디자인은 이를 깊이 참고했습니다: 전체 레이아웃, 상태 패널, 입력 영역 상호작용, 테마 시스템, 파일 유형 아이콘 역시 해당 프로젝트에서 가져왔습니다. 오픈 소스 작업을 해주신 zhukunpenglinyutong 님께 감사드립니다.
커뮤니티 서드파티 플러그인이며 ZCode / Z.ai 공식 제품과 무관합니다. 사용하기 전에 로컬에 ZCode CLI를 설치하고 로그인을 완료해야 합니다.
본 프로젝트는 개인적인 취미 프로젝트이며, 최선을 다해 유지보수하겠지만 실시간 응답을 보장할 수는 없습니다. PR(Pull Request)을 제출하여 함께 개선하는 것을 환영합니다.
저는 항상 JetBrains 제품군(IDEA + PyCharm)으로 코딩을 해왔고, 이미 CC GUI 플러그인 + Claude Code 조합에 익숙해져 있습니다. IDE 사이드바에서 AI 세션을 관리하고, 스트리밍 출력을 확인하며, 도구 호출을 추적하는 방식은 터미널 전환이 필요 없어 워크플로우가 매우 자연스러웠습니다.
나중에 두 가지 사건이 겹치게 되었습니다: Claude Code가 사용자가 모르는 사이에 데이터를 수집한다는 보안 문제가 제기되어 회사 측에서 데이터 안전을 이유로 기능을 비활성화했습니다. 그리고 대체재인 ZCode는 기능은 좋지만, JetBrains 플러그인이 없었습니다. JetBrains의 습관을 바꾸기는 어렵고, ZCode도 포기하기 아까웠기에, 결국 직접 손을 대기로 했습니다. 익숙한 CC GUI 스타일의 경험을 ZCode에 옮겨와서 말입니다.
사실 IDE 내에서 CLI(Command Line Interface) 형태의 AI 도구를 사용하는 것은 공통적인 불편함이 있습니다. 어떤 회사의 CLI든 마찬가지입니다:
이 프로젝트의 목표는 단 하나입니다: 코드를 작성하는 바로 그곳에서 ZCode의 핵심 기능을 사용할 수 있게 하는 것입니다. 도구 창을 열면 여러 개의 탭으로 각기 다른 작업을 관리할 수 있고, 스트리밍 대화가 실시간으로 표시되며, 서브 에이전트가 무엇을 하고 있는지, 작업 목록은 어디까지 진행되었는지, 어떤 파일들이 수정되었는지가 한눈에 들어옵니다.
대화: 스트리밍 출력(사고 과정 / 본문 / 도구 호출 실시간 렌더링), Markdown / Mermaid / 코드 하이라이팅, 사고 소요 시간 통계, 메시지 대기열 관리(생성 중 엔터 시 자동으로 대기열에 추가되며, 대기열 카드는 즉시 전송 / 삭제 / 순서 변경 유도 가능—생성을 방해하지 않음. AI가 대화 도중 지침을 받아 방향을 조정할 때, 안내 메시지는 ⚡ 배지를 가지며, 위로 이동 / 아래로 이동 정렬도 지원), 마지막 사용자 메시지 편집 및 재전송(수정 후 해당 라운드가 자동으로 되돌아가 다시 생성됨), AI 답변 한 번 클릭으로 재전송(재전송 불가 시 이유 설명), 입력 초안을 세션에 영구 저장(세션 전환 / IDE 재시작해도 사라지지 않음), 세션 내 예약 전송(미리 설정된 시간 + 프롬프트가 되면 자동으로 실행되며, 지정 모델 / 새 세션에서 실행 가능. 작업 목록은 세션을 넘어 관리할 수 있으며, AI도 예약 작업을 생성할 수), Ctrl+F 세션 내 검색(대소문자 구분 / 전체 단어 / 정규식), 메시지 앵커 탐색(사용자 메시지에 원형 포인터 위치 + 마우스 오버 미리보기)
다중 작업(多任务) — 다중 탭 병렬 세션 지원 (각 탭이 독립적인 컨텍스트를 가지며 상호 간섭 없음, 새 세션 생성 시 선택적 가로채기 확인: 현재 탭 덮어쓰기 / 새 탭 열기), IDE 재시작 자동 복구, 세션 목록 관리 / 이름 변경 (AI가 최근 대화를 기반으로 제목을 다시 지정하는 기능 지원) / 검색 / 일괄 다중 선택 삭제, 세션 고정 (ZCode 공식 클라이언트와 동일 라이브러리 간 상호 통신 가능), 읽지 않은 표시 (시야에서 벗어난 후 새 메시지를 받으면 읽지 않은 모서리 배지가 표시되며, 열면 자동 초기화), 승인 대기 / 입력 중인 세션의 빨간 점 알림, 비활성 세션 아카이브 수납 (자동 아카이빙 지원), 임의의 과거 답변을 클릭 한 번으로 새 세션으로 분기 (작업 수행 중에도 가능), 탭 이름 변경
과정 시각화(过程可视) — 작업 목록(TodoWrite) 실시간 진행률, 서브 에이전트(Agent) 패널 및 실행 과정 / 최종 보고서 팝업, 백그라운드 작업 요약 진입점 (상태 패널에서 '백그라운드 작업 / 에이전트 작업'을 집중적으로 확인), 라운드별 파일 변경 추적 바 (이번 라운드에서 어떤 파일이 수정되었는지, 추가/삭제된 줄 수, 이번 라운드 전체 변경 사항 한 번에 되돌리기 가능), 회차 산출물 미리보기 카드 (라운드 종료 시 새로 생성되거나 수정된 파일을 클릭하면 바로 확인 가능), 파일 변경 통계 (편집기에서 클릭하여 열람, 인라인 diff 전후 비교), AskUserQuestion 상호작용 팝업 (하단에 고정되어 최소화 가능, 기본적으로 답변을 기다리며, 회차 종료 시 당시의 질의응답 내용을 다시 볼 수 있음), 계획 모드(ExitPlanMode) 승인 패널 (입력창 위에 고정되며, 무제한 대기 가능하며 의견을 입력하여 계획을 계속 개선할 수 있음)
목표 모드(目标模式) — /goal로 장기 목표를 설정하면 자동으로 다중 라운드로 진행: 매 라운드 작업 종료 시 서버 측에서 독립적으로 한 번 검증 (타임라인 분리 카드에 통과 여부 및 다음 행동 표시), 미통과 시 목표 달성할 때까지 자동 연속 실행; 우상단 목표 카드가 라운드 수 / 소요 시간 / 검증 중 상태를 실시간으로 표시하며, 일시 정지 / 재개 / 목표 변경 / 2차 확인 후 삭제가 가능하고, 목표 및 라운드 진행 상황이 재부팅을 거쳐도 복구됨
내장 브라우저(内嵌浏览器) — 헤더를 클릭하면 채팅창 오른쪽에 브라우저 분할 창이 열림: 다중 탭 (전역 공유, 세션 간 유지), 뒤로 가기 / 앞으로 가기 / 새로고침 / 주소 표시줄 / 자유 크기 조절 (DevTools 장치 도구 모음 형태의 가상 화면) / DevTools / 외부 열기. Ctrl + 마우스 휠을 이용한 네이티브 확대/축소 및 백분율 지시자 표시, 브라우저 콘솔(CDP)에서 사이트 데이터 정리 및 개요 확인 가능; 플러그인이 호스트로서 browser-use 역방향 프로토콜을 구현하여, AI는 어떤 설정도 필요 없이 이 브라우저를 탐색하고, 스크린샷을 찍고, JS를 실행하며, playwright 디텍터와 CUA 마우스/키보드 조작을 수행할 수 있음
컴퓨터 제어(电脑控制) — 설정 페이지에서 활성화하면 세션에 내장된 Computer Use 도구면이 주입됨: AI는 애플리케이션 / 창을 나열할 수 있음 (애플리케이션 아이콘 및 전경 표시 포함), 스크린샷 인식 (하위 영역 확대 지원), 좌표 클릭 / 드래그 / 휠 / 조합 키 입력, 창 관리 (이동 / 크기 조절 / 최소화 / 복원, 읽기 검증), 일괄 매크로를 한 번에 여러 단계 실행; 모든 동작은 기본적으로 실행 후 스크린샷을 첨부하며, 채팅 흐름에서 도구 카드로 실시간 표시되고, 썸네일 클릭 시 전체 화면으로 전환되며, 입력창의 '컴퓨터 작업' 버튼을 누르면 기능이 삽입됨
런타임 제어(运行时控制) — 모델 드롭다운 전환 (내장 채널은 ZCode 클라이언트의 현재 활성 채널을 따르며, 드롭다운 내에서 수동 새로고침 가능; Z.ai 구독 계정 채널은 직결되어 OAuth 로그인 즉시 사용 가능하며 API Key가 필요 없음, 할당량 페이지에 요금제 사용량이 동기화 표시), 권한 모드(build / edit / plan / yolo) 및 사고 수준(모델에 따라 동적 조정)을 조절할 수 있으며, 대기 상태(세션 미생성)에서 사전 선택 가능하고, 세션을 생성하면 즉시 적용됨; 컨텍스트 용량 원형 그래프 (사용량 구성 및 캐시 적중률 포함, 더블 클릭으로 컨텍스트 압축 가능), 5시간 / 주간 할당량 조회, 할당량 잔여물 배너 (5시간 풀이 낮을 경우 알림 및 재설정 시간 표시)
설정 센터(设置中心) — 열 개의 탭: 기본 (외관: 테마 / 글꼴 / 언어 / 커스텀 색상; 환경: 경로 수동 설정 또는 자동 감지; 동작: 입력 기록 완성 등), 모델 (내장 채널은 ZCode 클라이언트 설정에 따르며, 현재 활성 채널만 표시하고 적중 방식을 표기함(클라이언트 선택 / 기본 적용), Z.ai 계정 채널은 OAuth 직결; 내장 채널은 커스텀 API Key를 지원하며—팀 요금제는 bigmodel 오픈 플랫폼에서 프로젝트 키를 가져와 입력하면 팀 할당량을 사용하게 되며, 카드는 현재 실제 청구되는 key(기본적으로 마스킹되며 전체 확인 가능)와 출처가 표시됨. 미설정 시 청구 알림 제공; 서드파티 공급업체는 활성화/비활성화 가능하며, 일반적인 공급업체는 사전 설정된 카드 선택 후 Key만 입력하면 됨; 경로 추적은 데이터 디렉토리 마이그레이션을 따르며, 추가/삭제 안내는 Zcode 설정으로 이동하여 설정하고 한 번에 구성 파일을 열 수 있음), 사용량 (애플리케이션 사용량: 로컬 세션 통계로 서드파티 모델을 포함하며, 7일 / 30일 / 전체 구간; GLM 요금제 사용량: 할당량 카드 + 모델/도구 사용량 곡선 및 상세표, 조회 증명 출처 채널과 사용된 key(마스킹)를 표시), 메모리 (AGENTS.md 명령어 메모리 + 자동 메모, 누락 시 생성 가능하며 전체 텍스트 검색 지원), 스킬 (전역 / 프로젝트 / 플러그인 세 가지 출처에서 스캔, 인라인 활성화/비활성화), 서브 지능체 (커스텀 Agent 설정), MCP (서버 목록 / 도구 목록 / 연결 로그), 브라우저 (내장 브라우저 제어 및 사이트 데이터 정리), 프로세스 (상주 / 자식 프로세스 / 의심되는 고립 세 가지 분류, 정확한 제거 가능), 기타 (입력 기록 완성 스위치 및 기록 관리)
다중 작업 공간(Multi-Workspace) — 여러 프로젝트를 관리하는 도구 창: 다른 프로젝트의 디렉터리를 현재 IDE 세션 탭에 마운트할 수 있습니다 (공식 Attach와 동일한 메커니즘으로, 플러그인이 자동으로 모듈을 생성하고 담지하며, Idempotent(멱등)하게 재진입 가능). 여러 디렉터리에 걸친 세션은 동일한 기록 목록에서 디렉터리 칩(chips)별로 그룹화되어 표시됩니다 (칩은 상주하며 드래그하여 정렬 가능, 디렉터리 색상 블록으로 한눈에 구분이 가능하며, 세션 제목 배지는 디렉터리 색상과 동기화됨). 에디터/프로젝트 뷰에서 우클릭 시 파일이나 선택된 코드를 다른 작업 공간 탭의 입력창으로 직접 전송할 수 있습니다 (여러 목표 지점일 경우 하위 메뉴로 접혀서 선택, 목표 탭이 존재하지 않으면 자동으로 새로 생성). 모바일 기기에서도 다중 작업 공간 동기화를 지원하여 마운트된 디렉터리의 프로젝트와 세션을 원격으로 열고 조작할 수 있습니다.
모바일 원격 세션 — Z.ai 모바일 앱을 통해 데스크톱 IDE 내부의 세션을 원격으로 확인하고 조작할 수 있습니다: 작업 목록, 모델 선택, 장치 이름 지정 등 전체 연결 고리가 확보되었으며, HTTP 프록시 환경 접속을 지원합니다.
IDE 통합 — 프로젝트 뷰/에디터 탭에서 우클릭하여 파일을 전송하거나, 에디터에서 우클릭하여 선택된 코드를 입력창으로 전송할 수 있습니다 (Ctrl+Alt+K). 선택 영역을 복사하여 참조(경로 + 줄 번호)를 얻을 수 있습니다. 파일, 메모리(Memory), 스킬(Skill), MCP 설정 모두 한 번의 클릭으로 에디터에서 열 수 있습니다.
입력 강화 — @을 사용하여 파일 참조 (칩 + 자동 완성, 절대 경로 붙여넣기 또는 시스템에서 파일을 드래그하면 자동으로 칩으로 변환되며 폴더 지원), $ 스킬 언급 (슬래시(/)와 나란히 있는 두 번째 스킬 진입점, 동일 이름의 스킬은 출처별로 접혀서 중복 제거), 현재 파일 컨텍스트 칩 (에디터에서 열린 파일 및 선택 영역을 실시간으로 추적하며, 체크 후 메시지에 암시적으로 포함되고, 말풍선에는 수동 입력 원문만 표시), /를 사용하여 스킬 호출, 긴 텍스트 붙여넣기 접기 기능, 입력 기록 되돌리기 및 전위(Prefix) 유령 자동 완성 (Tab 키로 채택).
다국어 지원 — 간체 중국어 / English / 일본어 / 한국어 / 번체 중국어로, IDE 인터페이스 언어를 따라 자동으로 전환됩니다.
내장 브라우저 · browser-use 호스트(ZCode 클라이언트의 주요 기능을 재현)
内嵌浏览器：编辑器 / AI 会话 / 内嵌浏览器三栏同屏，浏览器里是本插件仓库页
헤더 지구 버튼은 채팅 영역 오른쪽에서 브라우저 분할창을 펼칩니다 (위 이미지는 전체 IDE: 에디터, AI 세션, 내장 브라우저 세 개의 열이 한 화면에 표시됨): 도구 모음의 뒤로/앞으로/새로고침/주소 표시줄/자유 크기/DevTools/외부 열기가 있으며, 여러 탭은 전역적으로 공유되고 세션 간에도 유지됩니다. 너비는 드래그하여 조정할 수 있으며, 접어도 페이지 내용은 보존됩니다.
이것은 단순한 내장 브라우저가 아닙니다. 플러그인은 ZCode app-server의 browser-use 호스트 프로토콜( interaction/browserList / browserExecute 역방향 요청)을 구현하여, AI가 browser-use 도구를 호출할 때 이 JCEF 브라우저에서 설정 없이(Zero-config) 실행됩니다:
위 이미지에서 브라우저 분할창은 본 플러그인 저장 페이지를 열고 있습니다. 스크린샷, DOM 읽기, GUI 검수 등의 작업은 전 과정에 걸쳐 AI가 browser-use를 통해 자율적으로 완료할 수 있습니다.
대화 및 프로세스 시각화(아래 스크린샷은 실제 IDE와 실제 세션에서 가져온 예시 데이터입니다)
| 스트리밍 생성 중: 사고 블록 / 서브 에이전트 카드 실시간 카운트 / 정지 버튼 | 전체 세션: 도구 그룹 카드 / 프로세스 목록 / AI 요약 / 라운드별 파일 변경 사항 한 번에 되돌리기 | :---: | :---: |
| 流式生成中 | 
完整会话 |
| ... | 계획 모드 승인(ExitPlanMode): 계획 전문이 입력창 위에 고정되며, <br>승인 / 거부 / 의견 입력으로 계획을 계속 개선하고 무제한 대기합니다. | :---: | AskUserQuestion 상호 작용 팝업: 하단에 고정되며, 무제한 대기합니다. <br>답변 후 라운드 내에서 다시 볼 수 있습니다. |
| :---: | :---: |
| 计划模式审批 | 
AskUserQuestion 交互弹窗 |
목표 모드(/goal) (자동 다중 라운드 진행)
다중 라운드 진행 중: 각 라운드 검증 분리 카드(불통과 → 다음 단계 행동) + 목표 카드 라운드/소요 시간/검증 중
| :---: | :---: |
| 目标模式运行中 | 
目标模式完成 |
예약 작업(스케줄링) · 모바일 원격 · 실행 시간 제어 · 컴퓨터 제어
| 수동 생성 예약 전송(미리 설정된 시간 또는 바로가기 슬롯, 모델 지정/새 세션 실행 가능) | AI를 이용한 예약 작업 생성(실행 카드 + 예정 전 대기열 미리 보기, 즉시/편집/취소 가능) |
|---|---|
 |  |
| ... | |
| 다중 워크스페이스 |
| 다중 탭 병렬 세션: 디렉토리 색상 블록 태그(채움=세션 있음 / 비어있음=빈 태그), 제목 로고가 디렉토리 색상을 동기화 | 세션 기록을 디렉토리 칩(chips)으로 그룹화: 칩은 상주하며 드래그하여 정렬 가능, 색상 구분이 한눈에 파악됨 |
|---|---|
 |  |
입력 강화 및 다중 작업
| @ 파일 참조 자동 완성 | $ 스킬 언급(출처별 접기) | / 스킬 호출 |
| :---: | :---: | 技能补全 |
| 세션 목록(고정 / 미확인 배지 / 검색 / 다중 선택 삭제) | 환영 페이지(대기 상태에서 모드 및 사고 수준 사전 선택 가능) |
| 会话列表 | 
欢迎页 |
설정 센터
| 기본 설정(테마/글꼴/언어/사용자 정의 색상) | 모델 관리(계정 직접 연결 / 공급업체 사전 설정 / 타사 활성화/비활성화) |
|---|---|
 |  |
| ... |
# 원클릭 정리 및 재구축(권장):
# Gradle 빌드 디렉토리 + webview 캐시 삭제 → 이중 산출물 구축(다중 파일+sourcemap / singlefile 폴백) → buildPlugin
# 산출물: intellij-plugin/build/distributions/ZC-GUI-<버전>.zip (IDE 내 오프라인 설치)
...
프론트엔드는 IDE와 분리하여 독립적으로 개발 가능(자동으로 목업 데이터 소스 전환): cd webview && npm run dev
프로덕션 모드에서는 플러그인이 내장 HttpServer(127.0.0.1 임의 포트)를 사용하여 다중 파일 산출물을 서빙합니다—webview는 실제 origin과 sourcemap을 가지며, DevTools에서 TS/TSX 소스 코드를 직접 보고 중단점을 설정할 수 있습니다; 서버 시작 실패 시 singlefile 단일 파일 로딩으로 자동 다운그레이드됩니다.
JetBrains Gateway를 이용한 원격 개발(SSH 원격 호스트 / WSL2)을 지원하며, 플러그인은 백엔드 IDE에만 설치해야 합니다:
/opt/ZCode/app/resources/glm/zcode.cjs; 또는 플러그인 설정 → 기본 설정 → 환경에서 수동으로 경로 지정 가능) 및 로그인 자격 증명(~/.zcode/v2/).플러그인은 자식 프로세스 방식으로 ZCode의 app-server(node zcode.cjs app-server)를 시작하고, stdin/stdout을 통해 JSON-RPC로 세션을 구동합니다; 이벤트 흐름은 세션별로 분배되며, JCEF에 배치 스트리밍(throttling batch push)됩니다. 프론트엔드 reducer는 이를 메시지 트리와 작업 / 자식 에이전트 / 파일 변경 등의 파생 상태로 증분적으로 환원합니다. 플러그인은 또한 호스트 역할을 수행하여 app-server의 하향 브라우저 사용 호스트 프로토콜(interaction/browserList / browserExecute 역방향 요청)을 구현함으로써, AI의 브라우저 도구를 내장 JCEF 브라우저에 실행하도록 합니다.
graph LR
UI[webview React UI] <-->|"JCEF 브릿지(이벤트 16ms 일괄 병합)"| Plugin[IntelliJ 플러그인<br/>다중 탭 + JS 브릿지 + 내장 브라우저]
Plugin --> Client[protocol-client<br/>JSON-RPC 클라이언트]
...
app-server 프로토콜 측면(RPC 메서드 목록, V4 세션 프로토콜, 역방향 요청, 이벤트 스트림, 오류 코드)에 대한 정리는 docs/zcode-appserver-protocol.md를 참조하십시오.
본 프로젝트는 개인 오픈 소스 프로젝트이며, ZCode / Z.ai 공식 제품이 아닙니다. "ZCode" 및 "Zai" 이름과 아이콘의 저작권은 해당 소유자에게 있습니다. 사용으로 인해 발생하는 비용 및 크레딧 소모는 사용자 본인의 ZCode 계정에서 부담해야 하므로, ZCode 서비스 약관을 준수해 주십시오. 프로토콜 구현은 CLI app-server 인터페이스 분석을 기반으로 했으며, 공식 버전 업그레이드에 따라 적응(adaptation)이 필요할 수 있습니다.