محیط توسعه رسمی Z.ai برای کارهای Agentic روی پروژههای واقعی است.
اکوسیستم Z.ai
ZCode
ZCode برای planning، coding، review و deploy ساخته شده است.
محیط توسعه Agentic رسمی برای GLM-5.2 و workflowهای طولانی
خلاصه عملی
تعریف و شروع
ZCode چیست؟
ZCode محیط توسعه Agentic رسمی برای کار با GLM-5.2 و مدلهای GLM در workflowهای planning، coding، review و deploy است.
- فایل رسمی ZCode
- workspace پروژه
workspace را انتخاب کن و از Connect برای اتصال به Z.ai، BigModel یا Use API Key استفاده کن.
انتخاب عملی
چه زمانی از ZCode استفاده کنیم؟
برای workflowهای طولانی و agentic که context و command تکرارشونده دارند.
- taskهای طولانی coding با context زیاد
- refactor چندفایلی
- review و diff inspection
- پروژههایی که به goal mode نیاز دارند
- workflowهایی که command/skill تکرارشونده دارند
- کار با GLM Coding Plan و GLM-5.2
دستورها
Commandها و triggerهای داخل ZCode
از اینها برای باز کردن command panel، دادن context و رفتن سریع به actionها استفاده کن.
| دستور | توضیح |
|---|---|
| / | باز کردن command panel. از اینجا commandها و skillها را میبینی و با تایپ بیشتر filter میکنی. |
| /goal | نمایش، تنظیم، جایگزینی، pause/resume یا پاککردن goal فعلی session. برای long-running task استفاده میشود. |
| /compact | فشردهکردن context گفتگو با حفظ نکات مهم. برای ادامه taskهای طولانی کاربرد دارد. |
| $ | فراخوانی Skillها. میتوانی Skill را با $ صدا بزنی یا از Skills group داخل پنل / انتخاب کنی. |
| @ | اشاره به فایلهای workspace برای دادن context دقیق به Agent. |
| # | وصلکردن conversation قبلی به task فعلی. |
| + | اضافهکردن attachment، فایل، context یا action از منوی input. |
| Command Center | Windows/Linux: Ctrl + K. macOS: Command + K. برای رفتن سریع به actionها، فایلها، تنظیمات، MCP servers، theme، terminal و navigation. |
قابلیتها
قابلیتهای اصلی
ساخت command سفارشی
Commandهای تکراری را به فرمانهای قابل صدا زدن تبدیل کن.
- Settings را باز کن.
- وارد Commands شو.
- New command بساز.
- Scope را انتخاب کن: User یا Workspace.
- Name را طوری بگذار که بعدا با /command-name صدا زده شود.
- Description کوتاه بنویس.
- Argument hint را فقط اگر لازم است اضافه کن، مثل <file-path>.
- Prompt را بهعنوان دستور تکرارشونده تعریف کن.
- commandهای user-level در ~/.zcode/commands ذخیره میشوند.
- commandهای workspace-level داخل پروژه ذخیره میشوند.
نکات امنیتی
کلیدها را در client-side code نگذار و قبل از deploy review کن.
- API key را داخل client-side code نگذار.
- Team Plan key را commit نکن.
- برای repo عمومی از env/config امن استفاده کن.
- قبل از deploy، diff و commandهای اجراشده را review کن.
Endpointهای Coding Plan
فقط endpointهای رسمی Coding Plan را برای اتصال نگه دار.
- Anthropic protocol: https://api.z.ai/api/anthropic
- OpenAI Chat Completions protocol: https://api.z.ai/api/coding/paas/v4
شروع
نصب ZCode
فایل رسمی ZCode را برای سیستمعامل خود دانلود و نصب کن.
macOS
فایل dmg رسمی را از سایت ZCode دانلود کن.
دانلود رسمی ZCode برای macOSرفع خطای quarantine در macOS
xattr -dr com.apple.quarantine /Applications/ZCode.appWindows
installer رسمی Windows x64 را از سایت ZCode دانلود و اجرا کن.
دانلود رسمی ZCode برای WindowsLinux
نسخه Linux طبق docs در beta است؛ package رسمی را از سایت ZCode بگیر.
دانلود رسمی ZCode برای Linuxاجراییکردن package در صورت نیاز
chmod +x ./ZCode*مثال
مثال واقعی
ZCode
محیط توسعه Agentic رسمی برای GLM-5.2 و workflowهای طولانی
- taskهای طولانی coding با context زیاد
- refactor چندفایلی
- review و diff inspection
ZCode برای planning، coding، review و deploy ساخته شده است.
خطاهای رایج
اشتباهات رایج
مرز محصول و API را روشن نگه دار
این component یک لایه مشخص در اکوسیستم است، نه کل اکوسیستم.
اول یک workflow کوچک بساز
بهجای مسیرهای پیچیده، با یک task کوچک و واقعی شروع کن.
لینک رسمی را جایگزین implementation نکن
docs مرجع هستند، اما باید در محصول خودت هم تست شوند.
رسمی
لینکهای رسمی
اکوسیستم