Hermes Agent dengan Codex dan OpenCode: empat permukaan kredensial, tiga meter

Hermes Agent tidak menggantikan Codex atau OpenCode — Hermes mengendalikan keduanya. Hermes menyertakan dua skill bawaan, codex dan opencode, yang meluncurkan setiap CLI sebagai subproses, dan setiap subproses membayar dengan kredensialnya sendiri, bukan dengan provider model Hermes. Itulah fakta yang perlu dijadikan dasar perencanaan: satu alur kerja, empat permukaan kredensial, tiga meter terpisah, dan dua permukaan yang hanya akan berkomunikasi dengan endpoint yang menyediakan Responses API.

Halaman ini membahas Hermes Agent, perangkat lunak agent berlisensi MIT dari Nous Research — bukan Hermes 3 atau Hermes 4, keluarga model open-weight dari perusahaan yang sama, bukan mesin JavaScript dengan nama yang sama, dan bukan merek barang mewah. Pemeriksaan langsung terhadap repositori pada 19 September 2026 mengembalikan archived: false, lisensi MIT, dan push pada hari itu; rilis terbaru yang dipublikasikan adalah Hermes Agent v0.21.3, diberi tag v2026.9.14 pada 14 September 2026. Untuk biaya menjalankan agent itu sendiri, lihat harga Hermes Agent.

Tiga hal bernama "codex" di dalam Hermes

Benturan nama ini adalah hal pertama yang perlu dibereskan, karena ketiganya muncul dalam konfigurasi dan hanya satu yang dimaksud kebanyakan orang dengan hermes codex.

Sumber: skill codex bawaan, dokumentasi provider, dan halaman runtime server aplikasi Codex, semuanya dibaca pada 19 September 2026.

Mendelegasikan tugas pengodean ke Codex

Skill codex adalah versi 1.0.1, berlisensi MIT, dan tugas yang dinyatakannya adalah "Delegasikan pengodean ke OpenAI Codex CLI (fitur, PR)." Prasyaratnya jelas: Codex terinstal dengan npm install -g @openai/codex; autentikasi OpenAI dikonfigurasi melalui OPENAI_API_KEY atau sesi OAuth Codex; pekerjaan harus berjalan di dalam repositori git, karena Codex menolak berjalan di luar repositori; dan panggilan terminal memerlukan pty=true karena Codex adalah aplikasi terminal interaktif.

Peluncuran dilakukan sebagai panggilan terminal di latar belakang — codex exec --sandbox workspace-write 'Refactor the auth module' dengan workdir — yang mengembalikan ID sesi. Setelah itu Hermes melakukan polling terhadap sesi, membaca log-nya, menjawab prompt persetujuan dengan tindakan submit, dan menghentikannya jika terjadi kesalahan. Hasilnya sampai ke agent utama sebagai output proses ditambah apa pun yang ditinggalkan Codex di working tree; tidak ada memori yang dibagikan antara kedua proses tersebut.

Dua batasan yang didokumentasikan oleh skill, bukan disembunyikan. --full-auto masih berfungsi, tetapi CLI aktif kini memperingatkan agar menggunakan --sandbox workspace-write sebagai gantinya. Dan ketika Codex dipanggil dari gateway atau konteks layanan Hermes — misalnya sesi agent yang digerakkan chat — sandbox workspace-write dapat gagal meskipun perintah identik berfungsi dalam shell interaktif, dengan kesalahan bubblewrap atau namespace pengguna seperti setting up uid map: Permission denied. Solusi yang diberikan oleh skill adalah --sandbox danger-full-access, yang menghapus sandbox Codex sepenuhnya; jika Anda menggunakannya, batas proses tempat Anda menjalankan Hermes menjadi satu-satunya containment yang tersisa.

Mendelegasikan tugas pengodean ke OpenCode

Skill opencode adalah versi 1.2.0, berlisensi MIT, dan dideskripsikan sebagai "Delegasikan pengodean ke OpenCode CLI (fitur, tinjauan PR)." Instal dengan npm i -g opencode-ai@latest atau brew install anomalyco/tap/opencode, lalu opencode auth login dan verifikasi dengan opencode auth list. Dokumentasi OpenCode sendiri juga menyediakan perintah /connect di dalam UI terminal, yang menulis kredensial ke ~/.local/share/opencode/auth.json — kedua jalur ini masih berlaku, jadi mengikuti salah satunya tidak berarti jalur lainnya sudah usang.

