blog canxin - ai-coding
Blog canxin.
Zola
2026-03-18T00:00:00+00:00
https://blog.cxits.cn/id/tags/ai-coding/atom.xml
Berbagi Konfigurasi OpenCode: Default Agent, Plugin, dan Provider
2026-03-18T00:00:00+00:00
2026-03-18T00:00:00+00:00
canxin
https://blog.cxits.cn/id/blog/my-opencode-setup/
<h2 id="1-konfigurasi-saat-ini"><a class="zola-anchor" href="#1-konfigurasi-saat-ini" aria-label="Anchor link for: 1-konfigurasi-saat-ini"><i class="icon"></i></a>
1. Konfigurasi saat ini</h2>
<pre class="giallo" style="color: #839496; background-color: #002B36;"><code data-lang="jsonc"><span class="giallo-l"><span>{</span></span>
<span class="giallo-l"><span style="color: #859900;"> "$schema"</span><span>:</span><span style="color: #2AA198;"> "https://opencode.ai/config.json"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "autoupdate"</span><span>:</span><span style="color: #B58900;"> false</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "compaction"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "auto"</span><span>:</span><span style="color: #B58900;"> true</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "prune"</span><span>:</span><span style="color: #B58900;"> true</span></span>
<span class="giallo-l"><span> },</span></span>
<span class="giallo-l"><span style="color: #859900;"> "default_agent"</span><span>:</span><span style="color: #2AA198;"> "cx-local"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "model"</span><span>:</span><span style="color: #2AA198;"> "openai/gpt-5.3-codex"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "small_model"</span><span>:</span><span style="color: #2AA198;"> "openai/gpt-5.1-codex-mini"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "plugin"</span><span>: [</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-planpilot"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-workbench"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-web-preview"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-cx-agents"</span></span>
<span class="giallo-l"><span> ],</span></span>
<span class="giallo-l"><span style="color: #859900;"> "provider"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "anthropic"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "options"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "apiKey"</span><span>:</span><span style="color: #2AA198;"> "{env:CLAUDE_API_KEY}"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "baseURL"</span><span>:</span><span style="color: #2AA198;"> "https://gateway.example.com/v1"</span></span>
<span class="giallo-l"><span> }</span></span>
<span class="giallo-l"><span> },</span></span>
<span class="giallo-l"><span style="color: #859900;"> "google"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "options"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "apiKey"</span><span>:</span><span style="color: #2AA198;"> "{env:GEMINI_API_KEY}"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "baseURL"</span><span>:</span><span style="color: #2AA198;"> "https://gateway.example.com/v1beta"</span></span>
<span class="giallo-l"><span> }</span></span>
<span class="giallo-l"><span> },</span></span>
<span class="giallo-l"><span style="color: #859900;"> "openai"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "options"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "apiKey"</span><span>:</span><span style="color: #2AA198;"> "{env:OPENAI_API_KEY}"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "baseURL"</span><span>:</span><span style="color: #2AA198;"> "https://gateway.example.com/v1"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "setCacheKey"</span><span>:</span><span style="color: #B58900;"> true</span></span>
<span class="giallo-l"><span> }</span></span>
<span class="giallo-l"><span> }</span></span>
<span class="giallo-l"><span> }</span></span>
<span class="giallo-l"><span>}</span></span></code></pre><h2 id="2-prioritas-merge"><a class="zola-anchor" href="#2-prioritas-merge" aria-label="Anchor link for: 2-prioritas-merge"><i class="icon"></i></a>
2. Prioritas merge</h2>
<p>Prioritas OpenCode (rendah -> tinggi):</p>
<ol>
<li>Remote <code>.well-known/opencode</code></li>
<li>Global <code>~/.config/opencode/opencode.json</code></li>
<li><code>OPENCODE_CONFIG</code></li>
<li>Project <code>opencode.json</code></li>
<li>Direktori <code>.opencode</code> (agents/commands/plugins)</li>
<li><code>OPENCODE_CONFIG_CONTENT</code></li>
</ol>
<p>Layer global cocok untuk default jangka panjang: <code>default_agent</code>, <code>model</code>, <code>small_model</code>, provider umum, dan plugin umum.</p>
<h2 id="3-field-top-level"><a class="zola-anchor" href="#3-field-top-level" aria-label="Anchor link for: 3-field-top-level"><i class="icon"></i></a>
3. Field top-level</h2>
<table><thead><tr><th style="text-align: left">Field</th><th style="text-align: left">Nilai saat ini</th><th style="text-align: left">Fungsi</th><th style="text-align: left">Catatan</th></tr></thead><tbody>
<tr><td style="text-align: left"><code>$schema</code></td><td style="text-align: left"><code>https://opencode.ai/config.json</code></td><td style="text-align: left">Validasi JSON + autocomplete</td><td style="text-align: left">Disarankan tetap ada</td></tr>
<tr><td style="text-align: left"><code>autoupdate</code></td><td style="text-align: left"><code>false</code></td><td style="text-align: left">Menonaktifkan update otomatis</td><td style="text-align: left">Cocok untuk stabilitas</td></tr>
<tr><td style="text-align: left"><code>compaction.auto</code></td><td style="text-align: left"><code>true</code></td><td style="text-align: left">Kompresi otomatis sesi panjang</td><td style="text-align: left">Direkomendasikan</td></tr>
<tr><td style="text-align: left"><code>compaction.prune</code></td><td style="text-align: left"><code>true</code></td><td style="text-align: left">Memangkas output tool lama</td><td style="text-align: left">Mengurangi bloat konteks</td></tr>
<tr><td style="text-align: left"><code>default_agent</code></td><td style="text-align: left"><code>cx-local</code></td><td style="text-align: left">Agent default</td><td style="text-align: left">Disediakan plugin (direkomendasikan sejak 0.2.0)</td></tr>
<tr><td style="text-align: left"><code>model</code></td><td style="text-align: left"><code>openai/gpt-5.3-codex</code></td><td style="text-align: left">Model utama</td><td style="text-align: left">Jalur utama</td></tr>
<tr><td style="text-align: left"><code>small_model</code></td><td style="text-align: left"><code>openai/gpt-5.1-codex-mini</code></td><td style="text-align: left">Model ringan</td><td style="text-align: left">Jalur bantu / biaya</td></tr>
<tr><td style="text-align: left"><code>plugin[]</code></td><td style="text-align: left">4 plugin npm</td><td style="text-align: left">Ekstensi kemampuan</td><td style="text-align: left">Mudah dipakai lintas mesin</td></tr>
<tr><td style="text-align: left"><code>provider.*.options</code></td><td style="text-align: left"><code>baseURL + apiKey</code></td><td style="text-align: left">Parameter koneksi provider</td><td style="text-align: left">Pakai env var</td></tr>
</tbody></table>
<h2 id="4-sumber-default-agent-cx-local"><a class="zola-anchor" href="#4-sumber-default-agent-cx-local" aria-label="Anchor link for: 4-sumber-default-agent-cx-local"><i class="icon"></i></a>
4. Sumber <code>default_agent = cx-local</code></h2>
<p><code>cx-local</code> diregistrasikan oleh plugin <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-cx-agents"><code>opencode-cx-agents</code></a>, bukan ditulis manual dalam blok <code>agent</code> lokal.</p>
<p>Plugin ini saat ini menyediakan canonical agents: <code>cx-explore</code>, <code>cx-local</code>, <code>cx-global</code>.</p>
<p>Dampak:</p>
<ol>
<li>Konfigurasi global lebih ringkas.</li>
<li>Jika plugin gagal dimuat, agent default tidak terdaftar.</li>
</ol>
<h2 id="5-susunan-plugin-fokus"><a class="zola-anchor" href="#5-susunan-plugin-fokus" aria-label="Anchor link for: 5-susunan-plugin-fokus"><i class="icon"></i></a>
5. Susunan plugin (fokus)</h2>
<h3 id="5-1-daftar-plugin-nama-npm"><a class="zola-anchor" href="#5-1-daftar-plugin-nama-npm" aria-label="Anchor link for: 5-1-daftar-plugin-nama-npm"><i class="icon"></i></a>
5.1 Daftar plugin (nama npm)</h3>
<pre class="giallo" style="color: #839496; background-color: #002B36;"><code data-lang="json"><span class="giallo-l"><span style="color: #2AA198;">"plugin"</span><span>: [</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-planpilot"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-workbench"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-web-preview"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-cx-agents"</span></span>
<span class="giallo-l"><span>]</span></span></code></pre>
<p>Repositori GitHub:</p>
<ul>
<li><a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-planpilot"><code>opencode-planpilot</code></a></li>
<li><a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-workbench"><code>opencode-workbench</code></a></li>
<li><a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-web-preview"><code>opencode-web-preview</code></a></li>
<li><a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-cx-agents"><code>opencode-cx-agents</code></a></li>
</ul>
<h3 id="5-2-opencode-planpilot"><a class="zola-anchor" href="#5-2-opencode-planpilot" aria-label="Anchor link for: 5-2-opencode-planpilot"><i class="icon"></i></a>
5.2 <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-planpilot"><code>opencode-planpilot</code></a></h3>
<p><strong>Peran</strong>: eksekusi terstruktur untuk tugas kompleks.<br />
<strong>Kemampuan inti</strong>:</p>
<ul>
<li>model kerja seragam: <code>plan -> step -> goal</code></li>
<li>pemisahan executor <code>ai / human</code></li>
<li>auto-continue jika executor langkah berikutnya <code>ai</code></li>
</ul>
<p><strong>Cocok untuk</strong>: pekerjaan bertahap dengan kebutuhan pelacakan progres.</p>
<h3 id="5-3-opencode-workbench"><a class="zola-anchor" href="#5-3-opencode-workbench" aria-label="Anchor link for: 5-3-opencode-workbench"><i class="icon"></i></a>
5.3 <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-workbench"><code>opencode-workbench</code></a></h3>
<p><strong>Peran</strong>: orkestrasi paralel berbasis branch/worktree.<br />
<strong>Kemampuan inti</strong>:</p>
<ul>
<li>binding eksplisit sesi ke worktree</li>
<li>routing tugas per worktree untuk paralelisme</li>
<li>jejak konteks branch/tugas</li>
</ul>
<p><strong>Cocok untuk</strong>: menjalankan beberapa task paralel di repo yang sama.</p>
<h3 id="5-4-opencode-web-preview"><a class="zola-anchor" href="#5-4-opencode-web-preview" aria-label="Anchor link for: 5-4-opencode-web-preview"><i class="icon"></i></a>
5.4 <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-web-preview"><code>opencode-web-preview</code></a></h3>
<p><strong>Peran</strong>: pengelolaan sesi preview frontend lokal.<br />
<strong>Kemampuan inti</strong>:</p>
<ul>
<li>menemukan sesi preview yang tersedia</li>
<li>start/stop preview host lokal</li>
<li>memeriksa status preview</li>
</ul>
<p><strong>Cocok untuk</strong>: validasi cepat perubahan UI.</p>
<h3 id="5-5-opencode-cx-agents"><a class="zola-anchor" href="#5-5-opencode-cx-agents" aria-label="Anchor link for: 5-5-opencode-cx-agents"><i class="icon"></i></a>
5.5 <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-cx-agents"><code>opencode-cx-agents</code></a></h3>
<p><strong>Peran</strong>: menyediakan preset agent reusable dan baseline permission.<br />
<strong>Kemampuan inti</strong>:</p>
<ul>
<li>canonical agents: <code>cx-explore</code>, <code>cx-local</code>, <code>cx-global</code></li>
<li>tier permission untuk menulis:
<ul>
<li><code>cx-local</code>: workspace-first, <code>external_directory: ask</code></li>
<li><code>cx-global</code>: menulis lintas direktori, <code>external_directory: allow</code></li>
</ul>
</li>
<li>tetap kompatibel dengan <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-planpilot"><code>opencode-planpilot</code></a>, <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-workbench"><code>opencode-workbench</code></a>, dan <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-web-preview"><code>opencode-web-preview</code></a> sambil menjaga visibilitas tools</li>
</ul>
<p><strong>Cocok untuk</strong>: strategi agent yang konsisten lintas repository dengan pilihan default write berbasis risiko.</p>
<h3 id="5-6-saran-penggunaan"><a class="zola-anchor" href="#5-6-saran-penggunaan" aria-label="Anchor link for: 5-6-saran-penggunaan"><i class="icon"></i></a>
5.6 Saran penggunaan</h3>
<ol>
<li>Gunakan <code>default_agent = cx-local</code> sebagai default yang aman.</li>
<li>Beralih ke <code>cx-global</code> hanya saat benar-benar perlu menulis lintas direktori.</li>
<li>Setelah startup, pastikan <code>cx-explore / cx-local / cx-global</code> terlihat.</li>
</ol>
<h2 id="6-provider-dan-routing-model"><a class="zola-anchor" href="#6-provider-dan-routing-model" aria-label="Anchor link for: 6-provider-dan-routing-model"><i class="icon"></i></a>
6. Provider dan routing model</h2>
<p>Susunan provider saat ini: satu domain gateway, rute dipisah per provider.</p>
<table><thead><tr><th style="text-align: left">Provider</th><th style="text-align: left">baseURL</th><th style="text-align: left">Keterangan</th></tr></thead><tbody>
<tr><td style="text-align: left"><code>anthropic</code></td><td style="text-align: left"><code>https://gateway.example.com/v1</code></td><td style="text-align: left">Rute kompatibel Anthropic</td></tr>
<tr><td style="text-align: left"><code>google</code></td><td style="text-align: left"><code>https://gateway.example.com/v1beta</code></td><td style="text-align: left">Rute kompatibel Gemini</td></tr>
<tr><td style="text-align: left"><code>openai</code></td><td style="text-align: left"><code>https://gateway.example.com/v1</code></td><td style="text-align: left">Rute kompatibel OpenAI</td></tr>
</tbody></table>