使用指南
CODESYS 中的 AI：现在能做到什么
把 AI 用在 CODESYS 上有三种方式，能替你分担的工作量差别很大。本指南逐一说明这三种方式，介绍接入 IDE 的 AI 智能体实际能做什么，以及开始使用需要准备什么。
在 CODESYS 中使用 AI 的三种方式
大多数工程师一开始是把需求贴进聊天窗口，再把 ST 代码复制回 IDE。写小片段还行，但 AI 根本看不到你的工程：它不知道你的数据类型、IO 映射和用到的库，每出一个编译错误就得再复制粘贴一轮。
- 聊天助手：在聊天窗口和 CODESYS 之间来回复制代码。不用配置，但也接触不到你的工程。
- 代码补全：边写边给建议，例如 CODESYS 正在 CODESYS 4 中加入的 ST 代码补全。写单行很快，但不会规划、搭建整个程序。
- 通过 MCP 接入的 AI 智能体：AI 客户端与 CODESYS Development System 相连，直接在真实工程里工作。它会创建对象、编写代码、编译、读取错误并修复，在你授予完全控制权限后还能在线连接控制器。
MCP 如何把 AI 接入 CODESYS
MCP（Model Context Protocol，模型上下文协议）是一项开放标准，让 AI 客户端可以调用其他应用里的工具。面向 CODESYS 的 MCP 服务把 IDE 的功能做成工具：打开工程、新建 POU、写代码、编译、读取消息列表。由 AI 决定下一步调用哪个工具，真正干活的是 IDE，因此 AI 写出的一切都要经过 CODESYS 真实编译器的检查。
目前已有好几种这样的桥接工具：CODESYS 官方的 CODESYS Development System MCP Server、GitHub 上的开源项目，以及 Rung Coder。它们的区别在于覆盖了工程流程的哪些环节。详细对比见 Rung Coder 与 CODESYS 官方 MCP Server 对比。
借助 Rung Coder，AI 智能体能在 CODESYS 里做什么
Rung Coder 是一款 Windows 桌面应用，把 Codex、Claude Code、Claude Desktop、Cursor 以及其他支持 MCP 或命令行的 AI 客户端接入 CODESYS。它提供 278 个工具，覆盖从空工程到控制器上验证通过的完整流程：
- 程序代码：按 IEC 61131-3 编写的 ST 语言 POU、功能块、方法、DUT 和 GVL；带真实触点、线圈和分支的梯形图（LD）POU，以及对现有 LD 程序单个网络的修改。详见用 AI 生成 ST 代码和用 AI 编写梯形图。
- 可视化（CODESYS SP20 及以上）：一句指令生成整页 HMI，支持 11 种元素、变量绑定和自动布局，写入前先做重叠检查。详见用 AI 生成可视化页面。
- 运动控制：SoftMotion 轴、轴组和 24 种运动学模型，单轴运动、插补和电子凸轮。详见用 AI 做 SoftMotion 运动控制。
- 设备与通讯：设备描述文件、IO 映射，Modbus TCP/RTU、PROFINET、EtherNet/IP 和 CANopen 的主站或控制器一侧配置，以及 OPC UA 服务器。
- 编译与修复：在真实 IDE 中编译，把编译错误原样交回 AI，反复修复直到编译干净。
- 在线调试：登录、下载、在线修改、写入和强制变量、监视列表、1 ms 高速采样与 Trace，在运行中的控制器上检验结果。
- 版本管理：AI 第一次修改前保存整个工程的基线，支持检查点、分支和标签，提供对象级和行级差异，可回滚到任意检查点，并可选同步到你自己的 Git 服务器，无需另装 Git。
- 测试与分析：带逐条通过/失败结果的在线测试用例、在控制器上运行的性能分析和代码覆盖率、带触发的 PLC 内示波器、PID 整定，以及与 MATLAB/Simulink 或被控对象模型的联合仿真，用于虚拟调试。还能同时运行多个 CODESYS 实例。
一次典型的使用过程
- 用日常语言描述需求，例如一条带软启动、过载故障需复位、并有 HMI 页面的输送线。
- AI 在你打开的工程里创建数据类型、变量和 POU，并编写代码。
- Rung Coder 编译；AI 读取消息并逐一修复，直到 0 错误 0 警告。
- 如有需要，AI 生成可视化页面并绑定变量。
- 你授予完全控制权限后，下载到控制器或仿真器，启动程序并采样实时变量，检查运行效果。
- 让 AI 为这个可用状态设一个检查点，日后可以对比或回滚。
需要准备什么
安装 Rung Coder 并登录，从 Rung Coder 启动 CODESYS，再把生成的配置提示词粘贴到 AI 客户端。客户端会自行完成配置并自检，重启一次即可使用，首次大约需要 10 分钟。快速教程里有每一步的说明。
- Windows 10 或 11，64 位。
- CODESYS V3.5 SP18 及以上版本，并安装 CODESYS 脚本引擎。SP21 和 SP22 已在真实硬件上完整验证，SP18 至 SP20 支持核心功能。
- 支持 MCP 或命令行的 AI 客户端，例如 Codex、Claude Code、Claude Desktop 或 Cursor，以及该服务商的账号。AI 用量由服务商单独计费，Rung Coder 本身不含模型。
- 任何在 CODESYS 官方 V3.5 IDE 中编程的控制器，另外支持汇川 InoProShop。登录需要联网。
使用边界与安全
编译通过只说明语法和引用正确。程序是否满足工艺要求、时序是否合适，仍然需要你来审核和把关。急停等安全功能不得用 Rung Coder 编写，应保留在硬件安全回路中。
Rung Coder 有三个权限级别：只读、读写和完全控制。所有在线操作，从读取实时值到下载、写入和强制变量，都需要完全控制权限。在授权模式下，AI 必须按工程申请这一权限，你在确认框中批准之前什么都不会执行。下载到或写入真实控制器还需另行明确允许。请先在仿真环境或备用设备上验证，不要把调试工作全部交给 AI。