Skip to content

Releases

v1.4.0 - 공지사항 · 업데이트 알림 (Windows 판과 버전 맞춤)

Choose a tag to compare

@hull-kr hull-kr released this 18 Nov 04:03

Claude Code Kit for Mac v1.4.0 - 공지사항 · 업데이트 알림

설치 / 업데이트

curl -fsSL https://github.com/hull-kr/Claude-Code-Kit-Mac/releases/latest/download/install.sh | bash

이미 설치했다면 CCKit 을 켜면 업데이트 팝업이 뜹니다 → 지금 업데이트 를 누르세요. (설정 → 업데이트 → 지금 업데이트 로도 됩니다.)

버전 번호를 Windows 판과 맞췄습니다 - 0.3.1 다음이 1.4.0 입니다. 기능은 Windows 판 v1.4.0 과 같습니다.


📢 공지사항 - CCKit 새 소식을 패널에서 바로

CCKit 새 소식과 업데이트 안내는 hull.kr CCKit 소식 게시판에 올라오고, CCKit 이 알아서 받아 보여 줍니다.

1) 공지사항 화면 - 왼쪽 메뉴 공지사항. 구분(공지 · 소식)과 상태(새 글 · 읽음)를 알약으로 보여 주고, 제목을 누르면 브라우저로 그 글이 열립니다. 안 본 글이 있으면 메뉴에 공지사항 (2) 처럼 개수가 붙습니다.

공지사항 화면

2) 새 소식 팝업 - 새 글이 있으면 패널을 띄울 때 알려 줍니다.

새 소식 팝업

단추 하는 일
공지 보기 공지 화면과 브라우저로 글을 열고, 그 글은 다시 띄우지 않습니다
오늘 보지 않기 지금 나온 글은 다음 날에도 다시 띄우지 않습니다(그 뒤 새 글만 다시 알림)
닫기 다음에 패널을 띄우면 다시 알려 줍니다

3) 공지 띠 - 게시판에서 「공지」로 고정한 글의 제목과 내용 일부가 패널 맨 아래에 나옵니다. 여러 개면 4초마다 위로 넘어가고, 마우스를 올리면 멈추고, 누르면 그 글이 열립니다.

공지 띠

  • ⏸ 멈춤 - 롤링을 멈춥니다. 멈춘 뒤 정한 일수(기본 3일)가 지나면 저절로 다시 돌아갑니다.
  • ⚙ 톱니바퀴 - 설정의 「공지사항」 칸으로 바로 갑니다. 일수는 원하는 대로 바꿀 수 있습니다.

설정 - 공지사항

인터넷이 안 되거나 게시판을 못 읽어도 CCKit 실행에는 영향이 없습니다(공지 화면에는 마지막으로 받아 둔 목록). 게시판의 비밀글은 어디에도 나오지 않습니다.


🔔 업데이트 알림 - 큰 업데이트는 켤 때 팝업, 누르면 바로 설치

기능이 크게 바뀐 업데이트(1.3 → 1.4 처럼 앞자리 · 가운데 자리가 오르는 버전)는 CCKit 을 켤 때마다 팝업으로 알려 드립니다.

업데이트 팝업

단추 하는 일
지금 업데이트 바로 내려받아 설치합니다
나중에 지금 버전으로 그대로 씁니다(다음에 켤 때 다시 알림)
24시간 보지 않기 하루 동안 알리지 않습니다(그 사이 더 새 버전이 나오면 바로 다시 알림)

지금 업데이트 → 내려받기 진행률(받은 용량 · 속도) → 설치 진행률이 이어서 보입니다.

내려받기 진행률
설치 진행률

  • 설치 방식을 바꿨습니다 - 예전엔 앱을 먼저 끄고 새 앱을 풀어서 그동안 CCKit 이 꺼져 있었습니다. 이제는 켜진 채로 새 앱을 옆에 풀어 두고, 마지막에 옛 앱 끄기 → 바꿔 넣기 → 새 앱 띄우기 순서로 잠깐만 꺼집니다.
  • 작은 수정(1.4.0 → 1.4.1)은 지금처럼 알림만 띄우고, 업데이트는 선택입니다.
  • 업데이트가 끝나면 패널이 바로 열리고 「v1.4.0 으로 업데이트했습니다.」 알림이 뜹니다 (메뉴바 앱이라 아이콘만 다시 생기면 꺼진 것처럼 보이던 문제 - 2026-11-18 파일 교체로 반영).

