分步指南,教你如何使用OpenAI Codex CLI编写代码、管理GitHub仓库以及部署到服务器。需要codex CLI、git,可选使用令牌。
代码CLI — 流程补全: Dev → GitHub → 部署.是一项面向实际任务的技能,主要用于Vue d’Celementmble.;Cette 技能指南 un développeur pas à pas pour:.;
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
本技能(Skill)为开发者提供分步指导,涵盖以下环节:
⚠️ 本技能为通用型——请将所有占位符 <...> 替换为你自己的实际信息。
GH_TOKEN — GitHub Personal Access Token(可选;若不设置,后续可通过 gh auth login 交互式登录) — 具备 repo 权限的 GitHub Token — Coolify API Token(仅在使用 Coolify 部署时需要)npm install -g @openai/codex
验证安装:
which codex codex --help
codex login --device-auth
CLI 将输出一个短代码(例如 VQ4Z-XSTZV)。请在浏览器中打开 https://auth.openai.com/codex/device,使用你的 ChatGPT Pro/Plus 账户登录,并输入该代码。
验证登录状态:
codex login --status
codex login
Codex 并非一个你向其提问的普通大语言模型(LLM)——它是一个编码智能体(coding agent),可在本地读取、修改并测试你的代码。
cd /path/to/your/project codex exec --json --color never --skip-git-repo-check "在此描述你要完成的任务..."
⚠️ 仅在明确知晓风险且必要时才启用此选项——它将完全禁用 sandbox 隔离机制。
codex exec --json --color never --sandbox danger-full-access --skip-git-repo-check "你的任务描述..."
安全建议:切勿在存有敏感数据的机器上使用
--sandbox danger-full-access。高风险任务应优先运行于隔离容器或专用虚拟机中。
cd /path/to/your/project codex "描述你的任务"
| 参数 | 用途说明 |
|---|---|
--skip-git-repo-check |
允许在非受信 Git 仓库环境(如 VPS、Docker 容器)中运行 Codex |
--sandbox danger-full-access |
⚠️ 禁用 sandbox 隔离 —— 详见上方警告 |
--json |
以结构化 JSON 格式输出结果(便于自动化解析) |
--color never |
禁用 ANSI 颜色代码(适用于非 TTY 日志场景) |
使用 gh CLI 认证:
gh auth login
或使用 Token 认证:
gh auth login --with-token <<< "$GH_TOKEN"
gh repo create your-username/repo-name --private --source=. --remote=upstream --push
# Codex 完成修改后执行 git add -A git commit -m "清晰描述本次变更内容" git push origin
feat: ... → 新增功能fix: ... → Bug 修复docs: ... → 文档更新refactor: ... → 无功能变更的重构前提:已安装 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}'
# 推送代码 git push origin main # SSH 登录服务器 ssh root@# 拉取更新并重启服务 cd /opt/my-app git pull origin main npm install pm2 restart my-app # 或:docker compose pull && docker compose up -d --build
在向生产环境(prod)部署前,请确认:
my-project/ ├── .env.example # 环境变量模板(严禁将真实值提交至 Git) ├── .gitignore ├── package.json ├── server.js # 应用入口文件 ├── src/ # 源代码目录 ├── tests/ # 测试目录 ├── deploy/ # 部署脚本目录 └── README.md # 项目文档
.env 文件.env.example 明确记录所需环境变量600,公钥为 644--sandbox danger-full-access:仅限在隔离环境(专用容器/VM)中使用--sandbox danger-full-access 方式运行 Codex