Claude Code, Codex, Gemini CLI의 작업 완료 알림 설정을 만들어 보세요.

Codex 내장 알림에 벨을 사용하세요.

선택 사항: Codex의 내장 Mac 알림을 사용하세요.

설정할 파일: ~/.codex/config.toml

파일에 이미 [tui] 섹션이 있으면 [tui] 줄을 다시 추가하지 마세요. 기존 섹션에서 아래 키 중 이미 있는 키는 값을 바꾸고, 없는 키만 추가하세요. [tui] 헤더나 같은 키를 두 번 쓰면 Codex가 파일을 읽지 못합니다.

벨의 동작은 터미널에 따라 다릅니다. Terminal에서는 Settings > Profiles > Advanced > Bell을 열어 소리, 배지 또는 Dock 아이콘이 튀어 오르는 효과를 선택하세요.

선택한 알림에 사용할 훅입니다.

설정할 파일: ~/.claude/settings.json

파일의 "hooks" 객체에 기존 항목을 유지하면서 이 항목들을 추가하세요. 다른 설정이나 다른 도구의 훅이 들어 있을 수 있으므로 파일 전체를 교체하지 마세요. 설정 파일은 엄격한 JSON 형식이므로 주석이나 마지막 항목 뒤의 쉼표를 넣을 수 없습니다. 더 쉬운 방법은 아래 병합 입력란에 현재 파일을 붙여 넣는 것입니다.

파일에 이 항목들을 새 항목으로 추가하세요. Cowork Island와 다른 도구도 같은 파일에 내용을 쓸 수 있으므로 파일을 덮어쓰지 마세요. 아래 병합 입력란을 사용하면 기존 내용을 유지하며 추가할 수 있습니다. 그런 다음 Codex를 열고 /hooks를 입력해 새 항목 각각을 신뢰하도록 설정하세요. 이 설정을 하기 전까지 Codex는 새로 추가되거나 변경된 훅을 건너뜁니다.

파일의 "hooks" 객체에 기존 항목을 유지하면서 이 항목들을 추가하거나, 아래 병합 입력란을 사용하세요. Gemini CLI 훅은 JSON만 출력할 수 있으므로 각 명령은 마지막에 {}를 출력합니다.

파일의 기존 내용을 유지하면서 이 설정을 추가하거나, 아래 병합 입력란을 사용하세요.

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "/usr/bin/osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title (item 2 of argv) subtitle (item 3 of argv) sound name \"Glass\"' -e 'end run' 'Claude Code finished' 'Claude Code' \"${PWD##*/}\""
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "permission_prompt|elicitation_dialog|elicitation_url_dialog",
        "hooks": [
          {
            "type": "command",
            "command": "/usr/bin/osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title (item 2 of argv) subtitle (item 3 of argv) sound name \"Funk\"' -e 'end run' 'Claude Code needs you' 'Claude Code' \"${PWD##*/}\""
          }
        ]
      }
    ]
  }
}

• Claude Code의 권한 요청 알림과 연결된 도구의 입력 요청 알림은 요청이 표시된 뒤 약 6초 후에 도착하며, 타이핑하면 더 늦게 도착합니다. 이는 Claude Code의 Notification 훅이 작동하는 방식입니다. 다른 질문에는 이 훅이 실행되지 않을 수 있습니다.
• 완료 알림은 Stop을 사용합니다. Stop은 긴 작업이 끝날 때뿐 아니라 Claude가 답변을 마칠 때마다 실행됩니다. 사용자가 Claude를 중단시키면 실행되지 않습니다.
• Claude Code는 작업 공간 신뢰 대화상자에서 사용자가 동의할 때까지 해당 폴더의 훅을 실행하지 않습니다. 업무용 Mac에서는 조직이 자체 훅만 허용할 수도 있습니다.
• 이미 열려 있는 세션에 변경 사항이 적용되지 않으면 해당 세션을 다시 시작하세요.

무작위 이름으로 만든 ntfy 토픽입니다.

ntfy.sh의 토픽은 공개되어 있습니다. 토픽 이름을 알거나 추측한 사람은 누구나 그 토픽으로 전송된 내용을 읽을 수 있으므로 비밀번호처럼 다루세요. 이 때문에 토픽 이름은 브라우저가 만든 무작위 문자 32개로 구성됩니다. 훅도 ‘Claude Code 작업 완료’ 같은 고정 문구만 보내며, 에이전트의 답변이나 파일 내용은 보내지 않습니다.

휴대폰에 ntfy 앱을 설치하고 이 토픽을 구독하세요. ntfy.sh는 자체 일일 메시지 한도가 있는 무료 타사 서비스입니다.

테스트해 보세요.

이 줄을 Terminal에 붙여 넣고 Return을 누르세요. 훅이 실행할 명령과 같은 명령이 실행됩니다.

/usr/bin/osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title (item 2 of argv) subtitle (item 3 of argv) sound name "Glass"' -e 'end run' 'Claude Code finished' 'Claude Code' "${PWD##*/}"

벨을 테스트해 보세요.

이 줄을 Terminal에 붙여 넣고 Return을 누르세요:

printf '\a'