Claude Code,
노치 안으로.

Mac에서 받는 Claude Code 알림, 권한 요청 승인, 사용량 한도

Gnista는 모든 Claude Code 세션을 MacBook 노치에 보여 줘요. 작업 중인지, 끝났는지, 응답을 기다리는지. 도구 호출을 승인하고, 계획과 질문에 답변하고, 턴이 끝나면 답장까지. 터미널로도, 편집기로도, Claude 앱으로도 돌아가지 않고요.

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

Claude Code 연동, 한눈에.

실행 환경
모든 터미널, 모든 편집기의 터미널, VS Code, Cursor, Devin의 Claude Code 확장 프로그램, Claude 앱의 Code 세션, Xcode의 Claude(방법), 그리고 Linux 서버에서 SSH로 쓰는 Claude Code.
설정
백업한 뒤 ~/.claude/settings.json에 훅을 추가해요. Claude에서 따로 신뢰할 건 없어요.
응답 대기 중
권한 요청, 계획, 질문을, Claude가 묻는 그 순간에.
노치에서 응답
‘허용’, ‘항상 허용’(Claude가 제안한 규칙을 풀어서 보여 줘요), 또는 Claude가 읽을 이유를 적을 수 있는 ‘거부’. 계획과 질문도요.
노치에서 답장
돼요, Claude가 어디서 돌든. 훅이 쓴 말 그대로 세션을 깨워요.
줄에 보이는 것
Claude가 붙인 세션 제목, 입력한 프롬프트, 최근 메시지, 쓰고 있는 도구, 작업 진행 상황, 권한 모드, 컨텍스트, 비용.
서브에이전트
몇 개가 끝났는지, 앞에 선 서브에이전트와 그 단계. 백그라운드 서브에이전트는 끝날 때까지 줄에 남아요.
비용과 한도
API 정가로 계산한 비용, 그리고 Gnista의 상태 줄을 켜면 5시간 한도와 주간 한도.

승인은 앱 전환 없이.

노치가 열리고 요청을 통째로 보여 줘요. 명령이든, 줄 번호가 붙은 diff든요. diff는 바뀐 덩어리만 남기고 접혀요. ‘허용’은 0.5초 뒤에야 눌려서, 잘못 누른 클릭이 허용으로 이어지지 않아요. ‘항상 허용’은 Claude가 제안한 규칙을 적용해요. 먼저 쉬운 말로 보여 주고요. ⌘Y는 허용, ⌘N은 거부. Claude에서도 함께 확인을 요청해요. 어느 쪽에서 응답해도 돼요.

계획과 질문, 그 자리에서 답변.

Claude가 계획 모드를 나오면 노치에서 계획을 읽고 ‘승인’, ‘편집 자동 수락’, 또는 피드백과 함께 ‘계속 계획하기’를 고르세요. 질문은 하나씩 오고, 보기에 없는 답변은 ‘기타…’로 직접 쓸 수 있어요.

한마디 더? 답장하세요.

턴이 끝나면 노치에 답장을 쓰세요. Terminal, iTerm, Ghostty, tmux 페인, 또는 Gnista 확장 프로그램이 있는 편집기의 터미널에서는 Gnista가 대신 입력해 줘요. 그 밖의 곳, VS Code 확장 프로그램이나 Claude 앱에서는 Gnista가 추가한 훅이 쓴 말 그대로 세션을 깨워요. claude -p 실행은 붙잡지 않아요. 평소처럼 끝나요. 터미널에서 Claude Code를 이미 종료했다고요? 답장하면 백그라운드에서 세션이 다시 이어지고, ‘Gnista에서 권한 요청에 응답’이 켜져 있으면 허락이 필요한 일은 노치에서 ‘허용’이나 ‘거부’를 기다려요.

서브에이전트, 한 줄에.

Claude가 서브에이전트에게 일을 넘기는 동안, 줄에는 ‘2개 중 1개 완료 · Review the API · 읽는 중: api.ts’처럼 보여요. 백그라운드에서 도는 서브에이전트는 메시지가 나온 뒤에도, 끝나거나 직접 멈출 때까지 줄에 남아요.

한도가 어디쯤인지 알고 있기.

‘Claude Code 플랜 한도’를 켜면 세션 아래에 5시간 한도와 주간 한도가 보여요. 값은 Claude Code의 상태 줄에서 가져와요. 이미 쓰는 상태 줄이 있으면 감싸 두었다가, 끄면 정확히 원래대로 돌려놓아요. 키체인도, 로그인도, 네트워크도 쓰지 않아요. 비용은 API 정가로 계산해요. Gnista가 모르는 모델이면 모델 파일에 적어 주세요.