Untuk pekerjaan terbatas, skill memilih satu kali eksekusi: opencode run 'Add retry logic to API calls and update tests', dengan --model provider/model untuk menetapkan model. Sesi interaktif dijalankan di latar belakang dengan pty dan dikendalikan menggunakan poll, log, dan submit. Satu jebakan ditegaskan dalam skill dengan huruf tebal: jangan kirim /exit — itu bukan perintah OpenCode yang valid dan justru membuka dialog pemilih agent. Keluar dengan Ctrl+C atau tindakan kill.

Penamaan di sini memiliki jebakan tersendiri yang masih berlaku. Paket npm opencode-ai adalah produk saat ini; organisasi GitHub bernama opencode-ai menyimpan pendahulunya yang telah diarsipkan, terakhir didorong pada 18 September 2025. Dan repositori saat ini adalah anomalyco/opencode, bukan sst/opencode — GitHub API mengarahkan path lama ke yang baru, dan organisasi sst kini menampilkan "We've moved to https://github.com/anomalyco". Rilis terbaru v1.18.31, 14 September 2026 (GitHub REST API, 19 September 2026).

Peta yang benar-benar menentukan tagihan Anda

Inilah bagian yang tidak dicakup oleh dokumentasi kedua vendor, karena masing-masing hanya mengelola separuhnya. Ada empat permukaan kredensial dalam alur kerja ini, dan masing-masing dikonfigurasi dalam file yang berbeda. Keempatnya dapat diarahkan ke endpoint pihak ketiga — tetapi dengan ketentuan yang berbeda, dan kedua permukaan Codex hanya menerima Responses API.

Hermes menyatakan pemisahan ini dengan jelas: OAuth Codex miliknya sendiri berada di ~/.hermes/auth.json sedangkan sesi CLI mandiri berada di ~/.codex/auth.json, dan halaman runtime menambahkan alasannya — Hermes sengaja tidak membagikan status OAuth dengan CLI Codex, untuk mencegah keduanya saling menimpa saat token diperbarui. Jadi, tugas coding yang didelegasikan tidak mewarisi konfigurasi provider Hermes; tugas tersebut membaca ~/.codex/config.toml atau opencode.json, dan menggunakan saldo yang sama hanya jika Anda sengaja mengarahkannya ke kunci yang sama. Ini merupakan fitur ketika Anda menginginkan isolasi blast radius, tetapi menjadi kejutan jika Anda mengira satu saldo mencakup semuanya.

Perubahan yang ditimbulkan runtime app-server

