拿到源码，继续开发
生成独立的 TypeScript 项目，包含 agent.ts、原始指令、Skills 和支持文件。直接打开、修改、提交。
开源工具 · 为你已经写好的 AGENT 而生
写好的 Agent
带到 Cursor
把 Claude Code、Codex 的 Agent 和 Skills，变成可编辑的 Cursor Agent SDK 项目。保留源文件，看清迁移差异，接着往下做。
读源码，改成你想要的样子
安装 CLIv0.1.1
npm install --global @kyun.si/agent2cursor@0.1.1- MIT 开源
- Node.js ≥22.13
- 转换无需登录
已经积累的工作↘
✳
Claude Code
.md⌘
Codex
.toml⊞
Skills
SKILL.mdagent2cursor↓
my-agent/可编辑的 TypeScript
TS├─ bot/agent.ts├─ bot/subagents/├─ bot/skills/└─ evals/迁移过程，有据可查✓
instructions已映射model继承父模型tools限制未保留每个字段都有交代↗
输出示意 · SDK 0.3.0
让已经写好的东西继续发挥作用
Claude Code+Codex+Agent Skills→Cursor Agent SDK
01 / 迁移，也把细节带上
一个看得清楚的新起点
把散落的 Agent 文件整理成你自己的项目。迁移报告和代码放在一起，每一步取舍都有依据。
迁移差异，逐项说明
每个源字段都会标记为已映射、降级或丢弃。模型选择、工具限制、不支持的 hooks，都写进报告。
让验证有个起点
生成路由 eval，帮助检查 Agent 和 Skill 的选择。安装目标项目依赖后可做结构校验，真实行为仍需单独测试。
my-agent/
├─ bot/
│ ├─ agent.ts
│ ├─ instructions.md
│ ├─ subagents/
│ │ └─ code-reviewer/
│ │ ├─ agent.ts
│ │ └─ instructions.md
│ ├─ skills/
│ └─ tools/
├─ evals/
├─ MIGRATION.zh-CN.md
└─ package.json原始指令保留原文，不会被翻译。
看看真实样例怎么转换
仓库样例 → 生成源码与字段报告。结构校验和真实模型运行是两回事。
02 / 从终端开始
先带一个 Agent 过来
先用上方命令安装 CLI，再到包含对应输入的项目中执行。输入路径必须存在，输出目录需要是全新的。
01
先看迁移计划
查看逐字段迁移报告。这一步不会写入文件。
agent2cursor inspect .claude/agents --lang zh02
生成可编辑项目
创建 ./my-agent 和迁移报告，不会覆盖已有输出。
agent2cursor convert .claude/agents --out ./my-agent --lang zh03
审阅之后，再做校验
先审阅报告、模型选择与权限差异。以下命令检查结构并列出 eval，不会运行模型。
cd my-agent
npm install
npm run validate
npx agent-sdk eval --dir . --list准备运行真实模型时，需要 Cursor 登录与模型权限。
查看完整使用指南03 / 开始前，了解这些
你可能还想知道
支持哪些输入？
支持 Claude Code 的 Markdown 子代理、Codex 独立 TOML Agent、SKILL.md 目录及支持文件，以及 tstack 技能工作流。可以组合多种输入；不会导入父级 config.toml、凭据或聊天记录。
直接复制 SKILL.md 不就行了吗？
如果只有兼容的 Skills，直接复制就够了。当你还需要子代理转换、可编辑的 SDK 项目、逐字段迁移报告、禁用的脚本适配器和路由 eval 时，agent2cursor 才更有用。
转换后，行为会完全一样吗？
不会保证。报告会标明差异，但不能保证模型行为或运行时权限等价。源模型 ID 默认省略，让目标子代理继承父模型。请审阅生成的项目，并用自己的任务验证。
一定要有 Cursor 账号吗？
查看和转换不需要登录，安装依赖后的结构校验也不需要。真实模型运行与实际模型 eval 需要有模型权限的 Cursor 账号；Agent 托管另有账号和仓库权限要求。
这是 Cursor 官方项目吗？
agent2cursor 是 Eason Yang 开发的独立 MIT 开源项目，与 Cursor、Anysphere、Anthropic、OpenAI、xAI、Theo Browne 或 T3 无官方关联或背书。目标 SDK 是独立的依赖。