Start a ZCode subagent task
zcode_runDelegate a self-contained task to a background GLM subagent in the ZCode desktop app and get a taskId immediately; then block or poll for the finished result.
Instructions
Delegate a task to a GLM subagent running in the official ZCode desktop app (uses the user's GLM Coding Plan quota). Returns a taskId immediately; the task runs in the background. Use zcode_wait to block until it finishes, or zcode_status to poll. The subagent runs with FULL ACCESS (shell, file read/write anywhere the OS user can) in the project folder /root/projects/subagents. It cannot see this conversation, so put ALL needed context in the prompt: goal, absolute file paths, constraints, and the exact output format you want back. Prefer small, well-scoped tasks. Several tasks may run in parallel (limit 3). Models: GLM-5.3 | GLM-5.3-Flash (default GLM-5.3; Flash is faster and cheaper for simple work). provider picks the billing route (the model menu lists the same names under both): account%3Abigmodel-individual-coding-plan = BigModel 个人 (default), account%3Abigmodel-start-plan = Start Plan 免费.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "zcode_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Model to use. Default GLM-5.3. | |
| prompt | Yes | Complete, self-contained task description. | |
| provider | No | Billing route (provider). Default account%3Abigmodel-individual-coding-plan = BigModel 个人; account%3Abigmodel-start-plan = Start Plan 免费 (the decoded form account:… works too). Others are refused. |