업데이트 뒤 패널


그 밖에

  • 왼쪽 메뉴 순서: 로그인 확인 → 세션별 API 설정 → 공지사항 → 설정 → 사용 설명서
  • 사용 설명서(4개 언어)에 9절 「공지사항 · 업데이트 알림」 추가

확인한 것 (Mac 실기)

  • 업데이트 실측: 설치본을 버전만 낮춘 1.3.9 로 띄움 → 업데이트 팝업 → 지금 업데이트 → 내려받기 · 설치 진행률 → 교체 기록상 옛 앱이 꺼진 뒤 0.14초 만에 새 앱이 뜸 → 3 · 5 · 10초 뒤에도 1.4.0 이 떠 있음, 서명 검증 통과.
  • 공지: 실제 게시판 + 가짜 게시판(공지 3 · 잘린 제목 · 비밀글 · 비밀 공지)으로 팝업 단추 3개 · 띠 롤링/멈춤/자동 해제 · 톱니바퀴 · 연결 실패 · 읽기 실패를 자동 클릭으로 확인. 단위 테스트 47개.

v0.3.1 - 세션별 API 설정(앤트로픽 키·모델 잠금) · 세션 검색

Choose a tag to compare

@hull-kr hull-kr released this 14 Nov 01:06

Claude Code Kit for Mac v0.3.1 - 세션별 API 설정 · 세션 검색

설치 / 업데이트

curl -fsSL https://github.com/hull-kr/Claude-Code-Kit-Mac/releases/latest/download/install.sh | bash

이미 설치했다면 설정 → 업데이트 → 지금 업데이트 로도 받을 수 있습니다 (v0.3.0 부터 받은 용량·속도가 실시간으로 보입니다).


🌐 '타사 API 설정' → '세션별 API 설정'

세션(폴더)마다 다른 API 키와 모델을 붙입니다. 등록 칸이 두 가지가 됐습니다.

종류 키 발급 쓰는 모델
오픈라우터 API 키 프로필 openrouter.ai (sk-or-v1-...) 다른 회사 모델 - 예: openai/gpt-5.6-luna
앤트로픽 API 키 프로필 (새로 추가) platform.claude.com (sk-ant-...) Claude 모델 - claude-opus-5-5 · claude-sonnet-5-5 · claude-haiku-5-5 · claude-fable-5-2

★ 지금처럼 폴더(프로젝트)별로만 적용합니다. 그 세션 폴더의 .claude/settings.local.json 에만 쓰고, 전역 ~/.claude/settings.json · OS 환경변수는 건드리지 않습니다.

  • 프로필 목록은 하나로 - # · 종류 · 이름 · 모델 · 엔드포인트. 수정 을 누르면 그 종류의 등록 칸으로 불러옵니다. 행을 고르면 그 프로필을 쓰는 세션이 아래에 나옵니다.
  • 앤트로픽 키는 apiKeyHelper 로 넣습니다 - ANTHROPIC_API_KEY 로 넣으면 세션 처음에 "use this API key?" 를 묻고, 한 번 No 를 고르면 그 뒤로 말없이 구독으로 돕니다. apiKeyHelper 는 묻지 않고 바로 키로 엽니다. 이 값은 셸 명령으로 실행되므로 키에는 영문·숫자·-·_·. 만 받습니다.
  • 모델 잠금 - 등록한 모델로만 열리고 그 폴더에서는 /model · --model 로 바꿀 수 없습니다 (model · availableModels · enforceAvailableModels). 해제하면 같이 풀립니다.
  • 전환이 깨끗하게 - 적용할 때마다 전에 넣은 값(env ANTHROPIC_* 7개 · 잠금 · CCKit 이 넣은 apiKeyHelper)을 먼저 지우고 새로 씁니다. 다른 설정은 그대로 둡니다.
  • 프로필을 고치면 그 프로필을 쓰던 폴더도 새 키·모델로 다시 적용합니다.
  • '사용 안 함' 표기 - PC 기본 인증에 따라 사용 안 함 (클로드 구독제 사용) 또는 (클로드 API 사용) 으로 보여 줍니다 (셸 환경변수·~/.claude/settings.json 에 API 키가 있으면 '클로드 API').
  • 로그인 확인 화면 제목이 앤트로픽 API 키 설정 이 되고 옆에 platform.claude.com 링크가 붙었습니다.