Claude Code에서 안 되는 것, 그리고 그 이유.

  • Claude 앱의 Cowork 세션은 가상 머신에서 돌아서, 훅이 Mac까지 오지 않아요. 줄은 앱 자체의 세션 파일에서 가져오고, 요청에는 앱에서 응답해요.
  • Terminal, iTerm, Ghostty, tmux 페인, 또는 Gnista 확장 프로그램이 있는 편집기의 터미널에서는 Gnista가 답장을 대신 입력해 줘요. 그 밖의 곳에서는 훅을 거쳐요. Claude 화면에는 직접 쓴 메시지가 아니라 ‘Stop hook feedback’으로 보이고, 턴이 끝난 뒤 1시간 동안 돼요.
  • 플랜 한도는 Claude Code의 상태 줄로만 들어와서, Gnista의 상태 줄을 켜야 해요.
  • Gnista를 연결하기 전부터 돌던 세션은 예전 훅을 그대로 써요. 새 세션을 시작하세요.
02설정

연결은 1분이면 끝.

  1. Gnista를 열고 Claude Code에 체크하세요. Gnista가 ~/.claude/settings.json을 ~/Library/Application Support/Gnista/Backups/에 백업한 뒤, 기존 훅 옆에 자기 훅을 추가해요. 서식도 그대로예요.
  2. 노치에서 요청에 응답하려면 설정 ▸ 일반 ▸ Gnista에서 권한 요청에 응답을 켜세요.
  3. 비용과 한도를 보려면 설정 ▸ 일반 ▸ 사용량에서 ‘비용’, ‘플랜 한도’, ‘둘 다’ 중 하나를 고르세요. 플랜 한도에는 ‘Claude Code 플랜 한도’ 스위치도 켜야 해요. 그러면 Gnista가 Claude Code의 상태 줄에 함께 연결돼요.
  4. 터미널, 편집기, 또는 Claude 앱에서 새 Claude Code 세션을 시작하세요.
03FAQ

Claude Code, 묻고 답하기.

노치에서 Claude Code의 도구 호출을 허용할 수 있나요?

네. ‘허용’, ‘항상 허용’, 또는 Claude에게 남길 이유를 적을 수 있는 ‘거부’. 설정 ▸ 일반 ▸ Gnista에서 권한 요청에 응답을 켜세요. Claude에서도 동시에 확인을 요청해요. 어느 쪽에서 응답하든, 다른 쪽은 알아서 비켜요.

VS Code 확장 프로그램과 Claude 앱에서도 되나요?

네. 둘 다 같은 훅으로 Claude Code를 실행하니까, 줄, 승인, 계획, 질문, 답장까지 다 돼요. 클릭하면 그 세션의 탭이나 Claude 앱의 세션이 열려요. VS Code는 Gnista의 링크를 열기 전에 한 번 확인을 요청해요. Cowork 세션도 앱 자체의 세션 파일에서 읽어서 보여요. 클릭하면 앱에서 열리고, 요청에는 거기서 응답해요.

제 세션이 왜 안 보이나요?

Claude Code는 세션이 시작될 때 훅을 읽어요. 그래서 Gnista를 연결하기 전부터 돌던 세션에는 훅이 없어요. 새 세션을 시작하세요. Gnista가 무엇을 추가했는지는 설정 ▸ 에이전트 ▸ Claude Code에서 볼 수 있어요.

Gnista가 제 Anthropic 자격 증명을 읽나요?

아니요. 플랜 한도는 Claude Code가 직접 실행하는 상태 줄에서 와요. Gnista는 키체인을 읽지도, Anthropic을 호출하지도 않아요.

설정에서 무엇을 바꾸고, 어떻게 제거하나요?

~/Library/Application Support/Gnista/Backups/에 백업한 뒤, ~/.claude/settings.json에 훅을 추가하고, 플랜 한도를 켰다면 상태 줄도 추가해요. 기존 설정은 그대로예요. 설정 ▸ 에이전트 ▸ Claude Code ▸ 연결 해제를 누르면 Gnista의 훅만 정확히 사라지고, 상태 줄은 원래대로 돌아와요.

서버에서 SSH로 쓰는 Claude Code도 되나요?

네, Linux 서버라면요. 설정 ▸ 원격에서 ssh 설정에 있는 호스트로 서버를 연결하세요. Gnista가 그곳에 헬퍼를 두고, 서버에 있는 Claude Code 설정에 훅을 추가해요. 세션은 머신 이름과 함께 제목, 최근 메시지, 비용까지 보여요. 노치에서 한 응답은 그곳의 Claude에 닿고, 클릭하면 ssh로 접속했던 터미널 탭(tmux 페인 포함)이나 편집기의 Remote-SSH 윈도우로 이동해요. 단계별 안내: SSH로 쓰는 에이전트.

Gnista가 함께 지켜보는 에이전트

에이전트를 직접 만들었나요? JSON 한 줄이면 Gnista에 상태를 알릴 수 있어요. 자세한 건 커스텀 에이전트에서.