Skip to main content

Claude Code 호환성

ℹ️Info

Claude Code 사용자라면: Careti는 Claude Code의 모든 시스템과 100% 호환됩니다. 추가로 팀/기업 환경을 위한 Workflows 시스템을 제공합니다.

Careti 소개​

Careti는 Cline 기반의 AI 코딩 어시스턴트로, 다음을 추가로 지원합니다:

  • 266개+ 모델 지원: Claude, GPT, Gemini, DeepSeek, Qwen, GLM 등
  • Claude Code 완전 호환: Skills, Commands, Hooks 시스템
  • Workflows 시스템: 팀/기업용 명시적 프로세스 정의
  • 다국어 지원: 한국어, 일본어, 중국어 등 7개 언어

Claude Code vs Careti 구조 매핑​

구성 요소Claude Code 경로Careti 경로호환성
Commands.claude/commands/.agents/commands/✅ 완전 호환
Skills.claude/skills/.agents/skills/✅ 완전 호환
Hooks.claude/hooks/.agents/hooks/✅ 완전 호환
Settings.claude/settings.json.agents/settings.json✅ 완전 호환
Workflows❌ 없음.agents/workflows/Careti 확장

Skill 시스템 호환​

Claude Code의 모든 Skill frontmatter 필드를 지원합니다:

---
description: 코드 리뷰 스킬
disable-model-invocation: true  # AI 자동 호출 비활성화
user-invocable: true            # 슬래시 메뉴 표시
allowed-tools: Read, Grep, Glob # 허용 도구 제한
context: fork                   # 격리 실행
agent: reviewer                 # 에이전트 타입
---

현재 브랜치: !`git branch --show-current`

# 코드 리뷰 지시사항
변경된 파일을 검토하고 피드백을 제공하세요.

지원 필드​

필드Claude CodeCareti설명
description✅✅스킬 설명 (필수)
argument-hint✅✅인자 힌트
disable-model-invocation✅✅AI 자동 호출 비활성화
user-invocable✅✅슬래시 메뉴 표시
allowed-tools✅✅허용 도구 목록
context✅✅실행 컨텍스트 (fork | inline)
agent✅✅fork 시 에이전트 타입

전처리 구문 (!command``)​

스킬 로드 시 쉘 명령을 실행하고 결과를 치환합니다:

현재 브랜치: !`git branch --show-current`
오늘 날짜: !`date +%Y-%m-%d`
Git 상태:
!`git status --short`

Hooks 시스템 호환​

지원 이벤트​

Hook 이벤트Claude CodeCareti설명
PreToolUse✅✅도구 실행 전
PostToolUse✅✅도구 실행 후
UserPromptSubmit✅✅사용자 입력 시
PreCompact✅✅컴팩트 전
SessionStart✅✅세션 시작
SessionEnd✅✅세션 종료
Stop✅✅중단 시
TaskStart❌✅작업 시작 (Careti 확장)
TaskResume❌✅작업 재개 (Careti 확장)
TaskCancel❌✅작업 취소 (Careti 확장)

Matcher 패턴​

특정 도구에만 적용되는 훅을 만들 수 있습니다:

.agents/hooks/
├── PreToolUse           # 모든 도구에 적용
├── PreToolUse.Edit_Write # Edit, Write 도구만
├── PreToolUse.Bash      # Bash 도구만
├── PostToolUse.Read     # Read 도구만
└── SessionEnd           # 세션 종료 시

패턴 문법:

  • PreToolUse.Edit_Write → Edit|Write (정규식)
  • PostToolUse.Bash → Bash

우선순위​

Claude Code와 동일:

  1. Personal (~/Documents/.agents/) - 사용자 개인 설정
  2. Project (.agents/) - 프로젝트 설정
  3. Enterprise (향후 지원) - 조직 설정

설계 철학 차이​

Claude Code의 접근법​

사용자 요청 → AI가 알아서 분해 → Skills 조합 → 완료

