智能体调用命令行时，不要把模型输出拼成整条命令。固定可执行程序，参数使用列表传入，并设置超时与退出码检查，才能更清楚地区分数据和命令。
给智能体开发本地命令工具的开发者。本文使用 Python 3.11 或以上版本的标准库，先验证一组人工构造的小样本。AI 负责提出实现或解释差异，结果由本地检查决定；这里没有把模型回答当成真实运行结果。
保持命令行参数原样传递前，先定规则
示例把包含空格、分号和$()的字符串传给子进程。子进程只打印argv，不处理文件、不调用网络，也不解释这些字符。
shell=False减少shell解释，但不意味着所有参数都安全。被调用程序仍可能把参数当开关、脚本或表达式解释，所以还需工具级参数白名单。
Python使用sys.executable保证子进程来自当前环境，避免PATH上另一个同名程序。真正工具应固定程序路径与允许参数。
给 AI 的输入要包含什么
把下面这份输入说明和你的实际样本一起交给可用的 AI 编程助手。示例只含虚构数据；对真实材料先去除账号凭据和个人信息。
实现只允许启动当前Python打印argv的演示工具。subprocess.run传参数列表，shell=False，check=True，timeout=5，捕获stdout。特殊字符必须原样，不允许模型提供可执行路径和任意-c内容。要求模型保留检查条件，并把它认为缺少的业务定义列出来。若回答改变了输入字段、忽略异常分支或直接删除原材料，先要求修正，再运行。提示词的作用是缩小任务范围，验收仍以代码和数据为准。
保存并运行最小验证程序
下方程序把关键规则和验证用例放在同一个可复跑示例中，便于先理解输入如何变成输出，再用它检查 AI 给出的实现。
新建一个空目录，把下面代码保存为 check.py，在该目录打开终端，运行 python -X utf8 check.py。代码自带示例输入，不需要安装第三方库。
import subprocess, sys, json
value='name with spaces; $(should_not_execute)'
fixed_code='import sys,json; print(json.dumps(sys.argv[1:],ensure_ascii=False))'
done=subprocess.run([sys.executable,'-c',fixed_code,value],shell=False,check=True,timeout=5,capture_output=True,text=True,encoding='utf8')
args=json.loads(done.stdout)
assert args==[value]
assert done.returncode==0
print('literal_argument',args[0])
print('exit_code',done.returncode)怎样判断结果符合要求
literal_argument应与输入逐字符一致，包括空格、分号与$()。退出码为0只是打印工具成功，不能据此认定其它业务动作成功。
下方是这份最小示例在本地执行得到的输出。它验证示例程序与断言的关系，不代表任何 AI 模型一次就能生成同样代码，也不构成性能或生产可靠性结论。
literal_argument name with spaces; $(should_not_execute)
exit_code 0示例中的-c代码是开发者固定文字，不能由模型或用户替换。若把它开放为输入，仍是任意代码执行。
错误退出时check=True会产生异常；工具应保留失败状态与诊断，不能返回“已完成”。
哪些失败必须停下来处理
shell=False不能防止被调程序自身的参数注入，例如文件名以-开头被识别成选项。按程序文档使用终止选项标记或拒绝歧义参数。
超时后需处理子进程树与资源，生产长任务另建受控执行器，不照搬五秒示例。
接入自己的任务前再核对一次
把程序、参数类型、可访问目录和允许动作定义在工具契约里，AI只提交符合契约的值。
对写文件或外部写入增加预览、确认与结果核验，按现有系统权限规则执行。
资料与适用范围
subprocess.run可使用参数序列并检查退出码、超时和标准输出；shell调用增加解释规则。以下链接核对于 2026-10-03；运行环境及额外依赖按本文前述说明。
相关基础可阅读 Claude Code 权限怎么配置？用 allow、ask、deny 控制命令和文件。本文的重点是保持命令行参数原样传递，可以把两项检查作为不同步骤保留。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/33367.html
