Cursor Cli 入门指南(Claude Code 深度用户快速迁移)
只回答三件事:Skills 兼不兼容、
CLAUDE.md兼不兼容、迁移成本在哪。
结论(30 秒看完)
| 资产 | 是否兼容 | 迁移成本 |
|---|---|---|
项目根CLAUDE.md | ✅直接识别 | 0 |
.claude/skills/ | ✅直接识别 | 0 |
全局~/.claude/CLAUDE.md | ⚠️ 不完全等同 | 复制到 User Rules,约 10 分钟 |
子目录subdir/CLAUDE.md | ❌ 不像 Claude Code 那样按需加载 | 改用AGENTS.md或.cursor/rules/*.mdc |
一句话:项目里的CLAUDE.md和 skills不用动;只有全局CLAUDE.md和子目录规则可能需要补一下。
1. 项目CLAUDE.md—— 可以直接识别
Cursor 官方说明:
Cursor 读取
CLAUDE.md的方式与AGENTS.md相同。把CLAUDE.md放在项目根目录,Cursor 会自动加载。CLAUDE.md会在每次对话中生效(等同alwaysApply: true),用于兼容 Claude Code 项目。
来源:Cursor Help — Rules
| 位置 | Cursor | Claude Code |
|---|---|---|
项目根./CLAUDE.md | ✅ 自动读 | ✅ 自动读 |
项目根AGENTS.md | ✅ 自动读 | ✅(可 import) |
迁移成本:0—— 源码项目里的CLAUDE.md不用改、不用搬。
和 Claude Code 的差异(项目级)
| 能力 | Claude Code | Cursor |
|---|---|---|
根目录CLAUDE.md全文加载 | ✅ | ✅ |
子目录foo/CLAUDE.md按需加载 | ✅ | ❌ 不支持 |
@import语法 | ✅ | 未文档化,不建议依赖 |
.claude/rules/*.md路径规则 | ✅ | ❌ 不加载 |
若规则只在子目录CLAUDE.md里,Cursor 不会自动读到,需改成.cursor/rules/*.mdc(带globs)或嵌套AGENTS.md。
2. 全局~/.claude/CLAUDE.md—— 不完全等同
| 位置 | Claude Code | Cursor |
|---|---|---|
~/.claude/CLAUDE.md | ✅ 每次自动读 | ⚠️ 不等同;Cursor 原生用User Rules |
你全局的 SVN、Token、中文回复等铁律,建议复制到 Cursor Settings → Rules → User Rules(一次性,约 10 分钟)。
也可在 Cursor 设置里开启「Include third-party Plugins, Skills, and other configs」,部分.claude/配置可能被加载,但不如 User Rules 稳定。
3. Skills —— 兼容,不用迁
| 位置 | Cursor 是否认 | 你要做什么 |
|---|---|---|
~/.claude/skills/(全局) | ✅ | 不用动 |
项目下.claude/skills/ | ✅ | 不用动 |
格式相同:skill-name/SKILL.md+ YAML frontmatter。现有 jeecg、vision 等 skills 已在 Cursor 中可用。
迁移成本:0
4. 迁移成本汇总
完全不用动
- 项目根
CLAUDE.md ~/.claude/skills/和项目.claude/skills/- 日常话术(「用 jeecg-codegen 生成 XX」)
可能需要补(看你怎么用)
| 场景 | 做法 | 工作量 |
|---|---|---|
只有项目根CLAUDE.md | 什么都不用做 | 0 |
依赖全局~/.claude/CLAUDE.md | 复制到 CursorUser Rules | ~10 分钟 |
有子目录subdir/CLAUDE.md | 改成.cursor/rules/*.mdc或嵌套AGENTS.md | 每个子目录一次 |
| 长期双开两工具 | 共用AGENTS.md,或CLAUDE.md里@AGENTS.md | 可选 |
不需要做
- ❌ 不必重写 skills
- ❌ 不必改项目源码结构
- ❌ 不必删
CLAUDE.md
5. 对照图
Claude Code Cursor ─────────── ────── ./CLAUDE.md ──✅ 直接识别──→ 不用动 ~/.claude/CLAUDE.md ──⚠️ 不完全──→ 复制到 User Rules subdir/CLAUDE.md ──❌ 不支持──→ .mdc / AGENTS.md .claude/skills/ ──✅ 直接识别──→ 不用动6. 双开最省事做法
- 项目
CLAUDE.md—— 保持不动 - Skills—— 保持
~/.claude/skills/和项目.claude/skills/ - 全局铁律——
~/.claude/CLAUDE.md复制到 CursorUser Rules(一次性) - 可选统一源—— 团队共用
AGENTS.md,CLAUDE.md里写@AGENTS.md
7. 快速上手(3 条)
- Agent 模式= Claude Code 终端 Agent,直接说任务
- Skill 自动匹配= 靠
description关键词,skills 不用改 - 显式点名= 「按 jeecg-bpmn skill 创建请假流程」
更新:2026-07-10 · 已按 Cursor 官方文档修正项目 CLAUDE.md 兼容性说明
