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のすべてのスキル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固有の機能です。Workflowsを使用しなくてもClaude Codeの機能だけで十分に動作します。

いつWorkflowsが必要か?​

シナリオClaude CodeCareti
個人開発者が一人で作業✅ 十分✅ 十分
チームで一貫したプロセス🟡 モデル依存✅ Workflows
監査証跡 / コンプライアンス🟡 モデル依存✅ Workflows
低性能モデルの使用❌ 不安定✅ Workflowsガイド
新人オンボーディング🟡 個人差✅ Workflows標準化

階層構造​

Workflows(最上位) - 複雑な多段階手順
└── Commands/Skills(中間) - スラッシュで呼び出す単一タスク
└── Tools(最下位) - Read、Write、Bashなど基本ツール

マイグレーションガイド​

Caret(v0.4.4以下)からCaretiへ​

⚠️Warning
  • v0.4.5: ディレクトリ構造が .caretrules/ から .agents/ に変更
  • v0.4.6: ブランドがCaretからCaretiに変更(パスは .agents/ のまま)

Claude CodeからCaretiへ​

  1. パス変更(オプション):

    # Claude Code構造をそのまま使用(シンボリックリンク)
    ln -s .claude .agents

    # またはコピー
    cp -r .claude/* .agents/
  2. ファイル形式: 変更なし(100%互換)

  3. Hooks: そのまま動作

  4. 追加機能(オプション):

    • Workflowsを追加
    • Task Hooksを活用

互換性保証​

  • レガシーサポート: .caret/ パスもフォールバックとしてサポート(非推奨)
  • マイグレーションコスト: パス変更のみ必要
  • 既存のskills/hooks: 100%動作
  • CI/CD: パス更新が必要

関連ドキュメント​