Urus penyesuai dan model

Panduan ini menunjukkan cara menyambungkan penyedia model dan memilih apa yang dijalankan oleh ejen.

Semua ini terletak pada satu halaman: Tetapan → Pelayan → Penyedia model. Entri sub-bar sisi berbunyi “Penyedia model”; tajuk halaman berbunyi “Penyesuai”.

Apa itu penyesuai

Penyesuai ialah pelari yang melaksanakan giliran ejen. Terdapat dua dan senarainya tetap — anda tidak boleh menambah yang ketiga.

Penyesuai	CLI	Pengangkutan
Control Center (built-in)	tiada	Gelung ejen dalam proses, bercakap dengan penyedia melalui HTTP
Claude Code	claude	claude -p --output-format stream-json

Cursor, Codex, Anthropic, OpenAI dan yang lain ialah penyedia pada penyesuai terbina, bukan CLI yang berasingan. Apa yang boleh anda tambah ialah penyedia lain — mana-mana titik akhir yang serasi OpenAI atau Anthropic. Itulah bahagian seterusnya.

Pengesanan menyiasat pelayan, bukan mesin anda

Kad Pelari dikesan menyenaraikan apa yang cc_server jumpai pada PATH hos pelayan. Pada klien nipis atau web, itu mesin yang berbeza daripada mesin yang anda sedang lihat. Pasang CLI itu pada mesin yang menjalankan cc_server.

Sambungkan penyedia model

Penyesuai terbina memerlukan sekurang-kurangnya satu penyedia yang disambungkan sebelum ia boleh berjalan. Empat belas disertakan dalam katalog.

1. Pergi ke Tetapan → Pelayan → Penyedia model
2. Tatal ke Penyedia & model
3. Cari penyedia anda dan sambungkannya:

Penyedia	Cara menyambung
Anthropic	Kunci API. Langganan Claude Pro/Max bukan log masuk API Anthropic — gunakan penyesuai Claude Code untuk pelan itu
OpenAI, Codex, Cursor	Log masuk OAuth penyemak imbas, atau kunci API. Codex ialah ChatGPT Plus/Pro melalui bahagian belakang Codex Responses, bukan spawn CLI
Kimi Code	OAuth penyemak imbas sahaja — aliran kod peranti. Ia pelan kadar rata, jadi ia tiada harga per token
OpenRouter, Google Gemini, DeepSeek, Mistral, xAI, z.ai, z.ai GLM Coding Plan, Moonshot (Kimi API)	Kunci API

Titik semak: lencana baris itu bertukar menjadi disambungkan dan apabila dikembangkan ia menyenaraikan model yang disajikan oleh penyedia itu, setiap satu dengan harga per juta token dan tetingkap konteksnya.

Token OAuth disimpan dalam stor kelayakan pelayan sendiri dan diperbaharu sebelum tamat tempoh. Kelayakan penyedia adalah global hos — ia dikongsi oleh setiap ruang kerja dalam pemasangan itu, bukan diskop kepada satu.

Tambah penyedia tersuai

Gunakan ini untuk Ollama, LM Studio, vLLM atau penerapan persendirian.

