Can Claude Code agent instructions and skills be shared with Gemini CLI, Codex CLI, and Copilot CLI?

2026-03-27 15:00 (15 hours ago)
Can Claude Code agent instructions and skills be shared with Gemini CLI, Codex CLI, and Copilot CLI?

ytyng は、メインの開発ツールとして Claude Code を使っている。Claude Code のサーバー応答が不安定な時に他のエージェント開発ツールも使うことがあるが、その際に Claude Code で作ったスキルや MCP 設定等をそのまま使えたら便利だと考えている。

そこで、Claude Code の設定ファイルやコマンド定義を、他のツール(Gemini CLI, OpenAI Codex CLI, GitHub Copilot CLI)で そのまま 使えるかどうか調査した。理想的には、シンボリックリンクを作るだけで共用したい。

調査対象のツール

各ツールの設定ファイル構造

プロジェクト指示ファイル(Project Instruction)

各ツールは、プロジェクトルートに置く Markdown ファイルを読み込んで、そのプロジェクトでの振る舞いを決める。ファイル名が異なるだけで、中身は同じ自然言語の Markdown。

Tool File Name 公式ドキュメント
Claude Code CLAUDE.md Using CLAUDE.md files
Gemini CLI GEMINI.md GEMINI.md
Codex CLI AGENTS.md AGENTS.md Guide
Copilot CLI AGENTS.md / .github/copilot-instructions.md Custom Instructions

重要な点として、AGENTS.md は Linux Foundation の Agentic AI Foundation が策定するオープン標準 になっている(発表、2025年12月)。OpenAI、Anthropic、Block が共同設立した。60,000以上のオープンソースプロジェクトで採用されており、Claude Code も CLAUDE.md が無い場合に AGENTS.md をフォールバックとして読む。

公式サイト: https://agents.md/

グローバル設定ディレクトリ

Tool Config Dir Settings Format
Claude Code ~/.claude/ settings.json (JSON)
Gemini CLI ~/.gemini/ settings.json (JSON)
Codex CLI ~/.codex/ config.toml (TOML)
Copilot CLI ~/.copilot/ copilot-instructions.md (Markdown)

CLIヘルプ抜粋

各ツールの --help から、設定関連のオプションを抜粋する。

Claude Code:

--system-prompt <prompt>       System prompt for session
--mcp-config <configs...>      Load MCP servers from JSON files
--settings <file-or-json>      Path to settings JSON file
--plugin-dir <path>            Load plugins from a directory
--disable-slash-commands       Disable all skills

Gemini CLI:

--policy                       Additional policy files or directories
--extensions / -e              List of extensions to use
--include-directories          Additional workspace directories

Codex CLI:

-c, --config <key=value>       Override config from ~/.codex/config.toml
-p, --profile <CONFIG_PROFILE> Configuration profile
-s, --sandbox <SANDBOX_MODE>   Sandbox policy

結論: 何が共有できて、何ができないか

シンボリックリンクで共有できるもの

1. プロジェクト指示ファイル: 完全共有可能

全ツールが Markdown 形式の自然言語指示を使用しているため、1つの canonical ファイルから symlink を張るだけで共用できる。

AGENTS.md                              # Source of truth
CLAUDE.md -> AGENTS.md                 # Claude Code
GEMINI.md -> AGENTS.md                 # Gemini CLI
                                       # Copilot CLI は AGENTS.md を直接読む

Git はシンボリックリンクをそのまま追跡するため、チームメンバーが clone しても同じ構造が維持される。

2. グローバル指示ファイル: 完全共有可能

自分の環境では、3つのツールのグローバル指示が同一ファイルを参照している:

~/.claude/CLAUDE.md  -> ~/home-files/config/claude-code/CLAUDE.md
~/.gemini/GEMINI.md  -> ~/home-files/config/claude-code/CLAUDE.md
~/.codex/AGENTS.md   -> ~/home-files/config/claude-code/CLAUDE.md

Claude Code 固有の指示(/review-stage でレビューしろ、等)が Gemini や Codex にも見えるが、該当機能が無いツールは単に無視するため実害はない。

