이제 Claude Kit은 AgentKit입니다: ck → ak 안전하게 마이그레이션하는 방법 (2026)

저는 Claude Kit(ck)을 몇 달 동안 매일 사용했고, 이름이 바뀐 그 주에 제 환경을 ak로 마이그레이션했어요. 이건 문서가 알려줬으면 했던 안내서예요 — 공식 문서가 대충 넘어가는 백업과 롤백 단계까지 포함해서요.

어떤 AgentKit인가요? (OpenAI AgentKit이 아니에요)

무엇이든 입력하기 전에, 이름이 겹치니 한 가지만 분명히 해둘게요. 이 가이드에서 말하는 'AgentKit'은 Claude Kit의 리브랜드예요 — Claude Code를 위한 스킬·에이전트 툴킷으로, 주소는 agentkit.best, CLI는 ak예요. 이건 OpenAI AgentKit이 아니에요. OpenAI가 2025-10-06에 출시한 Agent Builder / ChatKit / Connector Registry 제품과는 달라요. 서로 무관한 두 제품이 같은 단어를 쓰는 것뿐이에요. OpenAI 에이전트 워크플로를 마이그레이션하러 오셨다면, 이 페이지는 잘못 찾으신 거예요. ck 설치 환경이 있고 ak로 옮기고 싶다면, 계속 읽어보세요.

Claude Kit이 AgentKit으로 개명 — 실제로 무엇이 바뀌었나요?

단도직입적으로 말하면, 제품 Claude Kit이 AgentKit이 되었고, CLI ck가 ak가 되었어요. 개명에 업그레이드가 더해진 것이지, 다시 사야 하는 새 제품이 아니에요. 이미 결제한 키트는 마이그레이션 후에도 그대로 작동해요.

가장 큰 내부 변화는 배포 방식이에요. 예전 ck는 npm 패키지(claudekit-cli)로 제공됐지만, 이제 지원 중단됐어요. ak는 macOS, Linux, Windows용 네이티브 바이너리로 제공되며 Node나 Bun이 필요 없어요. 설정 홈은 ~/.claude/(.ck.json / .ckignore)에서 ~/.agentkit로 옮겨졌고, 스킬 네임스페이스는 ck:에서 ak:로 바뀌었어요(그래서 /ck:cook은 이제 /ak:cook이에요). 범위도 넓어졌어요. ck는 Claude Code를 대상으로 했지만, ak는 이제 Claude Code 와 Codex를 아우르고, Cursor / Grok / Gemini CLI가 곧 지원 예정으로 올라 있어요.

이 모든 게 처음이고 마이그레이션 전에 이 툴킷이 무엇을 하는지 전체 그림을 보고 싶다면, 제 전체 AgentKit 리뷰에서 자세히 정리해 두었어요.

업그레이드 전에: 백업하기 (2분)

이건 공식 문서가 건너뛰는 단계이자, 당신을 구해주는 단계예요. 마이그레이션 도구는 자신이 기록하는 파일의 스냅샷을 찍어 되돌릴 수 있게 해주지만, 덮어쓰는 파일은 복구할 수 없어요. Claude 설정을 2분 동안 수동으로 백업해 두면 전체 과정을 위험 없이 만들 수 있어요.

기존 설정, 스킬, 에이전트, 훅을 안전한 곳에 복사하고, 나중에 비교할 수 있도록 현재 버전을 기록해 두세요.

# macOS / Linux
cp -r ~/.claude ~/.claude.backup-$(date +%Y%m%d)
ck versions > ~/ck-versions-before-migration.txt

# Windows (PowerShell)
Copy-Item "$HOME\.claude" "$HOME\.claude.backup" -Recurse
ck versions | Out-File "$HOME\ck-versions-before-migration.txt"

왜 중요한가: 마이그레이션된 파일이 당신이 커스터마이즈한 파일을 대체해 버리면, ak migrate rollback은 원본을 되돌려주지 않아요. ~/.claude/의 수동 복사본이 유일하게 확실한 복원 지점이에요. 건너뛰지 마세요.

ck → ak를 안전하게 마이그레이션하는 방법 (단계별)

여기가 과정의 핵심이에요. 여섯 단계, 모두 복사-붙여넣기가 가능해요. 황금률은 먼저 미리보기, 그다음 적용이에요. 미리보기는 아무것도 기록하지 않아요.

1. ak(네이티브 바이너리) 설치하기. 설치 프로그램이 OS와 아키텍처를 감지하고, 안정 빌드를 내려받아 SHA-256을 검증한 뒤 ~/.local/bin에 설치해요.

# macOS / Linux
curl -fsSL https://agentkit.best/install.sh | sh

