Skip to content
Apothem
Adaptor harness

GLM (Z.ai)

Adapter harness Apothem untuk GLM (Z.ai) sebagai backend model yang dapat dikonfigurasi.

Vendor: Z.ai Nama instalasi: glm Status: GA Konfigurasi native: <project>/.apothem/providers/glm.toml

Adapter glm mengonfigurasi GLM (Z.ai) sebagai backend model. Alat yang menggunakan protokol yang kompatibel dengan Anthropic atau yang kompatibel dengan OpenAI diarahkan ke GLM dengan menyetel base URL backend dan sebuah kunci, dan Anda memilih adapter ini dengan --harness glm seperti adapter lain. Adapter ini menulis berkas konfigurasi penyedia yang mencatat kedua permukaan kompatibilitas tersebut sehingga alat kompatibel apa pun dapat disambungkan ke keluarga model GLM.

Z.ai juga menyediakan alat pengodean resmi miliknya sendiri, ZCode, yang oleh dokumentasi Z.ai disebut sebagai "Agentic Development Environment". Adapter ini tidak mengonfigurasi ZCode. Apothem belum memeriksa permukaan konfigurasi ZCode sendiri, sehingga adapter tidak menulis apa pun untuknya.

Instalasi

apothem install --harness glm --project /path/to/project

Adapter menulis satu berkas penyedia berlingkup proyek yang mencatat endpoint backend GLM dan placeholder yang dapat dikonfigurasi operator.

Berkas yang ditulis: <project>/.apothem/providers/glm.toml

Pemetaan profil ke konfigurasi native

Berkas penyedia mencatat dua backend. Backend yang kompatibel dengan Anthropic menggunakan base URL https://api.z.ai/api/anthropic; alat yang menggunakan protokol Anthropic dirutekan ke GLM dengan menyetel ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, dan secara opsional API_TIMEOUT_MS. Tabel [backends.anthropic_compatible.env] di dalam berkas mencantumkan variabel-variabel tersebut dan juga ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, dan ANTHROPIC_DEFAULT_HAIKU_MODEL, yang memetakan peran opus, sonnet, dan haiku milik alat ke model GLM. Backend yang kompatibel dengan OpenAI menggunakan base URL https://api.z.ai/api/coding/paas/v4. Token autentikasi adalah placeholder yang Anda ganti dengan kunci Z.ai Anda sendiri — Apothem tidak pernah menulis rahasia sungguhan. ID model mudah berubah antarversi, sehingga Apothem tidak mematok satu pun; berkas tersebut membawa placeholder <GLM_MODEL_ID> yang Anda isi dari dokumentasi Z.ai yang terkini. Tidak ada apa pun dari profil bersama yang masuk ke berkas ini; berkas ini adalah templat tetap.

Pemetaan peran ke model

Pernyataan Z.ai sendiri tentang pemetaan peran ke model saling bertentangan, sehingga berkas tersebut membiarkan ketiga nilai ANTHROPIC_DEFAULT_*_MODEL sebagai placeholder dan membawa komentar TODO(clarify) di atasnya. Anda yang memutuskan pemetaan mana yang dipakai:

  • Contoh settings.json manual dalam panduan penyiapan kompatibel-Anthropic milik vendor memetakan opus dan sonnet ke glm-5.3[1m] dan haiku ke glm-5.3-flash[1m], serta menyetel CLAUDE_CODE_AUTO_COMPACT_WINDOW ke 1000000.
  • Pemetaan default yang dinyatakan dalam panduan yang sama mencantumkan GLM-5.3-Flash untuk ketiga peran.
  • Alat @z_ai/coding-helper milik Z.ai menggunakan default glm-5.3-flash, menambahkan [1m] ke ketiga peran, dan menulis jendela pemadatan 1048576.

Apothem tidak mematok satu pun dari nilai-nilai ini dan tidak memilih di antara keduanya.

Catatan kompatibilitas

Backend GLM tidak mengekspos permukaan untuk aturan, command, skill, atau hook, sehingga adapter hanya menulis berkas penyedia backend dan tidak ada yang lain. Apothem belum memeriksa apakah ZCode mengekspos permukaan semacam itu. Kunci Z.ai Anda dan pilihan ID model Anda tetap menjadi milik operator. Konvensi permukaan vendor yang menjadi sandaran adapter dipatok di src/apothem/harnesses/glm/STANDARD-CONVENTION-PIN.md, yang di-snapshot terhadap dokumentasi Z.ai yang berlaku.

GLM menjalankan keluarga model GLM dari Z.ai; lihat referensi konfigurasi vendor untuk permukaan konfigurasi backend, model, dan kompatibel-Anthropic yang terkini.

Verifikasi

apothem verify --harness glm --project /path/to/project

Perintah verify memastikan bahwa:

  1. Konfigurasi native ada di jalur yang diharapkan.
  2. Berkas penyedia ada dan tidak kosong.
  3. Rutin verifikasi khusus adapter melaporkan keberhasilan.

Pembaruan

apothem update --harness glm --project /path/to/project

Berkas penyedia menjadi milik Anda begitu berkas itu ada. install dan update sama-sama menulis templat hanya ketika .apothem/providers/glm.toml tidak ada, dan keduanya tidak pernah menimpanya setelah itu, sehingga referensi kunci dan pilihan model Anda bertahan pada setiap eksekusi ulang. Untuk mengambil templat yang lebih baru, pindahkan berkas Anda ke tempat lain, jalankan update, lalu salin nilai-nilai Anda ke berkas yang baru.

Pencopotan

apothem uninstall --harness glm --project /path/to/project

Menghapus berkas penyedia hanya ketika Apothem yang membuatnya dan berkas itu masih berupa templat yang belum disunting, dengan terlebih dahulu mencadangkannya di bawah akar cadangan Apothem. Berkas yang belum disunting dan ditulis oleh rilis sebelumnya ikut terhitung ketika catatan instalasi Apothem untuk proyek tersebut menunjukkan bahwa Apothem yang menulis berkas itu: manifes mencatat digest setiap templat yang pernah dikirimkan ke proyek. Tanpa catatan instalasi, hanya salinan persis dari templat saat ini yang dihapus. Berkas yang Anda buat atau sunting dibiarkan di tempatnya. YAML profil bersama dan mesin Apothem tidak terpengaruh.

Gerbang konformitas

python -m apothem.conformity.gate --all .

Pemecahan masalah

GejalaPerbaikan
Berkas konfigurasi tidak ditemukanJalankan ulang apothem install --harness glm --project /path/to/project
Verifikasi gagalBerkas penyedia hilang atau kosong. Jika berkas hilang, jalankan apothem update --harness glm --project /path/to/project. Jika berkas kosong, pindahkan .apothem/providers/glm.toml ke tempat lain terlebih dahulu, lalu jalankan update dan verifikasi lagi
Konten konfigurasi tidak terdugaSunting .apothem/providers/glm.toml secara langsung; Apothem tidak pernah menulis ulang berkas yang sudah ada, dan profil bersama tidak menambahkan apa pun ke dalamnya. Untuk templat yang baru, pindahkan berkas ke tempat lain lalu jalankan apothem update --harness glm --project /path/to/project

Tombol konfigurasi

FlagDefaultDeskripsi
--dry-runfalsePratinjau instalasi tanpa menulis berkas.

Lihat juga

On this page