1. Dalam Penyedia & model, di bawah Penyedia tersuai, tekan Tambah penyedia
2. Isi Nama, pilih Jenis API (serasi OpenAI atau serasi Anthropic) dan berikan URL asas (contohnya http://localhost:11434/v1)
3. Tambah Kunci API jika titik akhir itu memerlukannya, kemudian tekan Tambah penyedia

Penyedia tersuai muncul dalam senarai yang sama, dengan butang padam yang tiada pada penyedia terbina yang lain.

Pilih model untuk ejen

1. Pergi ke Tetapan → Ruang kerja → Ejen dan pilih ejen itu
2. Pada tab Tetapan, pilih penyesuai
3. Pilih model daripada menu lungsur di sebelahnya

Untuk penyesuai terbina, menu lungsur itu dibina secara langsung daripada katalog setiap penyedia yang disambungkan. Penyedia yang tiada kelayakan tersimpan menyumbang sifar model, sebab itulah menu lungsur yang kosong hampir selalu bermaksud “tiada apa yang disambungkan lagi” dan bukannya “tiada apa yang tersedia”.

models.dev ialah pengayaan, bukan sumber id

Katalog models.dev yang disertakan membekalkan harga dan tetingkap konteks untuk model yang sudah ada dalam senarai langsung. Ia tidak pernah menambah id model. Jika model yang anda jangkakan tiada, titik akhir penyedia itu tidak mengembalikannya.

Id model untuk penyesuai terbina dinyatakan sebagai provider/model dan mungkin membawa rantaian sandaran yang dipisahkan |. Di bawah sandaran, kos dikira berdasarkan model yang sebenarnya menyajikan giliran itu, bukan model yang anda minta.

Ejen tanpa penyesuai berjalan pada gelung terbina

Setiap ruang kerja membenihkan lima ejen — seorang CEO serta qa, architect, engineer dan librarian — tanpa penyesuai dan tanpa model. Penghantaran jatuh kembali kepada Control Center (built-in), bukan kepada tetapan Pelari lalai pada halaman ini, yang merupakan keutamaan klien yang tidak pernah dibaca oleh laluan penghantaran. Log larian merekodkan cc-harness bagi larian tersebut, jadi transkrip menamakan apa yang sebenarnya berjalan.

Dengan tiada model juga, gelung terbina meminta model lalai daripada Anthropic. Ejen yang dibiarkan tanpa tetapan sepenuhnya akan berjalan jika anda telah menyambungkan akaun Anthropic, dan jika tidak ia gagal dengan No credential for provider "anthropic".

Menamatkan langkah penyesuai dalam pengenalan menampal semula setiap ejen yang masih tiada penyesuai atau model — CEO dan pakar, merentas setiap ruang kerja yang wujud pada masa itu — dengan pasangan yang anda pilih. Ruang kerja yang dicipta kemudian masih membenihkan kelima-limanya tanpa tetapan. Tetapkan penyesuai dan model secara eksplisit pada setiap ejen yang anda ingin gunakan.

Pasang CLI pelari

Penyesuai terbina tidak memerlukan pemasangan. Untuk Claude Code, pasang CLI-nya pada hos pelayan dengan pengurus pakej alat itu sendiri, contohnya:

npm install -g @anthropic-ai/claude-code

Kemudian tekan Muat semula di bahagian atas halaman. Setiap baris yang dikesan menunjukkan versi dan laluan yang diselesaikan, serta cip sama ada ia menyokong modus JSON dan pemilihan model.

CLI luaran menyimpan kelayakannya sendiri, dalam konfigurasinya sendiri, pada hos pelayan. Control Center tidak mengurusnya.

Argumen dan pemboleh ubah persekitaran penyesuai kekal pada peranti ini

Setiap baris penyesuai menawarkan medan Argumen tambahan dan dialog Pemboleh ubah persekitaran. Nilai tersebut disimpan pada peranti anda. Pelayan membaca argv pelancaran dan env daripada stor tetapannya sendiri. Letakkan kunci penyedia pada pelayan (OAuth atau medan kunci pada halaman Penyedia model), bukan dalam kedua-dua medan itu.

Hadkan penyedia yang boleh digunakan oleh sesuatu ruang kerja

Tadbir urus penyedia adalah bagi setiap ruang kerja dan dinilai dengan padanan terakhir menang.

1. Dalam Penyedia & model, matikan suis Benarkan pada baris penyedia

Itu menulis kenyataan deny bagi penyedia tersebut dalam ruang kerja aktif dan modelnya terkeluar daripada katalog untuk ruang kerja itu. Menghidupkan suis semula membuang kenyataan itu.

Penyelesaian masalah

Pelari ditunjukkan sebagai tidak dijumpai

• Pastikan CLI itu ada pada PATH hos pelayan, bukan hanya PATH anda
• Aplikasi desktop yang dilancarkan melalui GUI memulakan pelayannya dengan PATH yang minimum; CLI yang dipasang di bawah laluan khusus shell mungkin tidak kelihatan kepadanya
• Tekan Muat semula selepas memasang

Menu lungsur model kosong

• Penyesuainya ialah penyesuai terbina dan tiada penyedia disambungkan — sambungkan satu dalam Penyedia & model
• Atau penyedia itu disambungkan tetapi ditolak oleh suis tadbir urus ruang kerja ini

Model berjalan tetapi harga ditunjukkan sebagai tidak diketahui

Senarai model langsung membawa id itu; harga dan konteks datang daripada models.dev. Model yang baharu sepenuhnya, atau model daripada penyedia tersuai, belum ada entri katalog.

Panduan berkaitan

• Cipta dan konfigurasikan ejen
• Urus kunci API
• Diagnosis ejen
• Urus kos

Konsep berkaitan

• Model ejen
• Kitaran hayat penghantaran ejen