多折点
每天5分钟,收获一个能用上的知识。

在 VPS 上自托管 AI 编码助手:Codex 与 Claude Code 部署、安全与运维指南

在 VPS 上自托管 AI 编码助手:Codex 与 Claude Code 部署、安全与运维指南

随着 OpenAI Codex CLI 和 Anthropic Claude Code 相继开源并支持终端环境下的自托管部署,越来越多的开发者开始将 AI 编码助手部署到自己的 VPS 上。这不仅能避免 API 调用费用的累积,还能将代码数据完全保留在自有基础设施中。本文将详细讲解两种主流方案的部署步骤、安全配置和日常运维要点。

自托管的优势 数据隐私:所有代码和对话记录不出你控制的 VPS 边界。成本可控:按 VPS 月费固定支出,不受 API Token 使用量波动影响。离线可用:模型本地运行后即使网络中断也不影响编码辅助。

一、环境准备与 VPS 选型

自托管 AI 编码助手对 VPS 的 CPU 和内存有较高要求。轻量级模型(如 Codex 的小参数 variant)建议 4 核 / 8GB RAM 起步;运行 Claude Code 的本地推理端则需要 8 核 / 16GB RAM 和至少 50GB 可用磁盘空间。推荐使用 KVM 虚拟化的 VPS,避免 OpenVZ 带来的内存限制。如果你尚未确定 VPS 供应商,可以参考 Vultr 的全球数据中心方案DigitalOcean 的灵活计费模式,两者都提供适合自托管的高配机型。

部署方案 最低配置 推荐配置 磁盘 模型大小
Codex CLI 4C / 8GB 8C / 16GB 20GB+ ~7GB
Claude Code 8C / 16GB 12C / 32GB 50GB+ ~15GB

二、Codex CLI 部署步骤

OpenAI Codex CLI 以 Python 包形式发布,通过 pip 即可安装。首先 SSH 进入 VPS,更新系统包并安装 Python 3.11 和虚拟环境管理工具。然后创建虚拟环境,执行 pip install codex-cli 安装 Codex。首次运行 codex init 会下载模型权重并创建配置文件。需要注意的是,Codex CLI 默认会打开一个本地 HTTP 端口用于 Web 界面交互,建议绑定到 127.0.0.1 并使用 SSH 隧道或反向代理暴露给局域网。

三、Claude Code 部署步骤

Claude Code 的自托管部署基于其开源推理运行时。从 GitHub 克隆仓库后,执行 make installmake serve 即可启动推理服务。Claude Code 支持以 systemd service 形式后台运行,方便开机自启。注意,Claude Code 的推理端依赖 CUDA 或 Vulkan 加速——如果 VPS 没有 GPU,只能纯 CPU 推理,响应速度会显著下降,建议配合 --cpu 标志使用量化模型。

四、安全配置要点

将 AI 编码助手暴露在公网上存在严重的安全风险——攻击者可能通过未授权的 API 调用消耗你的计算资源,甚至注入恶意指令获取 VPS 控制权。以下是必须实施的安全措施:

第一,所有推理服务端口必须绑定到 localhost,通过 Nginx 反向代理并启用 HTTPS + Basic Auth 或 OAuth2 Proxy 进行访问控制。第二,在系统层面配置 iptables 或 ufw 防火墙,仅放行 SSH 和反向代理端口。第三,为模型推理进程创建独立的 Linux 用户并启用 systemd 的 DynamicUser 和 ProtectSystem 沙箱能力。如果你是新接触 VPS 安全的读者,推荐先阅读我们的 VPS 新手防坑指南 了解基础安全配置。

五、日常运维与资源监控

自托管 AI 编码助手是资源密集型服务,建议配置以下监控项:CPU 和内存使用率告警(阈值 80%)、磁盘空间告警(剩余小于 10GB)、以及服务进程存活检测。可以使用 Prometheus + Node Exporter 搭配 Grafana 面板,或者更轻量的 netdata 一键部署。模型权重文件较大(7-15GB),建议每周执行一次增量备份到对象存储或挂载的 NFS 卷。

常见问题(FAQ)

Q:Codex CLI 和 Claude Code 可以同时部署在同一台 VPS 上吗?
A:可以,前提是 VPS 资源充足。建议总内存不低于 32GB,磁盘不低于 80GB。两个推理服务会争抢 CPU 和内存资源,不建议在生产环境混部。

Q:一定要 GPU 才能运行吗?
A:Codex CLI 的量化版本可以在纯 CPU 环境下运行,但代码补全延迟在 2-5 秒。Claude Code 的推理端在 CPU 模式下响应时间约 5-15 秒,体验明显下降。预算允许的话建议选择带 NVIDIA T4 或 L4 的 GPU VPS。

Q:如何与 VS Code 或 JetBrains IDE 集成?
A:Codex CLI 原生支持 VS Code 扩展连接,配置指向 VPS 的 IP 和端口即可。Claude Code 提供 LSP 协议兼容接口,可通过开源的 Claude Code IDE 插件桥接。

Q:多团队共享一台 VPS 的推理服务是否可行?
A:可行。建议每个团队使用独立的 API Key 进行鉴权,并在 Nginx 层做速率限制(rate limiting)。对于高并发场景,可以水平扩展到多台 VPS 后端。

Q:模型更新时如何迁移?
A:Codex CLI 执行 codex update 自动下载新版本权重。Claude Code 需要 git pull 最新代码后重新 make install。建议在测试环境验证后再升级生产实例。