by 运行时依赖
安装命令
点击复制技能文档
Codex CLI — 流程完成：开发 → GitHub → 部署 概述 本技能指南一步一步地指导开发人员：
安装和认证 OpenAI Codex CLI 使用 Codex 编码（从简单到复杂的任务） 管理 GitHub 仓库 部署到服务器（Coolify、Railway 或 SSH 经典） 这个技能是通用的 —— 用你自己的信息替换占位符 <...>。
前提 所需二进制文件（在元数据中声明） codex —— 编码代理 CLI OpenAI git —— 版本控制 npm —— 安装 codex 可选二进制文件（取决于你的工作流程） gh（GitHub CLI）—— 从 CLI 管理仓库 curl —— API 调用（Coolify、GitHub） ssh —— 连接到服务器 docker —— 容器化部署 环境变量（推荐） GH_TOKEN —— GitHub 个人访问令牌（可选，否则使用 gh auth login） 需要配置的秘密（不存储在技能中） —— 具有仓库权限的 GitHub 令牌 —— Coolify API 令牌（如果使用 Coolify 部署） SSH 私钥 —— 部署服务器访问权限
步骤 1 —— 安装 Codex CLI npm install -g @openai/codex 验证：which codex codex --help
步骤 2 —— 使用 ChatGPT 认证 方法 A：设备代码流（推荐用于服务器/VPS） codex login --device-auth CLI 显示一个短代码（类型为 VQ4Z-XSTZV）。 打开 https://auth.openai.com/codex/device 在你的浏览器中，使用你的 ChatGPT Pro/Plus 账户登录，输入代码。 验证：codex login --status 方法 B：浏览器流（本地） codex login
步骤 3 —— 使用 Codex CLI 编码 Codex 不是一个你可以问问题的 LLM —— 它是一个可以读取、修改和测试你代码的编码代理。 简单任务 cd /项目路径 codex exec --json --color never --skip-git-repo-check "描述你要做什么..." 禁用沙盒（如果沙盒不支持） 使用此选项仅当你知道自己在做什么 —— 它禁用了沙盒隔离。 codex exec --json --color never --sandbox danger-full-access --skip-git-repo-check "你的任务..." 安全建议：不要在包含敏感数据的机器上使用 --sandbox danger-full-access。 优先使用隔离容器进行风险任务。 交互任务（在具有 TTY 的终端中） cd /项目路径 codex "描述你的任务" 重要标志 标志 为什么 --skip-git-repo-check 允许在非“受信任”的 git 仓库外编码（VPS、Docker） --sandbox danger-full-access 禁用沙盒 —— 参见上面的警告 --json 结构化 JSON 输出（用于自动分析） --color never 不使用 ANSI 代码（用于非 TTY 日志） Codex 任务示例 "创建一个具有 GET /api/health 端点的 Express.js 服务器" "添加一个基于环境变量的 PostgreSQL 连接" "修复 bug：parseJSON 函数在输入为空时崩溃" "为 auth 模块添加 Jest 测试"
步骤 4 —— GitHub 仓库 使用 gh CLI 认证 GitHub gh auth login 或使用令牌： gh auth login --with-token <<< "$GH_TOKEN" 创建一个新仓库 gh repo create 你的用户名/仓库名称 --private --source=. --remote=upstream --push Git 工作流程 在 Codex 修改后 git add -A git commit -m "描述性更改消息" git push origin <分支> 提交消息约定 feat：... —— 新功能 fix：... —— 修复 bug docs：... —— 文档 refactor：... —— 无功能变化的重构
步骤 5 —— 部署 选项 A：Coolify（自托管 PaaS） 先决条件：Coolify 安装（https://coolify.io） 在 Coolify 中配置应用程序（GitHub 仓库、分支、环境变量） 部署： 通过 Coolify API curl -X POST "https:///api/v1/deploy" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{"uuid":"","force":true}' 选项 B：Railway 在 Railway 仪表板中连接 GitHub 仓库 通过 GitHub 推送自动部署 在 Railway 设置中配置环境变量 选项 C：SSH 经典 / VPS 推送代码 git push origin main SSH 到服务器 ssh root@ 拉取并重启 cd /opt/我的应用 git pull origin main npm install pm2 restart 我的应用 或 docker compose pull && docker compose up -d --build 选项 D：Docker / Cloud Run / 其他 将 Docker 镜像推送到注册表 通过提供商的 CLI 部署（gcloud、aws 等） 部署清单 在生产环境中部署之前： 代码已在分阶段测试 环境变量已配置 数据库迁移已准备好（如果适用） 回滚计划已定义 人类验证（没有自动生产部署） 项目类型架构 我的项目/ ├── .env.example # 环境变量模板（永远不要在 git 中存储真实值） ├── .gitignore ├── package.json ├── server.js # 入口点 ├── src/ # 源代码 ├── tests/ # 测试 ├── deploy/