실제로 들어가는 값 - 앤트로픽 (<세션 폴더>/.claude/settings.local.json)

{
  "env": { "ANTHROPIC_API_KEY": "", "ANTHROPIC_MODEL": "claude-sonnet-5-5" },
  "apiKeyHelper": "echo sk-ant-...",
  "model": "claude-sonnet-5-5",
  "availableModels": ["claude-sonnet-5-5"],
  "enforceAvailableModels": true
}

오픈라우터는 v0.3.0 과 같은 env 6개에 위 잠금 3개가 더해집니다.

세션별 API 설정
세션 우클릭 - 세션별 API 설정 하위 메뉴

알아둘 점

  • 키로 연결한 세션 아래의 ⚠ claude.ai connectors are disabled … 경고는 정상입니다. Artifact · Docs · 리모트 컨트롤 · 커넥터 같은 claude.ai 계정 기능만 못 쓰고, 대화·파일 작업은 그대로 됩니다. 그래서 새 세션 창에서 프로필을 고르면 원격 연결 체크를 꺼 줍니다.
  • 앤트로픽 키 자체에는 모델 허용 목록이 없습니다. CCKit 의 잠금은 그 폴더에서만 걸립니다. 수업 등에 나눠 줄 키라면 Claude Console 에서 수업용 워크스페이스를 따로 만들어 지출 한도를 걸고 거기서 키를 만드세요 (기본 워크스페이스에는 지출 한도를 걸 수 없습니다).
  • OpenAI · 구글 키는 쓸 수 없습니다 - Claude Code 가 부르는 주소(/v1/messages)가 없습니다. GPT · Gemini 모델도 OpenRouter 키로 쓰세요.
  • v0.3.0 에서 만든 프로필은 그대로 '오픈라우터' 로 읽힙니다. 이미 적용된 폴더는 다시 적용하면 모델 잠금이 더해집니다.

🔍 새 기능 - 세션 검색

그룹 탭 줄 바로 아래에 검색칸이 생겼습니다. 제목 · 폴더 · 그룹 · 세션ID 중 하나라도 들어 있으면 보입니다 (대소문자 무시, 0.25초 멈추면 거름).
지금 탭과 선택한 그룹 안에서만 거르고, 왼쪽 메뉴로 탭을 옮겨도 검색어는 남습니다. Esc 또는 초기화 로 비웁니다.

세션 검색


확인한 것 (Mac 실기)

  • 실제 앤트로픽 키: 첫 화면 Sonnet 5.5 · API Usage Billing, 승인 질문 없음 → "Anthropic의 Claude Sonnet 5.5 모델이며, 모델 ID는 claude-sonnet-5-5입니다." → /model claude-opus-5-5 는 "is not available. Your organization restricts model selection." 으로 거부 → 해제·재시작하면 구독으로 이어짐.
  • 실제 OpenRouter 키: openai/gpt-5.6-luna 세션 대화 · 모델 잠금 · 앤트로픽으로 전환 · 해제, 프로필 수정 시 쓰던 폴더 다시 적용.
  • 세션 검색 (탭 이동 후 유지 · Esc · 초기화), 단위 테스트 40개.

v0.3.0 - 타사 API 설정(베타)

Choose a tag to compare

@hull-kr hull-kr released this 11 Nov 06:36

Claude Code Kit for Mac v0.3.0 - 타사 API 설정(베타)

설치 / 업데이트

curl -fsSL https://github.com/hull-kr/Claude-Code-Kit-Mac/releases/latest/download/install.sh | bash

이미 설치했다면 설정 → 업데이트 → 지금 업데이트 로도 받을 수 있습니다.


🌐 새 기능 - 타사 API 설정 (베타)

Claude 구독 대신 OpenRouter 키로 다른 회사 모델(예: openai/gpt-5.6-luna)을 Claude Code 에서 씁니다.

★ 폴더(프로젝트)별로만 적용합니다. 그 세션 폴더의 .claude/settings.local.json 에만 쓰고,
전역 ~/.claude/settings.json · OS 환경변수(~/.zshrc 등)는 절대 건드리지 않습니다. 다른 프로젝트는 그대로 클로드 모델로 돕니다.

