OpenCode Integreren met CodingPlanX Aangepaste Modellen

Gebruik OpenCode, de open-source terminal AI programmeerassistent, in combinatie met de CodingPlanX API om de ultieme command-line ontwikkelervaring te creëren.

---

🌟 Projectintroductie

OpenCode is een 100% open-source terminal AI programmeerassistent. Het is qua ontwerp vergelijkbaar met Claude Code, maar biedt extreme flexibiliteit en aanpassingsmogelijkheden. Het is niet gebonden aan een specifieke AI-dienstverlener, ondersteunt naadloos schakelen tussen meerdere modellen, beschikt over native LSP (Language Server Protocol) integratie, en heeft een geek-vriendelijke TUI (Terminal User Interface).

1. Kernfuncties van OpenCode

OpenCode is een open-source AI-programmeringsagent ontwikkeld door het SST-team, speciaal gebouwd voor geeks en zware terminalgebruikers:

• 🔓 100% Open Source: Gebaseerd op de MIT-licentie, is de code volledig transparant.
• 🧠 Multi-Model Ondersteuning: Kan configureren en naadloos schakelen tussen Claude, OpenAI, Google Gemini en meer.
• ⚡ Native LSP Ondersteuning: Ingebouwd Language Server Protocol biedt razendsnelle en nauwkeurige intelligente code-analyse en navigatie.
• 🖥️ TUI First: Ontworpen voor terminalgebruikers door doorgewinterde Neovim-gebruikers, volledig met het toetsenbord te bedienen.
• 🌐 C/S Architectuur: Ondersteunt besturing op afstand; draai de server lokaal en beheer deze op afstand via mobiel of een andere pc.
• 🔄 Twee Ingebouwde Agents: Bevat standaard build (volledige lees-/schrijftoegang voor hoofdontwikkeling) en plan (alleen-lezen voor analyse en planning).

2. oh-my-opencode (Aanbevolen Verbetering)

oh-my-opencode is de ultieme verbeteringsplug-in voor OpenCode, in de community bekend als "OpenCode on steroids". Het biedt een direct inzetbare professionele AI-coderingservaring.

Belangrijkste Verbeteringsfuncties:

• Asynchrone Sub-agents: Parallelle taakverwerkingsmogelijkheden vergelijkbaar met Claude Code, wat de efficiëntie voor complexe taken aanzienlijk verbetert.
• Samengestelde Agent Configs: Vooraf geconfigureerd met meerdere professionele agentrollen (bijv. Architect, Librarian, Explorer).
• Geavanceerde AST Tools: Ondersteunt slimme refactoring, diepgaande code-analyse, symbool zoeken en andere geavanceerde functies.
• Ultrawork Modus: Voeg simpelweg ultrawork toe aan uw prompt om automatisch de ultieme parallelle verwerkingsmodus in te schakelen.

Overzicht Ingebouwde Agentrollen:

---

🚀 Installatie en Configuratie

Stap 1: OpenCode Hoofdprogramma Installeren

OpenCode itereert zeer snel, dus het wordt aanbevolen om het officiële script te gebruiken om de nieuwste versie te installeren (Officiële Documentatie):

# Snelle installatie met curl (Aanbevolen)
curl -fsSL https://opencode.ai/install | bash

# Of gebruik Node.js pakketbeheerders
npm install -g opencode  # bun / pnpm / yarn werken ook

# macOS-gebruikers kunnen ook Homebrew gebruiken
brew install opencode

Stap 2: oh-my-opencode Installeren (Sterk Aanbevolen)

oh-my-opencode biedt direct inzetbare professionele configuratiesjablonen, wat u vervelend handmatig afstemmen bespaart:

bunx oh-my-opencode install

💡 Tip: Het installatieproces opent een interactieve wizard die vraagt welke AI-abonnementen u heeft (bijv. Claude, ChatGPT). Vink de vakjes aan volgens uw werkelijke situatie.

Stap 3: CodingPlanX API Eindpunten en Modellen Configureren

Dit is de meest cruciale stap! Gebruik een teksteditor om het configuratiebestand te maken of te wijzigen: ~/.config/opencode/opencode.json.

🎯 Over Modelselectie: Het onderstaande configuratiesjabloon gebruikt de Claude-serie en GPT Codex-serie modellen die door CodingPlanX worden geleverd. Ze presteren het beste in verschillende gezaghebbende programmeerbenchmarks en zijn het gouden duo voor ontwikkelaars.