3. スラッシュコマンド / カスタムエージェント

Tool コマンドDir 形式 起動方法
Claude Code ~/.claude/commands/ .md (YAML frontmatter) /command-name
Codex CLI ~/.codex/prompts/ .md (YAML frontmatter) 引数で指定
Gemini CLI ~/.gemini/commands/ .toml /command-name
Copilot CLI ~/.copilot/agents/ / .github/agents/ .agent.md (Markdown) /agent or --agent name

Claude Code と Codex CLI は同じ .md + YAML frontmatter 形式を使うため、symlink で直接共有できる。Copilot CLI は .agent.md という独自拡張子を使い、ファイル構造も異なるため直接共有はできない:

~/.codex/prompts/ -> ~/home-files/config/claude-code/commands/

自分の環境では既にこの symlink が動いている。

Gemini CLI だけは .toml 形式 なので、直接 symlink では共有できない。

Claude Code / Codex CLI のコマンド形式:

---
description: "Create feature branch, commit, push, and open a pull request."
allowed-tools: Bash(git:*), Bash(gh:*), Bash(open:*)
---

今回の修正内容にあった名前でフィーチャーブランチを作ってください。

Gemini CLI のコマンド形式:

description = "Create feature branch, commit, push, and open a pull request."
prompt = """
今回の修正内容にあった名前でフィーチャーブランチを作ってください。
"""

内容は同じだが、ファイル形式が異なる。Gemini CLI 向けには変換が必要。

共有できないもの

スキル(自動トリガー)

Claude Code のスキルシステム(~/.claude/skills/)は、description に基づいてユーザーの入力に自動マッチングしてトリガーされる独自機能。Gemini CLI、Codex CLI ともに同等のシステムを持っていない(Codex は .agents/skills/ を持つが、形式と挙動が異なる)。

Copilot CLI はカスタムエージェント.agent.md ファイル)という仕組みを持ち、コンテキストに応じて自動的にサブエージェントに委譲する機能がある。コンセプトは Claude Code のスキルに近いが、ファイル形式(.agent.md)と配置場所(.github/agents/ or ~/.copilot/agents/)が異なるため、symlink での共有はできない。

スキルは Claude Code の最大の差別化ポイントの一つだが、各ツールが独自のスキル相当機能を持ち始めており、今後の標準化に期待。

settings.json / config.toml

各ツールのスキーマが完全に異なるため共有不可:

  • Claude Code: permissions, hooks, plugins, sandbox を JSON で管理
  • Gemini CLI: auth, theme, mcpServers を JSON で管理
  • Codex CLI: model, trust_level, mcp_servers を TOML で管理

Hooks / Plugins

Claude Code 固有の機能。Copilot CLI にも hooks はあるが形式が異なる。

MCP サーバー設定

Claude Code と Gemini CLI は JSON 形式で似た構造だが、ツール固有のオプション(permissions 等)が混在するため自動同期は困難。手動で同期するのが現実的。

まとめ

設定項目 Claude ↔ Codex Claude ↔ Gemini Claude ↔ Copilot CLI
Project Instruction symlink symlink 不要 (AGENTS.md 直読)
Global Instruction symlink symlink symlink
Slash Commands symlink 変換必要 (toml) 形式が異なる (.agent.md)
Skills - - 形式が異なる (.agent.md)
Settings - - -
MCP - 手動同期 -
Hooks/Plugins - - -

Codex CLI が最も互換性が高く、指示ファイルとコマンドの両方を symlink で共有できる。Gemini CLI は指示ファイルは共有できるがコマンド形式が違う。Copilot CLI は AGENTS.md を直接読むためプロジェクト指示は symlink 不要だが、カスタムエージェント(.agent.md)の形式が独自。

AGENTS.md が Linux Foundation のオープン標準として普及していく流れを見ると、今後ツール間の互換性はさらに高まると思われる。現時点では「指示ファイルは symlink で統一、コマンドとスキルはツール固有」が現実的な落とし所。

参考リンク

Please rate this article
Currently unrated
The author runs the application development company Cyberneura.
We look forward to discussing your development needs.

Categories

Archive