Cursor CLIを入れてClaude CodeのCLAUDE.mdをそのまま使う
はじめに
先日Cursorを立ち上げたら、ターミナルに見慣れないメッセージが出ていました。Cursor CLIのインストールを促す案内です。「CLIが出たのか」と思ってすぐにインストールしてみたのですが、そこでふと気になったのが、Claude Codeで育ててきたCLAUDE.mdやスキルをそのまま使えないかということでした。
結論から言うと、シンボリックリンク2本で済む話でした。
Cursor CLIのインストール
インストールはワンライナーです。
$ curl https://cursor.com/install -fsS | bash
Cursor Agent Installer
✓ Detected linux/x64
✓ Package downloaded and extracted
✓ Package installed successfully
✓ Bin directory ready
✓ Symlink created
✨ Installation Complete!
Start using Cursor Agent:
agent
Happy coding! 🚀
$
これでcursorコマンドが使えるようになります。
CursorはCLAUDE.mdを読まない
ここが最大のハマりポイントです。CursorはAGENTS.mdというオープン標準に対応していて、CLAUDE.mdは完全にスルーされます。
AGENTS.mdは2025年半ばにOpenAIやGoogle、Cursorなどが共同で策定したフォーマットで、中身はただのMarkdownです。Claude CodeのCLAUDE.mdと書いてある内容はほぼ同じですが、ファイル名が違うのでお互い読んでくれません。
やることはシンボリックリンク2本だけ
プロジェクトルートで以下を実行します。
ln -s CLAUDE.md AGENTS.md
mkdir -p .cursor
ln -s ../.claude/skills .cursor/skills
1行目でCLAUDE.mdをAGENTS.mdとしてCursorに見せて、2〜3行目でスキルを共有しています。スキルはAgent Skills Open Standardというフォーマットで、Claude CodeとCursorで互換があるのでリンクするだけで動きます。
~/.claude/CLAUDE.mdだけで運用している場合（プロジェクトにCLAUDE.mdがない場合）は、以下のようになります。
ln -s ~/.claude/CLAUDE.md AGENTS.md
mkdir -p .cursor
ln -s ../.claude/skills .cursor/skills
グローバルルールだけ手動対応が必要
Claude Codeは~/.claude/CLAUDE.md（グローバル）と./CLAUDE.md（プロジェクト）を両方マージして読んでくれますが、Cursorにはグローバル AGENTS.md の仕組みがまだありません。Feature Requestは出ていますが、現時点では未対応です。
そのため、グローバルルールについてはCursor Settings > Rules > User Rulesに手動でペーストする必要があります。ここだけは自動化できません。
ちなみにグローバルスキル（~/.claude/skills/）の方はCursorが直接読んでくれるので、何もしなくて大丈夫です。
いくつか注意点
rulesディレクトリはフォーマットが微妙に違う — .claude/rules/と.cursor/rules/ではフロントマターの書式が異なります。ただ、Claude Codeはフロントマターを無視してMarkdown本文だけ読むので、Cursorのフォーマットで統一しておけばどちらでも動きます。
長期的にはAGENTS.mdに寄せるのがよさそう
AGENTS.mdがオープン標準として定着してきているので、いずれはAGENTS.mdを正として管理して、CLAUDE.mdの方をSee @AGENTS.mdと書くのがスマートかもしれません。ただ、まだClaude CodeがAGENTS.mdをネイティブサポートしていないので、しばらくはシンボリックリンク運用でいいかなと思っています。
まとめ
Cursor CLIが登場したことで、Claude CodeとCursorの両方をターミナルから使える環境が整いました。CLAUDE.mdの資産をCursorでも活かすには、シンボリックリンク2本を張るだけです。
-
CLAUDE.md→AGENTS.mdのシンボリックリンク -
.claude/skills→.cursor/skillsのシンボリックリンク - グローバルルールだけはCursor Settingsに手動コピー
AGENTS.mdがオープン標準として広まっていく流れなので、今のうちにこの仕組みを入れておけば、今後どちらのツールを使っても同じルールで開発できます。
Discussion