OpenCode 向け Claude コード移行ガイド(opencode-migration)

Tool

概要

本リポジトリは「ClaudeCode → OpenCode」への移行を目的としたプレイブックと、移行をオーケストレーションする OpenCode スキル(SKILL.md)を提供します。実装は軽量で、ラッパー(wrapper)とシンボリックリンク(symlink)を用いることで既存の参照や呼び出しを新しい OpenCode 実装へ繋ぎ替えるアプローチを採っています。ユーザーレベル(~/.config/opencode/skill/…)にインストール可能で、手順に沿ってコピーするだけで機能を追加できます。ドキュメント中心の構成で少数ファイルにより構成されています。

GitHub

リポジトリの統計情報

  • スター数: 3
  • フォーク数: 0
  • ウォッチャー数: 3
  • コミット数: 3
  • ファイル数: 4
  • メインの言語: 未指定

主な特徴

  • ClaudeCode から OpenCode へ移行するための手順書(プレイブック)を提供。
  • OpenCode 用のスキル(claude-migration-orchestrator)をそのままユーザーレベルにインストール可能。
  • ラッパーとシンボリックリンクを活用し、既存ワークフローを最小限の変更で切り替え。
  • 軽量なドキュメント中心リポジトリで導入ハードルが低い。

技術的なポイント

このプロジェクトはコード本体というより「移行を実現するための仕組み」とドキュメント群で構成されています。技術的には以下の点が注目できます。

  • オーケストレーションアプローチ:OpenCode が提供する「スキル」機構(SKILL.md を配置するユーザーディレクトリ)を利用して、移行用のエントリポイントを追加します。これにより既存の OpenCode 環境へ非侵襲的に機能を差し込めます。
  • ラッパーの利用:ClaudeCode 側の呼び出しや API 仕様の違いを埋めるためにラッパースクリプト/メタデータを置き、呼び出しを OpenCode 側の実装へリダイレクトします。ラッパーは互換性レイヤーとして機能し、既存スクリプトの変更を最小化します。
  • シンボリックリンク戦略:ファイルやモジュールの参照先をシンボリックリンクで差し替えることで、パスや名前空間を保ったまま実態のみを OpenCode の実装へ差し替える運用が可能です。これにより段階的・可逆的な移行が容易になります。
  • ユーザーレベル導入:インストール手順はホームディレクトリ下の ~/.config/opencode/skill/claude-migration-orchestrator に SKILL.md を配置するだけ。管理者権限が不要なため、個人環境でのテスト導入や段階的移行がしやすい設計です。
  • ドキュメント主導:実際のコード変換や自動化スクリプトは多く含まれておらず、移行手順とオーケストレーション手法の説明に重点が置かれています。つまり本リポジトリは「移行ガイド+簡易スキル」のセットであり、環境ごとの調整や検証はユーザー側で行うことが想定されています。

運用上の注意点としては、シンボリックリンクによる差し替えはパス衝突や権限問題を引き起こす可能性があるため、バックアップ・検証環境での事前テストが推奨されます。また、リポジトリ自体は小規模でコミット数も少ないため、組織的な大規模移行には追加開発や拡張が必要になる点に留意してください。

プロジェクトの構成

主要なファイルとディレクトリ:

  • LICENSE: file
  • README.md: file
  • claude-migration-orchestrator.md: file
  • claude_migration_playbook.md: file

(README にあるインストール例)

  1. グローバルな OpenCode スキルディレクトリ作成: mkdir -p ~/.config/opencode/skill/claude-migration-orchestrator
  2. スキルファイルをコピー: cp claude-migration-orchestrator.md ~/.config/opencode/skill/claude-migration-orchestrator/SKILL.md
  3. OpenCode 側でスキルが読み込まれているか確認

まとめ

シンプルで実用的、個人環境での段階的移行に向くガイドとスキル。

リポジトリ情報:

READMEの抜粋:

OpenCode Claude Migration Skill

This repo provides a migration playbook plus a ready-to-install OpenCode skill that orchestrates Claude Code → OpenCode migration using wrappers + symlinks.

Install the skill (user-level)

  1. Create the global OpenCode skill directory:
mkdir -p ~/.config/opencode/skill/claude-migration-orchestrator
  1. Copy the skill file:
cp claude-migration-orchestrator.md ~/.config/opencode/skill/claude-migration-orchestrator/SKILL.md
  1. Verify:…