Jika Anda mengaktifkan runtime app-server Codex, perhitungannya berubah dalam tiga hal yang perlu diketahui sebelum Anda mengaktifkannya. Runtime ini merutekan turn openai/*, openai-codex/* dan custom-provider yang dinamai; tabel fiturnya menandai provider non-OpenAI lainnya sebagai "n/a — not routed through codex", dan provider: custom anonim dengan base URL polos secara eksplisit tidak memenuhi syarat, karena tidak ada nama stabil yang dapat diberikan kepada Codex. Empat alat Hermes tidak lagi tersedia di dalamnya — delegate_task, memory, session_search dan todo — karena alat-alat tersebut memerlukan loop agen yang berjalan dan callback stateless tidak dapat menjalankannya. Dan baris biaya yang paling sering terlewat: dengan provider openai-codex, tugas tambahan juga mengalir melalui langganan ChatGPT Anda secara default — pembuatan judul, kompresi konteks, deteksi otomatis visi, dan fork peninjauan peningkatan mandiri di latar belakang — karena klien tambahan Hermes menggunakan provider utama ketika override per tugas tidak ditetapkan.

Endpoint pihak ketiga tidak dikecualikan dari runtime ini, tetapi Anda memerlukan file konfigurasi kedua. Halaman runtime mendokumentasikan rutenya: entri providers.<name> dalam ~/.hermes/config.yaml dengan openai_runtime: codex_app_server, ditambah tabel [model_providers.<name>] dengan nama yang sama dalam ~/.codex/config.toml yang membawa base_url, env_key dan wire_api = "responses". Hermes hanya mengirim model dan nama provider saat thread dimulai dan tidak pernah meneruskan kunci, sehingga variabel lingkungan tersebut harus tersedia dalam proses tempat Hermes dijalankan; panggilan tambahan tetap menggunakan entri milik Hermes untuk provider tersebut. Satu catatan yang juga dinyatakan halaman yang sama: kedua nama harus sama persis, atau Codex melaporkan provider yang tidak dikenal alih-alih kembali ke endpoint Hermes. Tetap menggunakan runtime default (openai_runtime: auto) dengan provider custom: tetap menjadi rute yang lebih sederhana, dan satu-satunya rute yang tidak mengharuskan endpoint berbicara dalam Responses. Perhatikan juga bahwa Hermes mengarahkan subprocess Codex ke ~/.codex/ terlepas dari profil Hermes yang aktif, sehingga hermes -p work dan hermes -p personal berbagi satu autentikasi Codex kecuali Anda menetapkan CODEX_HOME dan masuk lagi.

Mengarahkan ketiga permukaan terbuka ke satu endpoint

Setiap blok di bawah ini dibaca dari dokumen sumber vendor, bukan diuji saat runtime. Kunavo belum menjalankan sesi Hermes, codex exec atau opencode run terhadap endpoint-nya, dan panduan penyiapan yang dipublikasikan merupakan referensi konfigurasi, bukan pengujian kompatibilitas. Pertahankan rute yang berfungsi saat Anda mencoba ini.

# Surface 1: Hermes' own turns.
providers:
  kunavo:
    api: https://api.kunavo.com/v1     # aliases: base_url, url
    key_env: KUNAVO_API_KEY
    transport: chat_completions        # set it explicitly; auto-detection is only a fallback

model:
  default: claude-sonnet-4-6
  provider: custom:kunavo

transport adalah keseluruhan cerita untuk turn milik Hermes. Kunavo menyediakan /v1/chat/completions, /v1/messages dan /v1/responses, sehingga setiap nilai transport Hermes memiliki endpoint yang sesuai — kecocokan pada tingkat dokumentasi, bukan yang telah diuji. Dokumentasi provider Hermes menyatakan bahwa deteksi otomatis berbasis URL hanya terjadi sebagai fallback ketika field kosong, jadi tetapkan nilainya. Beralih di tengah sesi dengan /model custom:kunavo:<model-id>.

# Surface 2: the delegated Codex CLI. Keep this OUTSIDE Hermes' managed block.
model = "claude-sonnet-4-6"
model_provider = "kunavo"

[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"   # the NAME of the variable, not the key itself
# wire_api defaults to "responses", and "responses" is the only value that parses.
# Leave requires_openai_auth unset: true sends Codex to auth.json instead of env_key.

Bagian Codex merupakan gerbang yang tegas, dan layak dilihat pada tingkat sumber alih-alih diterima begitu saja. Dalam codex-rs/model-provider-info/src/lib.rs, dibaca pada 19 September 2026, enum protokol wire memiliki tepat satu varian: Responses. Menetapkan wire_api = "chat" kini menjadi kesalahan konfigurasi tegas yang pesannya meminta Anda menetapkan responses sebagai gantinya. Gateway yang hanya berbicara Chat Completions sama sekali tidak dapat menjadi provider Codex. Referensi kunci saat ini berada di learn.chatgpt.com — apa pun yang masih mencantumkan developers.openai.com/codex/… merupakan pengalihan 308, yang kami konfirmasi pada hari yang sama.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kunavo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kunavo",
      "options": {
        "baseURL": "https://api.kunavo.com/v1",
        "apiKey": "{env:KUNAVO_API_KEY}"
      },
      "models": { "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" } }
    }
  }
}

Untuk OpenCode, paket npm menentukan format wire: @ai-sdk/openai-compatible memanggil /chat/completions, sedangkan @ai-sdk/openai memanggil /responses. Namai yang sesuai dengan path yang benar-benar disediakan endpoint Anda; dokumentasi tidak menjelaskan mode kegagalan jika menamai yang lain, dan kami tidak mengujinya. Apakah skill yang disertakan menghormati custom provider yang dikonfigurasi dengan cara ini merupakan inferensi dari dokumentasi sub-CLI — skill tersebut hanya menjalankan shell-out subprocess biasa, jadi seharusnya demikian — tetapi tidak ada dokumen Hermes yang menyatakannya dan kami tidak menjalankannya.

Estimasi yang dikerjakan untuk ketiga meter

Ini adalah perhitungan token ilustratif, bukan biaya tugas yang diukur dan bukan batas atas tagihan. Anggap satu hari yang sibuk: orkestrator dan slot tambahannya menggunakan 1.500.000 token input tanpa cache dan 80.000 token output, dan setiap worker coding yang didelegasikan menggunakan 2.000.000 token input dan 120.000 token output. Rasio tersebut merupakan asumsi untuk ilustrasi. Tarifnya adalah harga katalog Kunavo saat ini per juta token.

Dengan asumsi ini, menjalankan ketiga peran pada model Claude Sonnet 4.6 menghasilkan $14,91 untuk hari tersebut, sedangkan menempatkan orkestrator dan lalu lintas tambahannya pada Claude Haiku 4.5 serta kedua worker coding pada model Claude Sonnet 4.6 menghasilkan $12,25. Selisih tersebut menjadi alasan untuk memilih model per peran, dan juga alasan peta kredensial di atas penting: jika worker coding menggunakan akun terpisah, perhitungan ini harus dilakukan tiga kali, terhadap tiga meter, bukan sekali.

Jumlah katalog Kunavo merupakan batas minimum penagihan, bukan batas maksimum: ketika upstream melaporkan biayanya, tagihan adalah nilai yang lebih besar antara biaya katalog dan biaya upstream dikalikan markup yang berlaku. Biaya cache dan alat eksternal berada di luar contoh ini. Top-up minimum adalah $10 dalam kredit prabayar, yang merupakan minimum pendanaan, bukan biaya tugas atau langganan — lihat detail penagihan.

Rute pendanaan mana yang unggul dan kapan

Dua koreksi terhadap pemahaman umum. "Codex berbiaya $20 per bulan" dan "Codex menggunakan pembayaran per token" sama-sama keliru dengan cara yang sama: learn.chatgpt.com (dibaca pada 19 September 2026) menjelaskan dua cabang — paket ChatGPT bernama Free, Go, Plus, Pro, Business, dan Enterprise & Edu yang kuotanya mencakup penggunaan Codex, atau kunci API yang ditagihkan dengan tarif API standar tanpa memerlukan langganan. Hanya cabang kedua yang memungkinkan endpoint pihak ketiga digantikan. Kami sengaja tidak mencetak kuota pesan per paket: halaman tersebut menyatakan jumlahnya bergantung pada model dan ukuran tugas Anda, dan pembacaan kami atasnya dilakukan melalui peringkas, bukan HTML yang dirender. Periksa akun Anda sendiri. Di sisi lain, OpenCode Zen menyatakan bahwa layanan tersebut "sepenuhnya opsional dan Anda tidak perlu menggunakannya untuk menggunakan OpenCode", mengenakan biaya per permintaan dari saldo kredit, dan secara default memuat ulang $20 ketika saldo turun di bawah $5 — perbedaan nyata dalam pengendalian biaya dibandingkan saldo prabayar yang Anda isi sendiri.

Siapkan, lalu baca ketiga meter

Mulailah dari permukaan yang benar-benar Anda perlukan. Kunavo menerbitkan referensi penyiapan untuk kedua worker coding: Codex CLI mencakup blok provider khusus Responses, dan OpenCode mencakup pilihan paket npm yang menentukan format wire. Jalankan satu delegasi yang dibatasi, lalu baca biaya yang dicatat setiap akun untuknya — /usage Hermes, opencode stats --days 7, dan akun worker Codex itu sendiri — sebelum menganggap salah satu dari ketiga angka tersebut mencakup yang lain. Buat akun Kunavo saat Anda siap mendanai kunci.

Membandingkan kedua worker coding, bukan menghubungkannya? OpenCode vs Codex membahas pertanyaan tersebut secara langsung, dan OpenAI-compatible API menjelaskan arti kedua format wire dalam praktik.

Pertanyaan umum

Diperiksa pada 19 September 2026: codex Hermes Agent dan file skill opencode serta runtime app-server Codex dan dokumen provider dalam repositori tersebut; codex-rs/model-provider-info/src/lib.rs dalam openai/codex; referensi harga dan konfigurasi learn.chatgpt.com, termasuk pengalihan 308 dari developers.openai.com; halaman provider dan Zen opencode.ai; serta status repositori keempat proyek melalui GitHub REST API. Tidak diperiksa: eksekusi apa pun dari semua ini. Tidak ada sesi Hermes, codex exec, opencode run, atau permintaan dari alat-alat ini ke endpoint Kunavo yang dijalankan, dan kuota pesan per paket serta tarif model Zen sengaja dihilangkan karena pembacaan kami atas kedua halaman tersebut dilakukan melalui peringkas. Tarif token Kunavo berasal dari katalog saat ini; setiap angka dolar di sini merupakan perhitungan token ilustratif.