Kopieer de volgende JSON-inhoud volledig en overschrijf uw opencode.json:

<details open=""> <summary><b>Klik om de volledige opencode.json configuratiecode uit te vouwen</b></summary>

{
  "$schema": "https://opencode.ai/config.json",

  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.codingplanx.ai/v1"
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://api.codingplanx.ai"
      }
    }
  },

  "model": "anthropic/claude-opus-4-5-20251101",
  "small_model": "anthropic/claude-haiku-4-5-20251001",
  "default_agent": "build",

  "permission": {
    "read": "allow", "list": "allow", "glob": "allow", "grep": "allow",
    "codesearch": "allow", "lsp": "allow",
    "edit": "ask", "bash": "ask", "webfetch": "ask", "websearch": "ask",
    "external_directory": "deny", "doom_loop": "ask"
  },

  "agent": {
    "plan": {
      "mode": "primary",
      "description": "Planning/Uitsplitsing/Tech Spec (Alleen-lezen om onbedoelde codewijzigingen te voorkomen)",
      "model": "anthropic/claude-opus-4-5-20251101",
      "temperature": 0.1,
      "prompt": "You are a senior tech lead. Goal: Break down requirements into actionable steps (including acceptance criteria/risks/rollbacks). Default to read-only; do not modify files or run commands. If execution is truly needed, explain why and suggest switching to build/codex.",
      "permission": { "edit": "deny", "bash": "deny", "webfetch": "deny", "websearch": "deny", "doom_loop": "deny" }
    },

    "build": {
      "mode": "primary",
      "description": "Hoofdontwikkeling (End-to-end implementatie/debuggen/tests repareren) - Claude Opus 4.6",
      "model": "anthropic/claude-opus-4-5-20251101",
      "temperature": 0.2,
      "prompt": "You are the primary software engineering agent. Priorities: Minimum viable changes, readability, testability. Briefly explain your plan before making changes. After changing, you must provide: key diff points, how to verify locally (commands), and potential edge cases.",
      "permission": { "edit": "allow", "bash": "allow", "webfetch": "ask", "websearch": "ask", "doom_loop": "ask" }
    },

    "codex": {
      "mode": "primary",
      "description": "Refactoring/Migratie/Grote Wijzigingen (Codex) - GPT-5.2",
      "model": "openai/gpt-5.2-2025-12-11",
      "temperature": 0.2,
      "prompt": "You are a Codex-style engineering agent, excelling at large-scale refactoring, migrations, code reviews, and complex toolchain collaboration. Prioritize keeping the project runnable: step-by-step commits, verifiable at each step. Add safeguards and tests first when uncertain.",
      "permission": { "edit": "allow", "bash": "allow", "webfetch": "ask", "websearch": "ask", "doom_loop": "ask" }
    },

    "review": {
      "mode": "subagent",
      "description": "Code Review/Tweede Brein (Alleen-lezen) - GPT-5.1-Codex-Max",
      "model": "openai/gpt-5.1-codex-max",
      "temperature": 0.1,
      "prompt": "You are a strict code reviewer. Output: 1) Key risks (bugs/security/concurrency/edge cases) 2) Maintainability suggestions 3) Minimal modification suggestions (pseudo-diff is fine) 4) Necessary test points. Default to read-only; do not modify files or run commands.",
      "permission": { "edit": "deny", "bash": "deny", "webfetch": "deny", "websearch": "deny", "doom_loop": "deny" }
    },

    "explore": {
      "mode": "subagent",
      "description": "Snel Code Scannen/Bestanden Lokaliseren/Context Samenvatten (Alleen-lezen) - Claude Haiku 4.5",
      "model": "anthropic/claude-haiku-4-5-20251001",
      "temperature": 0.1,
      "prompt": "You are a rapid exploration sub-agent: Use minimal steps to locate relevant files/functions/call chains, providing clear paths and summaries. Default to read-only; do not modify files or run commands.",
      "permission": { "edit": "deny", "bash": "deny" }
    },

    "general": {
      "mode": "subagent",
      "description": "Algemeen Onderzoek/Documentatie/Oplossingen Vergelijken (Gemiddelde kosten) - Claude Sonnet 4.6",
      "model": "anthropic/claude-sonnet-4-5-20250929",
      "temperature": 0.2,
      "prompt": "You are a general analysis sub-agent: Focused on explaining, weighing options, writing documentation, and comparing solutions. Default to read-only; avoid modifying code if possible.",
      "permission": { "edit": "deny", "bash": "deny" }
    },

    "think": {
      "mode": "subagent",
      "description": "Ondersteund Denken/Randgevallen Afleiden (Alleen-lezen) - GPT-5.2",
      "model": "openai/gpt-5.2-2025-12-11",
      "temperature": 0.2,
      "prompt": "You are a reasoning and edge-case deduction sub-agent: Provide structured analysis and suggestions regarding design, exception paths, concurrency/consistency, and performance bottlenecks. Default to read-only.",
      "permission": { "edit": "deny", "bash": "deny" }
    }
  }
}