Claude Code는 모델의 추론 능력에 대한 강한 신뢰를 기반으로:

  • Claude 모델이 복잡한 작업을 스스로 분해
  • 명시적 워크플로우 없이 유연하게 대응
  • 개인 개발자에게 최적화

Careti의 접근법​

사용자 요청 → Workflow 참조 → 단계별 진행 → Skills/Commands → 완료

Careti는 다양한 환경과 모델을 지원:

  • 명시적 워크플로우로 일관성 보장
  • 팀/기업 환경에 최적화
  • 다양한 모델 품질에 대응

비교​

관점Claude CodeCareti
대상 모델Claude만266개+ 모델
사용 환경개인 개발자개인 + 팀/기업
프로세스유연성 우선일관성 옵션
워크플로우암묵적 (AI 판단)명시적 + 암묵적

Workflows: Careti 확장 기능​

ℹ️Note

Workflows는 Claude Code에 없는 Careti 고유 기능입니다. 사용하지 않아도 Claude Code 기능만으로 충분히 작동합니다.

언제 Workflows가 필요한가?​

시나리오Claude CodeCareti
개인 개발자 혼자 작업✅ 충분✅ 충분
팀에서 일관된 프로세스🟡 모델 의존✅ Workflows
감사 추적 / 컴플라이언스🟡 모델 의존✅ Workflows
성능이 낮은 모델 사용❌ 불안정✅ Workflows 가이드
신입 온보딩🟡 개인차✅ Workflows 표준화

계층 구조​

Workflows (최상위) - 복잡한 다단계 절차
  └── Commands/Skills (중간) - 슬래시로 호출하는 단일 작업
       └── Tools (최하위) - Read, Write, Bash 등 기본 도구

예시: feature-development.md​

# 기능 개발 워크플로우

## 1단계: 분석
- 요구사항 파악
- 영향 범위 확인
- 체크리스트 A 완료

## 2단계: 설계
- 아키텍처 결정
- 인터페이스 정의

## 3단계: 구현
- TDD로 테스트 먼저
- 최소 구현

## 4단계: 검증
- 테스트 커버리지 80%+
- 코드 리뷰

마이그레이션 가이드​

Caret (v0.4.4 이하)에서 Careti로​

⚠️Warning
  • v0.4.5: 디렉토리 구조가 .caretrules/에서 .agents/로 변경
  • v0.4.6: 브랜드가 Caret에서 Careti로 변경 (경로는 .agents/ 유지)

프로젝트 레벨 경로 변경:

v0.4.4 이하 (Caret)v0.4.5+
.caretrules/.agents/context/
.caretrules/workflows/.agents/workflows/
(없음).agents/commands/
(없음).agents/skills/
(없음).agents/hooks/

글로벌 경로 변경:

v0.4.4 이하 (Caret)v0.4.5+
~/Documents/Caret/Rules/~/Documents/.agents/context/
~/Documents/Caret/Workflows/~/Documents/.agents/workflows/
(없음)~/Documents/.agents/commands/
(없음)~/Documents/.agents/hooks/
# 마이그레이션 (심볼릭 링크)
ln -s .caret .agents

# 또는 복사 후 이름 변경
mv .caret .agents

Claude Code에서 Careti로​

  1. 경로 변경 (선택적):

    # Claude Code 구조를 그대로 사용 가능 (심볼릭 링크)
    ln -s .claude .agents

    # 또는 복사
    cp -r .claude/* .agents/

  2. 파일 형식: 변경 없음 (100% 호환)

  3. Hooks: 그대로 작동

  4. 추가 기능 (선택적):

    • Workflows 추가
    • Task Hooks 활용

호환성 보장​

  • 레거시 지원: .caret/ 경로도 폴백으로 지원 (권장하지 않음)
  • 마이그레이션 비용: 경로 변경만 필요
  • 기존 스킬/훅: 100% 작동
  • CI/CD: 경로 업데이트 필요

관련 문서​