# Windows (PowerShell)
irm https://agentkit.best/install.ps1 | iex

2. 다시 인증하기. ak는 예전 GitHub PAT 방식을 이메일 OTP나 API 키로 대체해요. ak를 한 번 실행하고 로그인 안내를 따르세요 — 이건 ck에서 실제로 바뀐 부분이라, 예전 PAT를 묻지 않아도 놀라지 마세요.

3. 마이그레이션 미리보기(읽기 전용). 이게 안전한 기본값이에요 — 무엇이 바뀔지 정확히 보여주고 아무것도 기록하지 않아요.

ak migrate --from=ck

계획을 읽어보세요. 스킬과 에이전트를 찾아냈는지 확인하세요. 문제없어 보이면 적용하세요.

4. 마이그레이션 적용하기. 같은 명령어에, 실제로 변경을 기록하는 플래그를 붙여요.

ak migrate --from=ck --dry-run=false --yes --no-interactive

5. 검증하기. 무언가를 삭제하기 전에 모든 게 살아남았는지 확인하세요.

ak doctor
ak skills
ak agents

6. 예전 ck 정리하기. PATH에 남은 낡은 ck는 레거시 스크립트를 계속 실행해요 — 마이그레이션했다고 생각하지만 실제로는 안 된, 눈에 잘 안 띄는 함정이죠. 모든 사본을 찾아 npm 버전을 제거하세요.

which -a ck
npm uninstall -g claudekit-cli

# optional: alias ck -> ak if your muscle memory needs it
ln -sf ~/.local/bin/ak ~/.local/bin/ck

문서에서는 잘 드러나지 않는 한 가지 참고사항: ak migrate는 일회성 안전장치이지, 평소의 업데이트 방식이 아니에요. ak로 옮긴 뒤에는 다른 도구와 마찬가지로 ak update로 업데이트해요.

ck → ak 명령어 대응표

거의 모든 게 그대로 ck → ak 교체예요 — 동사는 같고 바이너리만 새로워요. 손이 다시 익을 때까지 곁에 두세요.

문제가 생기면: 롤백하는 방법

마이그레이션이 원치 않는 것을 기록했다면, 되돌리는 계층이 두 개 있어요.

1계층 — 마이그레이션 도구 자체의 롤백: ak migrate rollback은 마이그레이션이 새로 기록한 파일을 제거해요(기록하기 전에 스냅샷을 찍어요). 잘못된 적용을 빠르고 깔끔하게 되돌릴 수 있어요.

솔직한 주의사항, 그리고 위의 백업 단계가 타협 불가인 이유: 롤백은 덮어쓴 파일을 복원하지 않아요. 스냅샷은 새로 기록한 것만 다뤄요. 마이그레이션이 커스터마이즈한 스킬이나 설정 파일을 대체했다면, 직접 복사해 두지 않은 한 그 원본은 사라져요.

2계층 — 수동 백업: 롤백 후에도 여전히 막혔다면, 만들어 둔 사본에서 ~/.claude/를 복원하세요.

# macOS / Linux
rm -rf ~/.claude && mv ~/.claude.backup-YYYYMMDD ~/.claude

마이그레이션 도구의 스냅샷과 당신의 사본이 있으면, 설정을 영영 잃는 시나리오는 없어요 — 0단계를 해두었다면요.

호환성 파괴 변경과 함정

마이그레이션의 대부분은 매끄럽지만, 네 가지가 사람들을 놀라게 해요. 어느 것도 치명적이지 않고, 모두 적용을 누르기 전에 알아둘 가치가 있어요.

• 인증이 바뀌었어요. GitHub PAT는 빠지고, 이메일 OTP / API 키가 들어왔어요. 예전 토큰은 재사용되지 않아요 — 첫 ak 실행 때 새 로그인을 예상하세요.
• 생성된 훅은 기본적으로 마이그레이션되지 않아요. ck가 생성한 훅(세션, 서브에이전트, 사용 컨텍스트)은 자동으로 넘어오지 않고, 예전 등록은 정리돼요. 커스텀 생성 훅에 의존했다면, 마이그레이션 후 다시 추가하세요.
• PATH 함정. 낡은 ck가 PATH에 남아 있으면, ak를 설치한 뒤에도 레거시 ClaudeKit 스크립트를 계속 실행해요. which -a ck를 실행하고 npm 패키지(npm uninstall -g claudekit-cli)를 제거해, 낡은 도구를 모르게 돌리는 일이 없도록 하세요.
• 네임스페이스 이동. 모든 ck: 접두사가 ak:로 바뀌어요 — 슬래시 명령, 스킬 참조, 문서까지요. ck:를 하드코딩한 스크립트, 별칭, 메모를 업데이트하세요.

