# 让 VS Code Server 的 codex-mcp 走本地 SOCKS5 代理
> 适用场景
> 远端 Ubuntu 主机上，VS Code Server 自动启动的 `codex mcp` 进程需要**强制**通过本地 SOCKS5 代理（例如 `127.0.0.1:7897`）出网，而其它程序保持直连。
---
## 1. 安装依赖
```bash
sudo apt update
sudo apt install proxychains-ng
2. 创建专用配置目录
mkdir -p ~/.proxychains
3. 写入代理配置
~/.proxychains/codex.conf
strict_chain
proxy_dns
tcp_read_time_out 15000
tcp_connect_time_out 8000
[ProxyList]
socks5 127.0.0.1 7897
4. 创建用户级 systemd 单元
文件：~/.config/systemd/user/codex-mcp.service
[Unit]
Description=OpenAI Codex MCP (via SOCKS5 proxy)
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/proxychains -f %h/.proxychains/codex.conf \
/home/pillar/.vscode-server/extensions/openai.chatgpt-0.4.9-linux-x64/bin/linux-x86_64/codex mcp
Restart=on-failure
RestartSec=5
[Install]
WantedBy=default.target
注意
%h会被 systemd 自动展开为$HOME，避免硬编码用户名。- 路径中的版本号
0.4.9随插件升级可能变化，请按需调整。
5. 加载并启动服务
systemctl --user daemon-reload
systemctl --user enable --now codex-mcp.service
6. 杀掉 VS Code 原生的 codex 进程
# 找到旧进程
ps -ef | grep '[c]odex mcp'
# 杀掉
kill <PID>
VS Code 检测到 8080/8081 已被占用，便不再重复启动，后续始终使用我们代理化的实例。
7. 验证代理生效
# 临时测试
proxychains -f ~/.proxychains/codex.conf curl https://api.openai.com/v1/models
返回 200 即表示链路正常，codex-mcp 流量已走 127.0.0.1:7897。
8. 维护命令
| 操作 | 命令 |
|---|---|
| 查看日志 | journalctl --user -u codex-mcp -f |
| 重启服务 | systemctl --user restart codex-mcp |
| 停止服务 | systemctl --user stop codex-mcp |
| 禁用开机自启 | systemctl --user disable codex-mcp |
9. 卸载（可选）
systemctl --user stop codex-mcp
systemctl --user disable codex-mcp
rm ~/.config/systemd/user/codex-mcp.service
systemctl --user daemon-reload
完成！现在 codex-mcp 的所有出入流量均通过本地 SOCKS5 端口 7897，其余程序保持原样。
