Qoder、QoderCLI、QoderWork 等 Agent 运行时面临提示词注入、敏感数据泄露、恶意指令执行等安全风险，仅依赖模型自身能力难以有效防护。本文介绍如何通过 AI 安全护栏，以 Qoder 原生插件方式构建运行时安全防护能力，在用户输入和模型输出环节实时检测与拦截潜在威胁，保障 Agent 安全可控地运行。
方案概述
Qoder 系列是企业级编码 Agent 产品，包含 Qoder（IDE 插件）、QoderCLI（命令行工具）和 QoderWork（桌面工作台）等系列平台，支持通过自然语言指令调用大模型完成编码任务。然而，实际运行时，编码 Agent 面临以下安全风险：
提示词注入（Prompt Injection）：攻击者通过精心构造的输入，操控模型输出恶意代码或执行未授权操作。
敏感数据泄露：模型可能在生成代码时意外暴露企业源码、API 密钥或内部接口地址等敏感内容。
恶意指令执行：攻击者诱导模型访问钓鱼链接、下载木马文件，威胁开发环境安全。
阿里云 AI 安全护栏提供针对Agent输入输出的防护能力，通过 Qoder 原生插件在用户输入（Prompt）和模型输出（Response）两个环节实时检测风险，拦截威胁请求。防护机制包括：
检测提示词注入：在请求发送至大模型前进行输入检测，识别提示词注入与越狱攻击，拦截被恶意构造的指令，防止模型被操控输出恶意代码或执行未授权操作。
检测敏感数据泄露：在输入环节对企业源码、API 密钥、内部接口地址等敏感信息进行脱敏处理，使真实敏感数据不进入模型侧；在输出环节检测响应中的敏感信息外泄并拦截。同时支持对脱敏内容进行还原，在不影响正常编码体验的前提下，避免敏感数据在传输与模型侧的暴露。
检测恶意指令执行：在模型响应返回给用户前进行输出检测，识别钓鱼链接、木马文件下载等恶意链接与危险内容并予以过滤，防止编码 Agent 被诱导执行威胁开发环境的操作。
前置准备
安装插件前，确保环境满足以下要求。
环境依赖
根据使用的编码 Agent 类型，确认已完成相应安装：
Agent 类型 | 安装要求 |
Qoder | 已安装 Qoder IDE 插件（企业版） |
QoderCLI | 已安装 QoderCLI 命令行工具 |
QoderWork | 已安装 QoderWork 桌面工作台 |
权限要求
需拥有阿里云账号，并具备 AI 安全护栏控制台的访问权限。
打包和下发插件需要企业管理员权限。
安装插件
Qoder/QoderCLI/QoderWork 三者的插件形态一致，通过 installer 脚本的 pack 命令统一打包为 Qoder 原生插件包，再执行以下步骤。
本流程涉及两类角色，分别有不同的安装方式。若您是企业管理员，建议选择统一下发安装，直接将插件下发至企业内目标用户；若您是个人开发者，可以选择个人自行安装：
企业管理员：执行步骤一至步骤七，其中步骤五执行方式一（管理员统一下发）。
个人开发者：执行步骤一至步骤七，其中步骤五执行方式二（个人自行安装）。
整体步骤如下：
授权安全插件调用 AI 安全护栏服务
确认和设置检测策略
获取安装凭据
打包插件包
安装插件
验证安装结果
测试防护效果
步骤一：授权安全插件调用 AI 安全护栏服务
登录 AI 安全护栏控制台，单击左侧导航栏的概览，在接入产品区域找到 Qoder，打开 Qoder 插件面板。
单击服务关联角色授权后的前往授权，并按提示完成授权。
步骤二：确认和设置检测策略
在 Qoder 插件面板的确认检测策略处，单击前往维护。
进入 agent_runtime_guard-配置 页面，根据需求调整防护维度。建议启用以下防护维度：
敏感信息检测：检测应用大模型时可能出现的个人/企业敏感信息，避免数据泄露。
提示词攻击检测：检测针对大模型设计的提示词操控，避免模型输出恶意内容或威胁系统安全。
恶意 URL 检测：检测大模型生成或解析内容中可能存在的钓鱼链接、木马网站等风险，防止数据泄露与安全入侵。
步骤三：获取安装凭据
在 Qoder 插件面板的获取安装命令处，复制安装凭据（--key 参数值）。
安装凭据有效期为 24 小时，过期后需从控制台重新获取。为防止凭据泄露，可单击刷新按钮重新生成。
步骤四：打包插件包
使用 installer 脚本的 pack 命令打包 Qoder 原生插件包。根据操作系统选择对应命令。
macOS/Linux
wget -q "https://update.aegis.aliyun.com/download/agent-security-installer/1.0.1/installer.sh" && chmod +x installer.sh && sudo ./installer.sh pack --key "<安装凭据>" --region "cn" --agent qoder --output ./coding-agent-security.zipWindows
Invoke-WebRequest -UseBasicParsing -Uri
"https://update.aegis.aliyun.com/download/agent-security-installer/1.0.1/installer.ps1"
-OutFile ".\installer.ps1" -ErrorAction Stop; powershell.exe
-NoProfile -ExecutionPolicy Bypass -File ".\installer.ps1" pack
--key "<安装凭据>" --region "cn" --agent qoder --output
".\coding-agent-security.zip"参数说明：
参数 | 必填 | 说明 |
| 是 | 目标 Agent 类型，目前值为： |
| 是 | 步骤三获取的安装凭据 |
| 否 | 插件包输出路径，默认在当前执行目录下生成 zip 文件 |
Qoder、QoderCLI、QoderWork 三者的插件包格式一致。
步骤五：安装插件
完成步骤四的打包后，根据部署场景和用户角色选择对应的安装方式。
安装方式一：管理员统一下发
由企业管理员在管理后台统一将插件下发给组织内成员，成员无需手动操作。
使用管理员账号登录 Qoder 企业版控制台（普通成员无此权限）。
进入扩展与市场 > 企业专属市场。
上传步骤四生成的
coding-agent-security.zip，后台自动解析插件名称和版本信息，确认无误后继续。设置下发范围（如全员下发或分组下发）与客户端策略（选择客户端可配置、强制开启或静默启用）。
确认后单击保存策略。下发成功后，组织成员在各自客户端的插件市场可看到并使用该插件。
安装方式二：个人自行安装
QoderCLI 和 QoderWork 用户可在获取已打包的插件包后自行安装。请先将插件包解压，得到插件目录（目录内包含 .qoder-plugin/plugin.json 等文件）。
QoderCLI
通过命令行安装解压后的插件目录（注意使用解压后的插件路径，而非 zip 文件路径）：
unzip coding-agent-security.zip
qodercli plugins install ./coding-agent-security
qodercli plugins listQoderWork
在客户端专家套件中导入本地插件：
打开专家套件（左侧导航上部入口），单击右上角安装套件。
点击从本地上传，指向下载的 zip 文件路径。
点击确认即可成功安装。
步骤六：验证安装结果
Qoder CLI用户执行以下命令查看已安装的插件列表，若输出的插件列表中包含 coding-agent-security 插件，说明安装成功。
qodercli plugins listQoder/QoderWork 用户，可打开客户端的插件管理界面，确认插件已安装并处于启用状态。
步骤七：测试防护效果
发送测试请求。
通过 Qoder/QoderCLI/QoderWork 发送包含敏感词或异常指令等风险内容的测试请求。
在控制台查看拦截日志。
登录 AI 安全护栏控制台，单击左侧导航栏的检测结果 > 结果查询。
在实时防护页签下，筛选 Service 为
agent_runtime_guard及相关时间条件，查看拦截日志。
步骤八：查看Agent防护状态
在控制台查看Agent防护状态。
登录 AI 安全护栏控制台，单击左侧导航栏的Agent风险观测 > Agent总览，在左侧 Agent列表切换至实时防护，即可查看所有已安装防护插件的Agent的离线和在线状态。
卸载插件
如不再需要使用 AI 安全护栏对 Qoder 系列编码 Agent 进行防护，可卸载插件。卸载将移除插件及其配置，防护立即失效。
卸载前建议：
在控制台确认当前无活跃防护策略。
确认业务流量已切换到其他防护方案。
管理员操作
在 Qoder 企业版控制台的企业专属市场页面，移除已下发的安全防护插件。移除后，目标用户的客户端将自动卸载该插件。
个人操作
QoderWork：在客户端专家套件中找到该安全防护插件，选择卸载 / 移除。
QoderCLI：用户执行以下命令完成插件卸载。
macOS/Linux
./install.sh uninstall --agent qodercliWindows
.\install.ps1 uninstall --agent qodercli故障排查
安装或验证过程中遇到问题时，参考以下排查表。
故障现象 | 可能原因 | 排查步骤 |
pack 命令执行失败 | installer 脚本缺失或无执行权限 | 确认 |
安装凭据无效或过期 | 返回控制台重新获取安装凭据，确认有效期内使用 | |
网络连接失败 | 检查网络连接，确保可访问阿里云 API | |
QoderCLI 安装失败 | 使用了压缩包路径而非目录路径 | 先将 |
QoderCLI 版本不兼容 | 升级 QoderCLI 到最新版本 | |
插件安装成功但未激活 | 插件未正确加载 | 重启 Qoder/QoderCLI/QoderWork 后重新检查插件状态 |
插件配置文件损坏 | 重新执行打包和安装流程 | |
拦截未生效 | 控制台授权配置未完成 | 登录控制台检查授权状态，重新执行步骤一的授权配置 |
控制台策略配置未启用 | 进入策略配置页面，确认防护维度已启用 | |
测试请求未触发检测规则 | 增强测试请求的风险特征（如添加更明显的敏感词） | |
控制台无检测结果 | 插件未正常连接到 Protection Server | 检查网络连接，确认插件可访问 Protection Server |
检测结果上报延迟 | 等待 1-2 分钟后刷新控制台页面 |
数据采集清单
本插件采集以下数据用于运行时防护，与OpenClaw 运行时AI安全防护方案中的数据采集范围一致。
本插件不会采集 HTTP 标准请求头中的以下敏感信息：Authorization、X-API-Key、API-Key、apikey、X-Auth-Token、auth-token、Cookie、Set-Cookie
设备与环境信息
数据项 | 说明 | 用途 |
machine_id | 设备唯一标识 | 标识设备身份，用于安全审计 |
platform | 操作系统平台（如 macOS、Windows） | 识别运行环境类型 |
arch | CPU 架构（如 x64、arm64） | 适配平台特性 |
agent_type | 编码 Agent 类型（qoder/qodercli/qoderwork） | 识别 Agent 来源 |
agent_version | 编码 Agent 版本号 | 适配版本特性 |
LLM 请求/响应内容（安全审计）
数据项 | 说明 | 用途 |
user_prompt | 用户输入的提示词 | 检测提示词攻击、敏感内容 |
system_prompt | 系统提示词 | 检测配置风险 |
llm_response | LLM 生成的响应内容 | 检测内容合规、敏感信息泄露 |
model_name | 调用的模型名称 | 分析模型行为特征 |
Tool Call 信息（安全审计）
数据项 | 说明 | 用途 |
tool_name | 调用的工具名称 | 检测恶意工具调用 |
tool_input | 工具调用的输入参数 | 检测注入攻击、敏感信息 |
tool_output | 工具执行的返回结果 | 检测信息泄露 |
error_message | 工具执行错误信息（如有） | 检测异常行为 |
数据传输说明
服务端点 | 传输数据类型 | 传输频率 | 加密方式 |
Management Server | 设备信息、Agent 配置 | 插件启动时一次、配置变更时实时 | HTTPS + TLS 1.2+ |
Protection Server | LLM 请求/响应、Tool Call 信息 | 每次请求实时 | HTTPS + TLS 1.2+ |