CodeX CLI安装+MCP适配与VSCode部署（Win）

CodeX CLI安装

• 系统环境要求：Win10或11、依赖工具（如Node.js、Python等）
• CodeX 项目地址：codex
• 安装方式：

1、Git安装：Git官网

2、安装Node.js依赖，推荐直接默认路径安装。node.js官网中直接下载适配自己电脑的版本即可。中间注意这一步不用勾选（勾选了之后会把所有的不管之前安装过的还是没安装的工具全部下载一遍，可能会导致路径出问题）

3、验证安装完成，输出版本号即为安装成功。

node -v
npm -v

4、安装Codex CLI，注意保持github链接是通畅的（绿色通道）。

npm install -g @openai/codex

5、验证安装完成，输出版本号即为安装成功。

codex --version

6、如果有OpenAI账号直接登就行，没有的话自己调用API，需要配置环境变量。

在C:\Users\xxx（你的用户名）文件夹下会自动生成.codex文件夹。如果没有.codex文件夹，那么需要手动创建文件夹，然后创建config.toml以及auth.json两个文件

填写配置-auth.json中的配置

{
"OPENAI_API_KEY": "xxx"
}

填写配置-config.toml中的配置

model_provider = "xxx" #根据API供应商填写
model = "gpt-5"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.yourapi]
name = "xxx"
base_url = "xxx"
wire_api = "responses"

重启终端！重启终端！重启终端！然后进入到工程目录

cd your-project-folder

然后，运行命令启动：

codex

/status

最常用的命令，用于检查当前的权限和 GPT-5 模型配置。如果你是自定义 API Key，更应该多使用该命令检查是否使用了正确模型。

/approvals

授予 Codex 权限，目前有三种，如果超出权限限制，就需要用户手动确认：

• Read Only：默认权限，只能读取文件（实操下来限制太多，和 Agent Coding 自由理念相悖，一个任务可能要十多次手动批准。太麻烦）
• Auto：读写，运行命令（实测一点也不 Auto，还是有太多手动批准）
• Full Access：读写、使用网络工具（虽然官方一再声明小心操作，但这是我的日常使用的方式，真正的 Auto，整个过程不需要一次确认）

MCP（Modular Control Platform）适配

• 系统环境要求：Win10或11、依赖工具
• Mcprouter项目地址：mcp-router
• 安装方式：

1、MCP配置，直接使用mcp-router，一键缝合所有想要的MCP服务。Releases内下载对应版本。

2、运行mcprouter程序，安装对应的依赖（点击Use会自动弹出），选择要导入的MCP。

​

3、推荐的MCP有：serena（注意保证网络连通）

{"mcpServers": {"serena": {"command": "uvx","args": ["--from", "git+https://github.com/oraios/serena", "serena-mcp-server"]}}
}

4、添加 MCP 服务完成后，需要点击开启按钮，这个同时也会测试服务是否能正常使用

​

4、windows用户进入 C:\Users\xxx\.codex目录编辑config.toml文件，添加如下配置：

#只需要配置单个的mcp-router服务即可
[mcp_servers.mcp-router]
command = "npx" 
args = ["-y", "mcpr-cli@latest", "connect"]
env = { MCPR_TOKEN = "xxx" }

5、添加 MCP App，因为 MCP Router 没有集成 codex，需要添加自定义应用并使用它的 token。

​

（或者不安装MCP-router）windows用户进入 C:\Users\xxx\.codex目录编辑config.toml文件，添加如下配置，mac和linux用户打开终端，vi ~/.codex/config.toml，粘贴后按一下键盘上的"ESC"案件，将输入法调成英文，输入:wq后按下Enter键保存并且退出。

[mcp_servers.serena]
command = “uvx”
args = [“–from”, “git+https://github.com/oraios/serena”, “serena”, “start-mcp-server”, “–context”, “codex”]

6、注意，MCP一般是不会自动激活的，除非你把它写到规则里。所以如果用插件或 CLI 中请明确提示词-使用 serena 激活项目。

eg: 使用 serena 将当前目录激活为项目

VSCode 插件集成部署

1、Vscode开启自动发现，安装mcp-router后如下所示：

2、在MCP软件中一键配置后，在配置中开启所要开启MCP的模型，注意开启服务。

3、注意，MCP一般是不会自动激活的，除非你把它写到规则里。所以如果用插件或 CLI 中请明确提示词-使用 serena 激活项目。

**此帖为网络内容整理+修改后，自己部署的经验进行总结而来，感谢开源社区的教程帮助**