作者：FPGA入门到精通
本文收获
✅ Codex 和 Claude Code 的差别不在命令，在配置形态和技能来源
✅ 一段提示词交给它，你只守四道验收
✅ 知道哪几处它会自作主张，以及提示词为什么必须写死
✅ 避开卸载静默失效、双装、技能依赖不兑现这三个坑
上一篇介绍了claude code 安装AMD FPGA 开发助手 ROSS，今天分享一下 codex 安装ROSS 开发环境，看完就会，很简单。
一、安装准备
1.1 先分清要装的是什么
「装 ROSS」不是一个动作，是三条独立的线。
Codex 侧多出来一件事：技能不是只有一处来源。
实测问它「你有哪些技能」，它一口气列了 61 个，里面只有 49 个是 ROSS 的。这不是它答错，是 Codex 本来就从多个位置加载：
第三行那个「可选」，是哪种可选。 它容易被读成「不装也无所谓」，不准确。实测扫了 49 个技能，7 个引用了 vivado_doc_search，按依赖强度分三档：
1.2 版本要求
官方文档没写 Codex CLI 要求哪个版本起：install-plugin.md 给了安装命令，没给版本门槛。
1.3 人工确认
其余动作（解压、改名、放到固定目录、填 VIVADO_PATH、注册、跑冒烟）全部交给它。第 4 步文档检索也是零人工，远程 HTTP 服务，不用下任何东西。
二、安装提示词
把下面这段整段复制，粘给 Codex。<…> 处换成你自己的路径，别留占位符。
我准备搭建一套 AMD ROSS 开发环境，分四步做（第 4 步默认不装，装之前必须先问我），每一步装完先验证是否成功。
1、安装 Vivado
先搜索当前电脑已安装的 Vivado，把找到的版本号和安装路径全部列出来。
有多个版本时不要替我选，等我指定。
2、安装 ROSS 插件
用 Codex 的 marketplace 方式装：
codex plugin marketplace add Xilinx/ross-ai-assistant
codex plugin add amd-ross-agentic-ai-assistant@amd-ross-agentic-ai-assistant
装完贴 codex plugin list 的输出，状态里要能看到 installed, enabled。
3、安装 Vivado MCP Server
程序我已经下载好，在：<你自己填：MCP 二进制的路径>
请把它放到固定目录（别留在下载目录），Linux 上先 chmod +x。
要驱动的 Vivado 入口：<你自己填：Windows 用 vivado.bat，Linux 用 vivado>
注册命令（Codex 没有 scope 参数，直接写全局配置）：
codex mcp add vivado-mcp --env VIVADO_PATH=<Vivado 入口路径> -- <二进制路径> --stdio-bridge
注册完自己核一遍 codex mcp list，看 command / args / env 三项有没有写错。
4、安装文档检索 MCP（默认不装，装之前先问我）
这是第二个独立的 MCP server，管查 AMD 官方文档（UG／PG／AM／AR 等），
跟第 3 步那个执行 Tcl 的不是一回事，两个各装各的。
它是远程 HTTP 服务：不用下载任何程序，也不需要 API key，一条命令：
codex mcp add amd-doc-search --url https://ross.amd.com/mcp/doc-search
但先问我一句：要不要让文档查询走 AMD 云端？
- 要（省事，默认）：执行上面那条命令
- 不要（内网 / 文档敏感）：跳过这条，改用官方本地知识库方案（docs/local-kb/）
注意这一步不只是「方便一点」：skills/ 里有 7 个技能引用了它的工具（vivado_doc_search），
其中 3 个是在 frontmatter 里硬声明依赖（含 vivado-ip-configurator 的 compatibility 字段）。
不装不会报错，这几个技能会静默降级成「靠通用知识」。
所以问我之前，请把「装 / 不装各自的后果」一并讲清楚。
【约束】
- 只装 MCP 二进制，不要装 VSIX 扩展（官方规定二选一）
- 我机器上可能装了多个 Vivado，VIVADO_PATH 必须显式指定到我要的那个，不要靠 PATH 猜
- 第 4 步默认不装，装之前必须先问我，并把「不装会让哪几个技能降级」一并说清
- 不要改动我其它任何 MCP / 插件配置
- 不要用 npx skills add 再装一份技能（官方规定只能选一种装法，装两套会重复加载）
【每一步装完，请贴原始输出自证】
- 第 1 步：vivado -version（Windows 用 vivado.bat -version）
- 第 2 步：codex plugin list（应能看到 installed, enabled）
- 第 3 步：codex mcp list（应能看到 vivado-mcp，command / args / env 都对）
- 第 4 步：codex mcp list（amd-doc-search 会出现在第二张表里，列名和 stdio 那张不一样）
它会请求执行权限，正常批准即可。
三、简单测试验证
Codex 会自证一轮，但验收不能只听它说。下面六条各做一次，总共几分钟。
3.1 插件注册上了吗
codex plugin list
过线标准（实测原文，路径已泛化）：
Marketplace `amd-ross-agentic-ai-assistant`
<...>\.agents\plugins\marketplace.json
PLUGIN STATUS VERSION PATH
amd-ross-agentic-ai-assistant@amd-ross-agentic-ai-assistant installed, enabled 2026.9.1 <你注册的路径>
两个词都要在：installed 和 enabled。
只有前者说明装上了但没启用。清单路径是 .agents/plugins/marketplace.json，不是 .claude-plugin/。
3.2 技能装上了吗
这一条最值得单独做，它顺带交叉验证了一个数字。新开会话问：
"List the agent skills you currently have available. Are there any AMD, Vivado, or HLS related skills?"
判据不是「有多少个」，而是「AMD 那几组加起来是不是 49」。实测原文（2026-10-14，38 秒 / 1 turn）：
Yes. Available skills:
**General:** `imagegen`, `openai-docs`, `plugin-creator`, `skill-creator`, `skill-installer`,
`ai-image-generation`, `browser-automation`, `fpga`, `github`, `systemverilog`, `visualize`
**AMD plugin — HLS:** `hls-architect`, `hls-array-to-stream`, `hls-burst-inference`, ... (21 个)
**AMD plugin — Vivado:** `vivado-ip-configurator`, `vivado-revision-control`, ... (6 个)
**AMD plugin — VAI/AIE:** `vai-aie-compiler-oriented-optimizations`, ... (13 个)
**AMD plugin — Segmented Configuration / Debug:** `segcfg-aie`, ..., `hw-ila-debug`, `hw-vio-debug` (9 个)
3.3 MCP 连上了吗
codex mcp list
这里容易看漏：输出不是一张表，是两张。stdio 的 server 一张，HTTP 的另一张，列名都不一样。
Name Command Args Env Cwd Status Auth
vivado-mcp <二进制路径> --stdio-bridge VIVADO_PATH=***** - enabled Unsupported
Name Url Bearer Token Env Var Status Auth
amd-doc-search https://ross.amd.com/mcp/doc-search - enabled Not logged in
Codex 这列表只显示 Status: enabled，是配置已启用，不是连接已验证。
3.4 真能驱动 Vivado 吗
新开会话问：
"What version of Vivado do I have? Use the Vivado MCP tools to find out."
或者直接问：启动vivado
最终回答原文：
Vivado MCP reported the exact version string:
`Vivado v2021.2 (64-bit)`
Build details:
- SW Build 3367213 on Tue Oct 19 02:48:09 MDT 2021
- IP Build 3369179 on Thu Oct 21 08:25:16 MDT 2021
这就启动成功了，默认不会启动 GUI 界面。
3.5 文档检索能用吗
3新开会话，问一句必须引文档才能答的：
"Use the amd-doc-search MCP tool (tool name: vivado_doc_search) to look up the AMD documentation chapter that describes the Zynq UltraScale+ MPSoC Processing System timer/counter block (TTC). Report: (1) the exact document number (UGxxxx), (2) the document version/date, (3) the docs.amd.com chapter-level URL. Do not answer from memory - you must call the tool."
实测回答原文：
1. Document number: UG1085
2. Version/date: v2.5, March 21, 2025
3. URL returned: https://docs.amd.com/v/u/en-US/ug1085-zynq-ultrascale-trm
完整安装依赖文件：https://pan.quark.cn/s/48dd67085b40