쓰는 순서

  1. openrouter.ai 에서 키를 만듭니다 (sk-or-v1-..., 크레딧 충전 필요).
  2. 왼쪽 메뉴 맨 아래 타사 API 설정 → 맨 위 입력 줄에 이름 · 모델 · API 키 → 추가.
    • 모델 칸은 OpenRouter 공개 모델 목록(약 470개)에서 일부만 쳐도 찾습니다 (luna, gemini, claude … 대소문자 무관, 중간 글자도 됨). ↑↓ 로 고르고 Enter 확정, Esc 닫기.
    • 프로필은 번호(#) 로 관리합니다. 수정 → 입력 줄로 불러와 고친 뒤 저장 (이름을 바꿔도 같은 프로필이 고쳐집니다).
  3. 세션 목록에서 세션 우클릭 → 타사 API 설정 [지금 적용된 것] → 프로필 선택 (적용된 것에 ✓).
    • 새로 만들 세션이면 + 새 세션 창의 타사 API 프로필 칸에서 고르면 됩니다.
  4. 그 폴더에 열려 있는 세션이 있으면 "지금 재시작할까요? (대화는 이어집니다)" 를 묻습니다. 예 = 닫고 다시 열어 바로 그 모델로 이어집니다.
  5. 해제 = 우클릭 → 타사 API 설정 → 사용 안 함 (클로드 모델). 타사 API 탭에서 프로필을 누르면 그 프로필이 적용된 세션이 나오고 선택 세션에서 해제 로도 풉니다.

타사 API 설정 탭
세션 우클릭 - 타사 API 설정 하위 메뉴
새 세션 만들기 - 타사 API 프로필

실제로 들어가는 값 - <세션 폴더>/.claude/settings.local.json

OpenRouter 공식 Claude Code 연동 방식 그대로입니다.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-...",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "openai/gpt-5.6-luna",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "openai/gpt-5.6-luna",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "openai/gpt-5.6-luna"
  }
}
  • 주소는 짧은 https://openrouter.ai/api 만 넣습니다 - Claude Code 가 /v1/messages 를 스스로 붙입니다 (전체 주소를 넣으면 404).
  • 키는 ANTHROPIC_AUTH_TOKEN 에, ANTHROPIC_API_KEY 는 빈 값으로 명시해 다른 곳에 남은 키가 먼저 쓰이는 것을 막습니다.
  • 이 파일의 다른 설정은 그대로 두고 위 6개만 넣고 뺍니다. 해제하면 6개만 지우고, 파일이 깨져 있으면 덮어쓰지 않습니다.

이어 열기 모델 자동 보정

Claude Code 는 이어 열면(--resume) 대화 기록의 마지막 응답 모델을 그대로 씁니다. 그래서 해제한 뒤 그냥 이어 열면 타사 모델이 남아 "There's an issue with the selected model" 오류가 납니다. CCKit 은 이어 열 때 맞춰 엽니다.

  • 폴더에 타사 설정이 있고 기록 모델과 다르면 → --model <프로필 모델>
  • 폴더에 타사 설정이 없는데 기록 모델이 타사 ID(/ 포함)면 → --model default

키 보안

  • 키는 그 폴더의 settings.local.json 에 평문으로 들어갑니다. git 저장소 폴더면 .gitignore 에 .claude/settings.local.json 을 자동으로 추가해 키가 커밋되지 않게 합니다 (이미 있으면 그대로).
  • 프로필(키 포함)은 ~/Library/Application Support/CCKit/thirdparty.json 에 저장됩니다.

알아둘 한계

  • 키로 연결한 세션은 claude.ai 계정 기능(Artifact · Docs · 리모트 컨트롤 · 커넥터)을 쓸 수 없습니다 (/remote-control = Unknown command). Anthropic API 키로 연결해도 같습니다. 로컬 스킬·파일 작업은 그대로 됩니다. 그래서 새 세션 창에서 프로필을 고르면 원격 연결 체크를 꺼 줍니다.
  • OpenAI 키(sk-proj-...)는 쓸 수 없습니다. Claude Code 는 /v1/messages 주소를 부르는데 api.openai.com 에는 없어 404, OpenRouter 주소에 OpenAI 키를 넣으면 401 입니다. OpenRouter 키를 쓰세요 (OpenAI 모델도 OpenRouter 로 씁니다).
  • 설정은 폴더 단위라 그 폴더에서 연 세션이 전부 같은 모델을 씁니다. 사용 요금은 OpenRouter 크레딧에서 나갑니다.