참고로, 레거시 설치 문서는 docs.claudekit.cc에 아직 살아 있고(2026-08-09 확인), 정식 마이그레이션 절차는 agentkit.best/docs에 있어요. 참고로 docs.claudekit.cc/.../cli/migrate는 ck를 다른 제공자(Cursor/Codex)로 마이그레이션하는 이야기지, ck→ak 개명에 관한 게 아니에요 — 잘못 들어서기 쉬워요.

이미 개명됐는데 — 플랜을 업그레이드해야 할까요?

좋은 소식부터: 개명 자체는 현재 키트 소유자에게 무료이고, 키트에는 평생 업데이트가 딸려 오니 마이그레이션 비용은 0이에요. 유일하게 진짜 고민할 부분은, 툴킷이 이제 엔지니어링과 마케팅을 아우르게 된 지금 소유 범위를 넓힐지예요.

Engineer Kit만 가지고 있었다면, 지금이 Bundle을 살펴볼 자연스러운 순간이에요. AgentKit은 Engineer Kit을 $99, Marketing Kit을 $99, Bundle(두 키트)을 $149로 표시하고 있고, 키트에 반복 결제 안내는 없어요. 또한 라이선스 활성화, 스킬 관리, 상태 표시줄 구성을 위한 관제 센터인 Desktop App이 연 $19, 또는 Desktop + 두 키트가 선착순 100명 한정 연 $99로 제공돼요.

가치가 있을지 확신이 안 서나요? AgentKit 가격이 그만한 값어치가 있는지에서 계산해 봤고, Engineer Kit 리뷰에서 실제로 무엇을 얻는지 깊이 파고들었어요.

자주 묻는 질문 (FAQ)

Claude Kit과 AgentKit은 같은 것인가요?

네. AgentKit은 Claude Kit을 개명하고 업그레이드한 버전이에요. 제품명이 바뀌었고 CLI가 ck에서 ak로 바뀌었어요. 개명에 네이티브 바이너리 업그레이드가 더해진 것이지, 다른 제품이 아니에요.

업그레이드하면 스킬과 설정을 잃게 되나요?

아니요, 먼저 백업하면요. ak migrate --from=ck가 스킬, 에이전트, 설정을 넘겨줘요. 덮어쓴 파일은 롤백할 수 없으니, 마이그레이션 전에 ~/.claude/를 복사해 확실한 복원 지점을 만들어 두세요.

AgentKit을 다시 사야 하나요?

아니요. 개명은 현재 키트 소유자에게 무료이고, 키트에는 평생 업데이트가 포함돼요. 다른 키트나 Bundle, Desktop App을 추가할 때만 비용을 내요.

예전 ck 명령어는 아직 작동하나요?

레거시 ck(npm claudekit-cli)는 지원 중단됐어요. PATH에 남아 있으면 예전 스크립트를 실행할 수 있어서, 마이그레이션 후에는 제거해야 해요. 앞으로는 ak를 쓰세요.

이건 OpenAI AgentKit과 같은 건가요?

아니요. OpenAI AgentKit(Agent Builder / ChatKit, 2025-10-06 출시)은 이름만 같은 무관한 제품이에요. 이 가이드는 오직 Claude Code를 위한 Claude Kit → AgentKit 개명에 관한 거예요.

마이그레이션하려면 온라인이거나 다시 로그인해야 하나요?

네. ak는 예전 GitHub PAT 대신 이메일 OTP나 API 키를 쓰기 때문에 첫 실행 때 인증하게 되고, 설치 프로그램은 네이티브 바이너리를 내려받아요 — 둘 다 연결이 필요해요.

결론 및 다음 단계

마이그레이션 전체는 세 가지 동작으로 요약돼요. ~/.claude/ 백업하기, ak migrate --from=ck를 미리보기로 실행한 뒤 적용하기, 그리고 예전 ck를 정리하기 전에 ak doctor로 검증하기. 이 순서대로 하면 ck에서 ak로의 업그레이드는 정말 위험이 적어요. 아직 Claude Code가 없나요? 제 초보자를 위한 Claude Code 가이드부터 시작하세요. 더 투자하기 전에 툴킷을 전체적으로 둘러보고 싶나요? AgentKit이 무엇인지를 읽어보세요.

가격과 명령어는 2026-08-09에 agentkit.best/docs와 docs.claudekit.cc를 기준으로 확인했어요. 빠르게 변하는 제품이니, 구매하거나 복사-붙여넣기 명령을 실행하기 전에 다시 확인하세요.