用途：在智能体机器上本地运行 Kody execute 模块，默认使用 @kodycodes/cli execute --local，托管 MCP execute 作为回退。公开文档见 https://kody.codes/docs/open-api。
优先本地条件：Node.js ≥ 22 可用；可运行 @kodycodes/cli（npx 亦可）；可通过 kody login 和/或 KODY_API_TOKEN 完成认证；任务不依赖托管云 workerd。
本地认证优先级：--token / KODY_API_TOKEN（作用域 kody_at_…，常见于 CI 与 Cloud Agents）；否则使用 kody login 存储的 CLI MCP OAuth 访问令牌（交互式智能体默认）；两者皆无则报“login or provide a token”错误。kody login 后无需为本地执行铸造临时 API 令牌。
使用托管 MCP execute 的情形：机器无 Node/CLI；模块必须在 Kody 云 workerd 运行；既无法登录也无令牌。
功能开关：Open API 与本地执行需要 mcp-api-tool 和 local-execute（实验队列或按用户在文档页选择加入），否则 --local 不可用。
本地运行示例：kody login 后执行 npx @kodycodes/cli execute --local --code 'export default async function main() { return await kody.metaGetCurrentUser({}) }'。使用登录 OAuth 时省略 --token；已有作用域令牌时优先用环境变量 KODY_API_TOKEN 而非 --token，避免密钥出现在进程参数中；--file 与 --code 用法相同，适合较长模块。
仅限 CI/无头环境铸造令牌：当无法交互登录时，调用 MCP api（或 Open API）的 tokenCreate，参数 name 为 kody-cli，scopes 含 local-execute、account:read，并按需添加其他作用域（如 packages:read）。令牌值仅返回一次，存为 KODY_API_TOKEN 或传 --token，切勿粘贴到聊天中；短期令牌用完后通过 MCP api tokenRevoke 撤销。
计量：本地 CPU 不计入 execute 或 dynamic_worker_day；通过代理调用的能力仍正常计量。
云智能体：优先在云环境预置 KODY_API_TOKEN 密钥/环境变量；桌面智能体应使用 kody login + execute --local（省略 --token），不要以交互式铸造为首选路径。若云密钥缺失且 MCP api 可为会话铸造，则铸造后导出到 shell 且不要回显；两条路径都不可用时回退到托管 MCP execute。