codex在linux服务器后台持续运行的推荐方式是systemd托管。该方法通过创建/etc/systemd/system/codex.service服务文件，配置user、workingdirectory、execstart及restart=always等参数，实现开机自启、崩溃自动重启和长期无人值守运行，优于tmux（仅适合调试）和nohup（无法交互重启）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Linux服务器上让Codex持续运行、不因SSH断开而终止、且无需图形界面干预，是远程AI编程助手稳定工作的基础前提。
确认环境与安装Codex
先检查系统是否满足最低要求：Ubuntu 20.04+、Debian 10+ 或 CentOS 7+，并确保已联网。
执行 node -v 查看 Node.js 版本，必须 ≥22；若不满足，用 nvm 安装最新 LTS 版本：nvm install --lts && nvm use --lts。
全局安装 Codex CLI：npm install -g @openai/codex。安装完成后运行 codex --version 验证输出版本号。
【auth.json 文件只能保留一行 {"token":"sk-xxx"}，多一个空格或换行都会触发 401 报错】
配置API密钥与模型参数
创建配置目录：mkdir -p ~/.codex && chmod 700 ~/.codex。
写入认证文件：echo '{"token":"sk-xxx"}' > ~/.codex/auth.json（把 sk-xxx 替换为你从 LetAiCode 或 OpenAI 获取的真实密钥）。
生成 config.toml：cat > ~/.codex/config.toml <br>model_provider = "letaicode"<br>model = "gpt-5.5"<br>model_reasoning_effort = "high"<br>disable_response_storage = true<br>preferred_auth_method = "apikey"<br>[model_providers.letaicode]<br>name = "letaicode"<br>base_url = "https://letaicode.cn/<a style="color:#f60; text-decoration:underline;" title="codex" href="https://m.php.cn/zt/20671.html" target="_blank">codex</a>"<br>wire_api = "responses"<br>EOF
PyCharm 2026.2.0.1 Linux版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。
这一步漏掉 disable_response_storage = true 会导致 Codex 在无头模式下反复尝试写日志失败而卡住。
解决服务器无法访问OpenAI服务的关键问题
大多数报错如 “stream disconnected before completion” 或 “network error” 都源于服务器直连受限——它不会自动继承你本地的代理设置。
方法一：用 SSH 端口转发实现本地代理穿透
在本地电脑执行：ssh -L 7890:127.0.0.1:7890 user@your-server-ip（端口号需与你本地代理工具一致，如 Clash 默认 7890）。
方法二：在服务器上配置环境变量使其走本地代理隧道
登录服务器后执行：export HTTP_PROXY=http://127.0.0.1:7890 → export HTTPS_PROXY=http://127.0.0.1:7890。
【必须在启动 Codex 前设置好这两个环境变量，否则认证和后续请求全部失败】
三种后台启动方式任选其一
方法一：nohup 方式（适合快速验证）
进入项目根目录，执行：nohup codex --full-auto "保持监听,等待后续指令" > /dev/null 2>&1 &。
注意：nohup 必须配合 & 使用，否则仍会绑定当前 shell，关闭终端即终止进程。
方法二：systemd 托管（推荐长期部署）
第一步：创建服务文件：sudo nano /etc/systemd/system/codex.service
第二步：填入内容（请将 /home/user/myproject 替换为你真实的项目路径）：
[Unit]
Description=Codex AI Coding Agent
After=network.target
[Service]
Type=simple
User=user
WorkingDirectory=/home/user/myproject
ExecStart=/usr/bin/codex --full-auto "初始化上下文,准备就绪"
Restart=always
RestartSec=10
Environment="PATH=/usr/local/bin:/usr/bin:/bin"
Environment="HTTP_PROXY=http://127.0.0.1:7890"
Environment="HTTPS_PROXY=http://127.0.0.1:7890"
[Install]
WantedBy=multi-user.target
第三步：启用并启动：sudo systemctl daemon-reload → sudo systemctl enable codex → sudo systemctl start codex。
方法三：tmux 会话持久化（适合调试）
新建会话：tmux new-session -s codex-main -d 'codex --full-auto "调试中，请勿退出"'
查看输出：tmux attach -t codex-main，退出时按 Ctrl-b d 分离。