</details>

---

Stap 4: API Keys Configureren

Omdat we twee providers hebben geconfigureerd (Anthropic en OpenAI), moet u de API Keys die u van CodingPlanX heeft verkregen, binnen OpenCode binden.

1. Typ opencode in de terminal om het programma te starten.
2. Typ de opdracht /connect in het dialoogvenster.
3. Claude Configureren:
   • Selecteer Anthropic -> Selecteer Manually enter API Key (Handmatig API Key invoeren).
   • Plak uw CodingPlanX API Key en druk op Enter om op te slaan.
4. OpenAI Configureren:
   • Typ opnieuw /connect.
   • Selecteer OpenAI -> Selecteer Manually enter API Key.
   • Plak uw CodingPlanX API Key en druk op Enter om op te slaan.
5. Typ /exit om af te sluiten en start opencode opnieuw op zodat de configuratie van kracht wordt.

🔐 Opmerking: Uw API Keys worden veilig lokaal opgeslagen in het bestand ~/.local/share/opencode/auth.json.

---

💡 Geavanceerde Gebruikstips

Na het voltooien van de configuratie, typt u opencode in de terminal om te beginnen met chatten:

> Hallo, lees de package.json in de huidige directory en introduceer dit project.

1. ⚡ Ultrawork (Ultieme Parallelle Modus)

Als u oh-my-opencode hebt geïnstalleerd, voegt u simpelweg ultrawork (of kortweg ulw) toe aan uw prompt, en OpenCode zal de hoofdagent oproepen om de taak op te splitsen en naar achtergrond sub-agents te sturen voor parallelle verwerking:

> ultrawork Help me de authenticatiemodule in de src/auth directory te refactoren en unit tests toe te voegen.

2. 🎯 @ Syntaxis voor Gerichte Agent Oproepen

U kunt het @-symbool gebruiken om specifieke taken nauwkeurig door te geven aan de professionele agents die we in de JSON hebben geconfigureerd:

> @review Help me de nieuw gecommitte login.ts logica te beoordelen op eventuele beveiligingsproblemen.
> @explore Zoek naar alle API-eindpunten in het project die getUserInfo aanroepen.
> @general Help me vergelijken of het beter is om React Context of Redux te gebruiken voor het huidige project.

3. 🔄 Tab-toets voor Snel Schakelen tussen Modi

Druk op de Tab-toets in het invoervak om snel door de hoofdagents te bladeren:

• build: Hoofdmodus, met volledige bestandslees-/schrijfrechten en uitvoeringsrechten voor de terminal.
• plan: Veilige modus, alleen-lezen rechten, gebruikt voor initiële uitsplitsing van vereisten, architectuuranalyse en technische planning om te voorkomen dat AI per ongeluk code wijzigt.

---

🛠️ FAQ & Probleemoplossing

V1: Melding API-verbinding mislukt of time-out?

• Controleer of de baseURL in opencode.json correct is.
• Controleer of de terminal proxy-conflicten heeft (meestal omzeilt het gebruik van een direct IP problemen met de systeemproxy).

V2: Melding "Model not found" of model niet beschikbaar?

• Bevestig dat de model-ID in het configuratiebestand (bijv. claude-opus-4-5-20251101) exact overeenkomt met de modellenlijst die officieel door CodingPlanX wordt verstrekt. Maak geen spelfouten.

V3: oh-my-opencode plug-in geeft een foutmelding?

• De plug-in bevindt zich in een snelle ontwikkelingsfase. Als u een bug tegenkomt, probeer dan te updaten: bunx oh-my-opencode update.
• Raadpleeg voor meer configuratieproblemen de Officiële oh-my-opencode Documentatie.

---

🔗 Verder Lezen en Volgende Stappen

• 🌐 Officiële OpenCode Website | GitHub Repository