ZCode,
노치 안으로.

네. Z.ai의 ZCode, 그 데스크톱 앱과 zcode CLI예요.

Mac에서 받는 ZCode 알림과 권한 요청 승인

Gnista는 모든 ZCode 세션을 MacBook 노치에 보여 줘요. 작업 중인지, 끝났는지, 권한을 기다리는지. ZCode가 뭔가 실행하려 하면 거기서 허용하거나 거부하세요.

7일 무료로 써 보기 계정·카드 불필요 · 이후 €19 한 번

01한눈에

ZCode 연동, 한눈에.

실행 환경: ZCode 데스크톱 앱, 그리고 zcode CLI.
설정: 백업한 뒤 ~/.zcode/cli/config.json에 훅을 추가해요. ZCode를 한 번 다시 여세요.
응답 대기 중: 권한 요청을, 명령이나 파일과 함께, ZCode가 확인을 요청할 그 순간에.
노치에서 응답: ‘허용’ 또는 ‘거부’. ‘항상 허용’은 없어요.
노치에서 답장: 앱에는 안 돼요. zcode CLI라면 터미널에 대신 입력해 줘요. Terminal, iTerm, Ghostty, tmux 페인, 또는 Gnista 확장 프로그램이 있는 편집기의 터미널에서요.
줄에 보이는 것: 세션 제목, 입력한 프롬프트, 메시지, 실행 중인 도구, 할 일 진행률, 토큰과 컨텍스트. ZCode 자체의 데이터베이스에서 읽어요.
서브에이전트: 아직이에요.
비용과 한도: 토큰과 컨텍스트. ZCode가 기록하지 않아서 Z.ai 플랜에서는 비용이 없고, 플랜 한도도 없어요.

ZCode는 직접 확인을 요청할 때만 Gnista의 권한 훅을 실행해요. 노치는 무엇을 실행하려는지 정확히 보여 줘요. 허용하면 실행되고, 거부하면 실행되지 않아요.

줄은 ZCode가 다루는 명령과 파일을 따라가고, 턴이 끝나면 메시지를 보여 줘요. 돌아가 봐야 할지 바로 알 수 있어요.

‘항상 허용’은 없어요. ‘허용’은 이번 호출에만 적용돼요.
Z.ai 플랜에서는 비용이 없어요. ZCode가 기록하지 않아서, 줄에는 토큰과 컨텍스트만 보여요. 플랜 한도도 없어요.
서브에이전트는 줄에 보이지 않아요.
클릭하면 세션이 아니라 ZCode 윈도우가 열려요. 앱에 세션으로 가는 링크가 없거든요.
노치에서 보낸 답장은 ZCode 앱에는 닿지 않아요. zcode CLI라면 터미널에 입력돼요. Terminal, iTerm, Ghostty, tmux 페인, 또는 Gnista 확장 프로그램이 있는 편집기의 터미널에서요.

02설정

Gnista를 열고 ZCode에 체크하세요.
Gnista가 ~/.zcode/cli/config.json을 백업하고 훅을 추가해요. 기존 훅은 그대로 두고, 직접 꺼 두지 않았다면 ZCode의 훅을 켜요.
ZCode를 종료했다가 다시 여세요. ZCode는 시작할 때만 훅을 읽어요.
노치에서 응답하려면 설정 ▸ 일반 ▸ Gnista에서 권한 요청에 응답을 켜세요.

03FAQ