Hybrid-Betrieb opencode + Claude Code waehrend Migration

Hybrid-Betrieb

Bis Cutover (Ziel 2026-06-21) laufen opencode und Claude Code parallel auf demselben Vault. Diese Doku regelt wann welches Tool greift, wo Konflikte entstehen koennen, und wie der Token-Budget-Stream getrennt bleibt.

Tool-Wahl pro Aufgabentyp

Aufgabe	Tool waehrend Hybrid-Phase	Begruendung
Vault-Edits, Wissens-Files, Plan-Docs	Beide gehen — git als Source of Truth	Egal welches Tool, immer git status vor Commit
Email-Drafts (/email, /email-review)	CC bis Phase 1 abgenommen, danach opencode	Skills noch nicht migriert
Termin-Koordination (/termin)	CC bis Phase 2	Skill noch nicht migriert
Code-Planung (ce:plan)	CC bis Phase 3	compound-engineering noch nicht ersetzt
Code-Bau (ce:work)	CC bis Phase 3	analog
Ad-hoc Coding (kein Skill noetig)	opencode bevorzugt	Multi-Modell-Switch via /models testen, Sonnet-Bedrock-Pfad warmlaufen
MCP-Tool-Calls (hetzner, aws-*, etc.)	Beide funktional	opencode hat 8 von 13 MCPs connected ohne Setup-Aenderung
Inbox-Sortierung (wiki-maintenance)	CC bis Phase 1	Skill noch nicht migriert
Browser-QA (qa-staging)	CC bis Phase 3	Skill noch nicht migriert
Security-Audit (security-audit)	CC bis Phase 3	Skill noch nicht migriert

Faustregel: Skill-getriebene Aufgaben in CC bis Phase X abgenommen. Ad-hoc-Coding/Conversation in opencode — das ist die Lern-Spur.

Konflikt-Punkte

File-Konflikte im Vault

Beide Tools schreiben in dasselbe Verzeichnis. Risiko: gleiche Datei gleichzeitig editieren.

Mitigation:

• Pro Datei nur EIN Tool zur Zeit
• Vor jedem Tool-Wechsel: git status in der Vault-Root checken
• Wenn beide Tools im Laufen sind: nicht parallel an derselben Datei arbeiten

Memory-Drift

CC hat das ~/.claude/projects/.../memory/-System mit 22 Files. opencode liest das NICHT. Das bedeutet:

• Wenn du in opencode eine Praeferenz aeusserst die in CC als Memory abgelegt wuerde — das geht verloren bis Phase 4 (Memory-Konsolidierung ins Vault).
• Bestehende Memory-Files wirken nur in CC, nicht in opencode.

Workaround: Wichtige Patterns die in Hybrid-Phase neu entstehen direkt in den Vault schreiben (intern/wissen/prozesse/ oder intern/firma/), nicht auf Memory-Auto-Capture verlassen.

MCP-Auth-Konflikte

Manche MCPs haben Session-State (gsuite OAuth-Token, hetzner-op-Refresh). Wenn beide Tools gleichzeitig die gleiche MCP-Session nutzen kann das schief gehen.

Mitigation:

• Heavy MCP-Workflows nicht parallel in beiden Tools
• Bei gsuite-OAuth-Refresh-Issues: kurzfristig nur ein Tool offen halten

Token-Budget-Trennung

Tool	Provider	Billing-Stream
Claude Code	Anthropic Pro-Abo (OAuth)	~20 USD/Monat fix
opencode	AWS Bedrock EU via av-production	pay-per-token via AWS-Account 425924867359

Monitoring:

• AWS-Kosten: intern/finanzen/cloud-snapshots/2026-XX-aws.md (wochenweise)
• Soft-Limit fuer opencode-Bedrock in Migrations-Phase: 50 USD/Monat (niedriger als 130 USD aus Plan-R9, weil noch keine Skills voll migriert)
• Wenn opencode-Anteil >50 USD vor Cutover steigt: analysieren ob das ein gesundes Wachstum ist oder Token-Verschwendung

Wann der Hybrid-Modus endet

Hybrid endet mit dem Cutover-Tag (Ziel 2026-06-21). Cutover-Checkliste siehe plan.md ganz unten. Nach Cutover:

• CC bleibt 4 Wochen installiert als Notfall-Fallback
• Danach Deinstallation

Anti-Pattern

• „Ich nutze einfach beide parallel ohne Plan” — dann verschleppt sich die Migration in „ewig zwei Tools”. Nicht.
• „Ich mache alles in opencode, auch ohne migrierte Skills” — riskiert Qualitaetsverlust bei Skill-getriebenen Workflows. Bis Skill migriert ist: CC.
• „Ich packe Memory-Patterns weiterhin in ~/.claude/projects/.../memory/” — diese gehen mit Migration verloren. Stattdessen sofort ins Vault.