Cara bina ejen AI guna Claude pada VPS

Apa maksud membina ejen dengan Claude

Membina ejen dengan Claude bermaksud menggunakan Claude sebagai teras penaakulan manakala gelung (loop), alatan, dan data berada pada pelayan anda sendiri. Claude memutuskan apa yang perlu dilakukan; VPS anda melaksanakannya. Anda menghantar tugasan dan keadaan semasa kepada Claude, Claude membalas dengan jawapan atau permintaan untuk menggunakan salah satu alatan anda, kod anda menjalankan alatan tersebut dan menghantar semula hasilnya, dan gelung berterusan sehingga kerja selesai. Kecerdasan tersebut adalah perkhidmatan yang anda panggil melalui internet. Segala-galanya di sekelilingnya adalah milik anda.

Pembahagian ini adalah daya tarikannya. Anda mendapat penaakulan tahap tinggi tanpa perlu mengendalikan model, dan anda mengekalkan kawalan penuh terhadap apa yang boleh disentuh oleh ejen, kerana alatan dijalankan pada perkakasan milik anda. Jika anda telah membina program Claude yang pertama, panduan aplikasi Claude pertama pada VPS merangkumi asas yang dibina oleh panduan ini.

Claude adalah otak: Messages API

Setiap panggilan ke Claude melalui satu titik akhir (endpoint), iaitu Messages API. Anda menghantar perbualan setakat ini dan senarai alatan yang boleh digunakan oleh ejen; Claude menghantar semula mesej seterusnya. Mesej itu sama ada jawapan akhir atau permintaan untuk memanggil alatan. Untuk laluan bina sendiri, tiada "agent API" yang berasingan: penggunaan alatan adalah ciri bagi titik akhir tunggal ini, dan gelung di sekelilingnya adalah untuk anda jalankan.

Claude adalah tanpa keadaan (stateless) antara panggilan, bermaksud ia tidak mengingati apa-apa secara sendiri. Setiap permintaan membawa keseluruhan perbualan. Kod anda memegang sejarah dan menghantarnya pada setiap pusingan, yang merupakan sebab setiap pusingan dalam sesi panjang menelan lebih banyak token daripada pusingan sebelumnya. Itu bukanlah satu had tetapi pilihan reka bentuk: kerana keadaan (state) berada pada pelayan anda, anda menentukan dengan tepat apa yang dilihat oleh Claude, dan tiada apa tentang tugasan itu disimpan di mana-mana tempat yang tidak anda kawal.

Penggunaan alatan adalah gelung ejen

Gelung ejen dengan Claude mudah untuk diterangkan. Anda menghantar permintaan yang menyertakan alatan anda. Claude membaca tugasan dan, jika ia perlu bertindak, membalas dengan permintaan penggunaan alatan yang menamakan alatan dan mengisi inputnya. Kod anda menjalankan alatan tersebut, kemudian menghantar semula hasilnya kepada Claude dalam permintaan seterusnya. Claude membaca hasil tersebut dan sama ada meminta alatan lain atau menulis jawapan akhirnya. Apabila ia berhenti meminta alatan, tugasan selesai.

Anda boleh menulis gelung tersebut secara manual dalam beberapa baris, dan ramai orang melakukannya, kerana ia mudah dilihat dan mudah dikawal. SDK rasmi juga menyediakan pelari alatan (tool runner) yang menggerakkan gelung untuk anda: anda membekalkan fungsi alatan, dan SDK mengendalikan proses panggilan Claude, menjalankan alatan anda, dan menghantar semula hasil sehingga Claude selesai. Dalam kedua-dua cara, bentuknya adalah sama. Pelari tersebut hanya menjimatkan masa anda daripada menulis gelung itu sendiri.

Tiga cara untuk membina, dan mana yang sesuai untuk VPS

Terdapat tiga cara untuk membina ejen Claude, dan ia berbeza dari segi jumlah mesin yang anda jalankan.

Pertama ialah kod anda sendiri yang memanggil Claude API dengan alatan anda sendiri. Anda menulis gelung, atau menggunakan pelari alatan SDK, dan anda menghoskan keseluruhan perkara tersebut pada VPS anda. Ini adalah pilihan biasa, kerana ia memberi anda kawalan penuh ke atas alatan, data, dan keselamatan, serta ia berjalan sebagai program biasa pada pelayan anda. Kebanyakan panduan ini mengandaikan laluan ini.