🔔 개선 - 업데이트 다운로드 진행률

지금 업데이트 를 누르면 진행 막대가 고정 45% 대신 실제로 차오르며 45% (55.4MB / 121.1MB, 7.2MB/s) 처럼 받은 용량·전체 용량·속도를 보여 줍니다 (다음 업데이트부터 보입니다).

고친 것

  • 우클릭 메뉴(그룹 지정 · 타사 API 설정)에서 체크된 줄이 회색으로 흐리게 보이던 것.

확인한 것 (Mac 실기)

  • OpenRouter 키로 openai/gpt-5.6-luna 세션 생성 → 대화 ("OpenAI의 GPT-5.6 Luna 모델이야.")
  • 해제 → 재시작 → --model default 로 구독 모델(Opus)로 오류 없이 이어짐 → 다시 적용 → 재시작 → 루나로 이어짐
  • 프로필 추가·이름 바꿔 수정(번호 유지)·삭제, 모델 부분 일치 검색, 손으로 넣은 값 표시, .gitignore 자동 추가, 단위 테스트 35개

v0.2.0 - 로그인 확인

Choose a tag to compare

@hull-kr hull-kr released this 04 Nov 14:01

Claude Code Kit for Mac v0.2.0 - 로그인 확인

설치 / 업데이트

curl -fsSL https://github.com/hull-kr/Claude-Code-Kit-Mac/releases/latest/download/install.sh | bash

이미 설치했다면 설정 → 업데이트 → 지금 업데이트 로도 받을 수 있습니다.

왜 구독 로그인을 해도 계속 막히나

예전에 ANTHROPIC_API_KEY 를 넣어 둔 채 구독(Claude.ai) 로그인을 하면, Claude Code 는 구독 대신 그 키를 우선 씁니다.
그 키가 만료·무효면 /login 을 몇 번 해도 계속 막힙니다. 이번 버전은 키가 어디에 남아 있는지 보여 주고, 바로 비우거나 다시 로그인할 수 있게 했습니다.

새로 생긴 것 - 왼쪽 메뉴 맨 아래 로그인 확인

  • API 키 설정 - 키가 설정될 수 있는 세 곳을 한 줄씩 따로 보여 줍니다 (우선순위 순). 설정 안 됨 = 초록, 설정됨 = 주황.
    • OS 환경변수 - 셸 설정 파일(~/.zshrc·~/.zprofile·~/.bash_profile 등)과 launchctl 에서 찾고, 어느 파일 몇째 줄인지 보여 줍니다.
      비우기 = 파일을 먼저 백업한 뒤 그 줄을 주석으로 바꿉니다 (지우지 않음). 새 터미널부터 반영됩니다.
    • settings.json env - ~/.claude/settings.json 의 env.ANTHROPIC_API_KEY 저장·비우기. 새로 여는 세션부터 반영됩니다.
    • settings.json apiKeyHelper - "echo 키" 형태로 저장·비우기. 바로 반영됩니다.
    • settings.json 은 그 키 하나만 바꾸고 다른 설정은 그대로 둡니다. 비우기는 확인 창을 한 번 거칩니다.
    • 저장하면 진행 막대 안내로 어디에 저장했는지와 언제 반영되는지 알려 줍니다.
    • settings.json 직접 열기 - 다른 방식으로 키가 들어 있을 때 텍스트 편집기로 바로 엽니다.
  • 구독(Claude.ai) 로그인 상태 - 로그인됨 / 로그인 만료됨 / 로그인 안 됨과 계정·조직·플랜.
    Mac 의 Claude Code 는 로그인 정보를 키체인에 두므로 claude auth status 로 확인합니다 (CCKit 은 키체인 비밀값을 읽지 않습니다).
  • 구독 로그인 진행 (새 터미널에서 /login) - 새 Terminal 창에서 claude 를 띄우고 /login 을 자동 입력합니다.
    로그인 방법(1번 = 구독 계정)·브라우저 인증·팀 선택은 그 창에서 직접 하세요. 로그인이 끝나면 그 임시 창은 저절로 닫히고 세션 목록에도 남지 않습니다.

