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``)​

加载技能时执行shell命令并替换结果：

当前分支: !`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
目标模型仅Claude266+模型
使用环境个人开发者个人 + 团队/企业
流程灵活性优先一致性选项
工作流隐式（AI判断）显式 + 隐式

Workflows: Careti扩展​

ℹ️Note

Workflows是Careti独有的功能，Claude Code中没有。您可以仅使用Claude Code功能而不使用Workflows也能正常工作。

何时需要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: 需要路径更新

相关文档​