Kedua ialah Claude Agent SDK. Ini adalah Claude Code, ejen pengekodan, yang dibungkus sebagai perpustakaan yang boleh anda bina. Ia menyediakan gelung ejen penuh dan alatan terbina dalam untuk membaca dan menulis fail, menjalankan arahan shell, dan mencari, supaya anda tidak perlu memasangnya dari awal. Ia juga berjalan pada pelayan anda sendiri, menjadikannya sangat sesuai untuk VPS apabila anda mahukan ejen fail-dan-shell yang berkemampuan tanpa membina kerangka kerja itu sendiri. Ejen yang membaca fail dan menjalankan arahan shell memerlukan kawalan sebelum ia boleh berfungsi tanpa pengawasan, dan menjalankan Claude Code dengan selamat pada pelayan merangkumi sistem kebenaran, sandbox, dan pilihan pengasingan.

Ketiga ialah Managed Agents, di mana Anthropic menjalankan gelung dan menghoskan sandbox di mana alatan ejen dilaksanakan. Ini adalah pilihan tanpa pengurusan: terdapat jauh lebih sedikit perkara untuk anda kendalikan, tetapi ruang kerja ejen berada pada infrastruktur Anthropic dan bukannya pada VPS anda. Gunakan ini apabila anda mahukan kerja operasi yang paling sedikit dan tidak memerlukan alatan dijalankan pada mesin anda sendiri. Untuk dua yang lain, pelayan anda adalah rumah bagi ejen, yang merupakan fokus baki panduan ini.

Menghubungkan alatan dengan MCP

Mana-mana laluan yang anda pilih, anda akan mahu menghubungkan ejen ke sistem sebenar, dan Model Context Protocol adalah cara yang kemas untuk melakukannya. MCP ialah piawaian terbuka untuk mendedahkan alatan dan data kepada ejen. Daripada menulis integrasi secara manual untuk setiap perkhidmatan, anda mengarahkan Claude ke pelayan MCP yang sudah membentangkan keupayaan tersebut sebagai alatan. Anda boleh menjalankan pelayan MCP sebagai perkhidmatan kecil pada VPS yang sama, setiap satu dengan akses yang diperlukan sahaja, yang saya bincangkan dalam menjalankan pelayan MCP pada VPS.

Memilih model

Claude hadir dalam beberapa model, dan memilih satu adalah pertukaran antara keupayaan, kelajuan, dan kos. Setakat penulisan ini, pilihan arus perdana ialah Claude Opus 4.8 (claude-opus-4-8), pilihan lalai yang berkemampuan untuk penaakulan sukar dan larian ejen yang panjang; Claude Sonnet 5 (claude-sonnet-5), pilihan seimbang yang lebih murah dan lebih cepat sambil kekal hampir dengan Opus dalam banyak tugasan; dan Claude Haiku 4.5 (claude-haiku-4-5), yang terpantas dan termurah, untuk langkah ringkas dan volum tinggi. Di atas mereka terdapat Claude Fable 5 (claude-fable-5), model yang paling berkemampuan, untuk kerja yang paling menuntut. Gunakan pengecam model yang tepat dalam kod anda, tanpa menambah tarikh padanya.

Corak yang praktikal adalah dengan mencampurkannya. Biarkan model yang lebih murah mengendalikan panggilan alatan rutin dan model yang lebih kuat mengendalikan keputusan yang sukar. Oleh kerana model hanyalah satu rentetan (string) dalam permintaan anda, penukaran hanyalah perubahan satu baris, jadi mulakan dengan pilihan lalai yang berkemampuan dan laras ke bawah di mana kelajuan atau kos lebih penting daripada kualiti terakhir.

Jalankan sebagai perkhidmatan yang diperkukuh pada VPS anda

Ejen hanya berguna jika ia terus berjalan, dan ia hanya selamat jika ia dikawal. Pada VPS, kedua-duanya datang daripada menjalankan ejen sebagai perkhidmatan sistem yang diperkukuh dan bukannya program yang anda mulakan secara manual dalam terminal. Sebagai perkhidmatan, ia bermula semasa but, bermula semula jika ia terhenti (crash), dan merekod log ke dalam journal. Apabila diperkukuh, ia berjalan sebagai pengguna tanpa keistimewaan dengan hanya akses yang diperlukan, supaya pepijat atau arahan yang salah mempunyai had.

Peraturan yang paling penting ialah simpan kunci Claude API anda di sebelah pelayan (server-side). Kunci tersebut membayar dan memberi kuasa kepada setiap panggilan, jadi ia harus berada dalam fail yang hanya boleh dibaca oleh pengguna ejen, dimuatkan ke dalam perkhidmatan sebagai pemboleh ubah persekitaran (environment variable), dan tidak sekali-kali diletakkan dalam kod, dalam repositori, atau di mana-mana tempat yang boleh dicapai oleh pelayar. Jana unit perkhidmatan yang lengkap dan diperkukuh untuk ejen anda di sini:

Kemudian selesaikan pelayan itu sendiri. Gunakan kunci sahaja untuk SSH dan kunci akaun yang anda uruskan, seperti dalam pengukuhan SSH pada VPS. Jika anda lebih suka mengendalikan ejen daripada sesi interaktif semasa anda membinanya, menjalankan Claude Code pada VPS dengan tmux adalah teman yang baik. Dan jika anda mahukan konsep di sebalik semua ini, tanpa mengikatnya pada satu model, panduan saudara tentang membina ejen AI anda sendiri pada VPS membentangkan asas-asasnya.

Jika pembantu pengekodan terminal adalah apa yang anda mahukan, menjalankan ejen AI pengekodan pada VPS merangkumi Aider dan Goose.

FAQ

Model Claude manakah yang patut saya gunakan untuk membina ejen?

Mulakan dengan Claude Opus 4.8 (claude-opus-4-8), pilihan lalai yang berkemampuan, dan laras dari situ. Claude Sonnet 5 (claude-sonnet-5) adalah lebih murah dan lebih cepat untuk kebanyakan kerja, Claude Haiku 4.5 (claude-haiku-4-5) adalah yang terbaik untuk langkah volum tinggi yang ringkas, dan Claude Fable 5 (claude-fable-5) adalah yang paling berkemampuan untuk tugasan yang paling sukar. Corak biasa adalah menggunakan model yang lebih murah untuk langkah rutin dan model yang lebih kuat untuk keputusan yang sukar, memandangkan penukaran hanyalah perubahan satu baris.

Adakah saya menjalankan keseluruhan ejen pada VPS saya, atau Anthropic?

Ia bergantung pada pendekatan. Jika anda menulis gelung anda sendiri terhadap Claude API, atau menggunakan Claude Agent SDK, ejen berjalan sepenuhnya pada VPS anda dan hanya panggilan model sahaja dihantar ke Anthropic. Jika anda menggunakan Managed Agents, Anthropic menjalankan gelung dan menghoskan sandbox di mana alatan dilaksanakan, jadi lebih sedikit bahagian yang berada di pelayan anda. Untuk ejen yang berjalan pada mesin anda sendiri, gunakan salah satu daripada dua yang pertama.

Apakah perbezaan antara Claude API dan Claude Agent SDK?

Claude API ialah titik akhir Messages yang mentah: anda menghantar perbualan dan alatan, dan anda menulis gelung ejen di sekelilingnya, atau gunakan pelari alatan SDK untuk menggerakkannya. Claude Agent SDK ialah perpustakaan tahap lebih tinggi, Claude Code yang dibungkus untuk dibina, yang menyediakan gelung penuh dan alatan fail, shell, dan carian terbina dalam. Gunakan API apabila anda mahu menentukan semuanya sendiri, dan gunakan Agent SDK apabila anda mahukan ejen yang berkemampuan tanpa memasang kerangka kerja tersebut.

Bagaimanakah saya memastikan kunci Claude API saya selamat pada pelayan?

Simpan ia di sebelah pelayan dan di luar kod anda. Simpan ia dalam fail yang hanya boleh dibaca oleh akaun yang menjalankan ejen, muatkannya ke dalam perkhidmatan sebagai pemboleh ubah persekitaran, dan jangan sesekali melakukan commit ke dalam repositori atau mendedahkannya kepada pelayar. Oleh kerana setiap permintaan ke Claude dihantar dari pelayan anda, kunci tersebut tidak perlu sampai ke peranti pengguna, yang menjadikan ejen yang dijalankan pada pelayan lebih mudah untuk diamankan berbanding ejen yang tertanam dalam aplikasi klien.

Adakah saya perlu menghoskan sendiri model untuk membina ejen dengan Claude?

Tidak. Dengan Claude, model adalah perkhidmatan hos yang anda panggil melalui API, jadi tiada apa yang perlu dijalankan pada GPU. VPS anda menjalankan gelung ejen, alatan, dan data, dan penaakulan berlaku di pihak Anthropic. Itulah yang membolehkan pelayan biasa menjalankan ejen yang berkemampuan. Jika anda mahukan model tempatan sepenuhnya sebagai ganti, itu adalah laluan hos sendiri yang dibincangkan dalam panduan teman tentang membina ejen AI anda sendiri.