로그인 확인 - 셸 설정 파일에 남은 예전 키
로그인 확인 - 저장 후 안내

v0.1.3 - 세션 보관 기간 · 기간만료 표시

Choose a tag to compare

@hull-kr hull-kr released this 27 Oct 23:59

Claude Code Kit for Mac v0.1.3 - 세션 보관 기간 · 기간만료 표시

설치 / 업데이트

curl -fsSL https://github.com/hull-kr/Claude-Code-Kit-Mac/releases/latest/download/install.sh | bash

이미 설치했다면 설정 → 업데이트 → 지금 업데이트 로도 받을 수 있습니다.

왜 관리 세션이 갑자기 "대화가 없다"고 나왔나

Claude Code 는 보관 기간(기본 30일)이 지난 세션의 대화 파일을 스스로 지웁니다. CCKit 이 지운 것이 아닙니다.
이번 버전은 이런 세션을 구분해서 보여주고, 보관 기간을 패널에서 바로 바꿀 수 있게 했습니다.

새로 생긴 것

  • 기간만료 / 대화없음 표시 - 대화 파일이 사라진 관리 세션의 상태 칸이 빨간 글씨로 나옵니다.
    • 기간만료: 보관 기간이 지나 Claude Code 가 지운 것. 누르면 설정의 보관 기간 칸으로 갑니다.
    • 대화없음: 보관 기간과 상관없이 CCKit 밖에서 사라진 것.
    • 닫힌 세션 · 모든 세션 · 관리 세션 탭 모두에 나옵니다.
  • 설정 → 세션 보관 기간 (Claude Code) - 일수를 바꾸면 바로 ~/.claude/settings.json 의 cleanupPeriodDays 에 저장합니다. 다른 설정은 그대로 둡니다.
  • 왼쪽 메뉴 아래 세션 보관 N일 박스 - 지금 보관 기간을 보여주고, 누르면 설정으로 갑니다.
  • 보관 기간을 늘려도 이미 지워진 대화는 되살아나지 않으므로 그 세션은 계속 기간만료 로 표시합니다.

바뀐 것

  • 닫힌 세션 상태 칸에 닫은 시각(닫힘 10-27 12:53)이 나오고, 최근에 닫은 순으로 정렬합니다.
  • 화면 문구의 긴 줄표(—)를 하이픈(-)으로 바꿨습니다.
  • 지우기는 uninstall.sh 한 줄로 됩니다 (Claude Code 의 대화 기록 ~/.claude 는 남깁니다).
curl -fsSL https://github.com/hull-kr/Claude-Code-Kit-Mac/releases/latest/download/uninstall.sh | bash

닫힌 세션 - 기간만료와 대화없음
설정 - 세션 보관 기간

Claude Code Kit for Mac v0.1.2

Choose a tag to compare

@hull-kr hull-kr released this 25 Sep 09:30

Claude Code Kit for Mac v0.1.2 — Windows 판과 동작 맞춤 · 이미지 붙여넣기

설치 / 업데이트

curl -fsSL https://github.com/hull-kr/Claude-Code-Kit-Mac/releases/latest/download/install.sh | bash

이미 설치했다면 설정 → 업데이트 → 지금 업데이트 로도 받을 수 있습니다.

이미지 붙여넣기 (⌃⇧V)

  • Claude Code 세션 탭에서 ⌃⇧V → 이미지를 세션 폴더 .tmp/clipboard/ 에 저장하고 경로를 입력칸에 바로 넣습니다. 손쉬운 사용 권한이 없어도 됩니다.
  • 경로 뒤에 줄바꿈이 들어갑니다. 메시지는 보내지 않으니 이어서 질문을 쓰면 됩니다.
  • ⌘⇧4 로 캡처해 파일로 저장된 스크린샷도 바로 붙입니다.
  • ⌃⇧V 는 터미널이 맨 앞일 때만 잡습니다. 다른 앱에서는 그 앱의 원래 기능대로 동작합니다.
  • 키를 길게 눌러 여러 번 붙던 문제를 고쳤습니다.

Windows 판과 같게 바꾼 것

  • 목록 버튼: 열린 세션 = 닫기(녹색) / bg 전환, 백그라운드 = 화면닫기·화면표시 / 닫기(빨강), 닫힌 세션 = 열기 / 삭제.
  • 세션 닫기·삭제는 예/아니요로 확인합니다. 폴더가 없어진 세션은 경고 창 하나로 삭제 여부를 묻습니다.
  • 새 세션 창: 폴더 → 그룹(+ 새 그룹) → 세션명 → 원격 연결(기본 켬) → 관리(기본 끔). 없는 폴더는 경고합니다.
  • 입력칸에 쓰다 만 글자가 있으면 "지우고 실행할까요?" 를 묻습니다.
  • 리모트가 잠기면 세션을 다시 열어 한 번 더 시도합니다.
  • 상세 창·에이전트 창·우클릭 메뉴·메뉴바 메뉴·설정 초기화를 Windows 판과 같은 구성으로 맞췄습니다.
  • 앱을 켜면 패널은 띄우지 않고 메뉴바에만 올라갑니다. 직전에 열려 있던 세션은 자동으로 복원합니다(설정에서 끌 수 있음).

기타

  • 앱 서명을 고정해 업데이트해도 macOS 권한(자동화 등)이 초기화되지 않습니다.
  • 설치 스크립트가 실행 중인 옛 앱을 확실히 끄고 새 앱으로 바꿉니다.

Claude Code Kit for Mac v0.1.1

Choose a tag to compare

@hull-kr hull-kr released this 24 Sep 08:00

Claude Code Kit for Mac v0.1.1 — 버그 수정

설치 / 업데이트

curl -fsSL https://github.com/hull-kr/Claude-Code-Kit-Mac/releases/latest/download/install.sh | bash

이미 설치했다면 설정 → 업데이트 → 지금 업데이트 로도 받을 수 있습니다.

고친 것

  • 새 세션에서 "원격 연결" 을 체크해도 리모트가 켜지지 않던 문제 — claude 가 늦게 뜨면 이름·그룹·관리·리모트를 건너뛰었습니다. 이제 충분히 기다리고, 적용하지 못한 것이 있으면 알려 줍니다.
  • 리모트 켜기/끄기를 세션의 실제 상태로 확인합니다 (터미널에 남은 예전 글자로 잘못 판단하던 문제).
  • 세션 닫기·열기가 실패했는데 성공으로 표시되던 문제.
  • 사용 설명서가 열리지 않던 문제 — 이제 패널 안 '사용 설명서' 화면으로 보여 줍니다.
  • 왼쪽 메뉴 아이콘 크기가 제각각이던 문제.

Claude Code Kit for Mac v0.1.0

Choose a tag to compare

@hull-kr hull-kr released this 24 Sep 06:45

Claude Code Kit for Mac v0.1.0 — 첫 릴리즈

macOS 메뉴바에서 Claude Code 세션을 관리하는 도구입니다. (Windows 판 Claude Code Kit 의 macOS 판)

설치 (터미널에 한 줄)

curl -fsSL https://github.com/hull-kr/Claude-Code-Kit-Mac/releases/latest/download/install.sh | bash

Apple Silicon · Intel 을 자동으로 골라 설치합니다. 처음 세션을 열 때 "Terminal 을 제어하려고 합니다" 창이 뜨면 [허용] 을 눌러 주세요.

파일

파일 용도
install.sh 한 줄 설치 스크립트 (권장)
CCKit-mac-arm64.zip / CCKit-mac-x64.zip 설치 스크립트가 받는 앱 (Apple Silicon / Intel)
CCKit-mac-arm64.dmg / CCKit-mac-x64.dmg 수동 설치용 — 브라우저로 받으면 macOS 가 막으므로 설치 후 시스템 설정 → 개인정보 보호 및 보안 → "그래도 열기" 필요

기능

세션 목록(관리·열린·닫힌·모든·그룹) · 열기/닫기/재시작/이름 바꾸기 · 리모트 컨트롤 켜기/끄기·유휴 유지 · 백그라운드 전환·화면표시 ·
새 세션 · 이미지 붙여넣기(⌃⇧V) · 재부팅 후 자동 복원 · 선행 프로그램(Node·Python·Git·Claude Code) 확인·설치 · 업데이트 · 4개 언어