分步指南,教你如何使用OpenAI Codex CLI编写代码、管理GitHub仓库以及部署到服务器。需要codex CLI、git,可选使用令牌。
代码CLI — 流程补全: Dev → GitHub → 部署.
功能概述
代码CLI — 流程补全: Dev → GitHub → 部署.是一项面向实际任务的技能,主要用于Vue d’Celementmble.;Cette 技能指南 un développeur pas à pas pour:.;
核心要点
- Installer 和认证 OpenAI Codex CLI.;
- Coder avec Codex (tâches simples à co) 互联网档案馆的存檔,存档日期2013-03-02.。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
使用与执行
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
Codex CLI — Flow Complet : Dev → GitHub → Deploy
概述
本技能(Skill)为开发者提供分步指导,涵盖以下环节:
- 安装并认证 OpenAI Codex CLI
- 使用 Codex 编码(从简单任务到复杂任务)
- 管理 GitHub 仓库
- 部署至服务器(Coolify、Railway 或传统 SSH)
⚠️ 本技能为通用型——请将所有占位符 <...> 替换为你自己的实际信息。
前提条件
必需的二进制工具(已在元数据中声明)
- codex — OpenAI 的编码智能体(coding agent)CLI 工具
- git — 版本控制工具
- npm — 用于安装 codex
可选的二进制工具(依工作流而定)
- gh(GitHub CLI)— 通过命令行管理 GitHub 仓库
- curl — 发起 API 请求(如调用 Coolify、GitHub API)
- ssh — 连接远程服务器
- docker — 容器化部署
推荐配置的环境变量
GH_TOKEN— GitHub Personal Access Token(可选;若不设置,后续可通过gh auth login交互式登录)
需手动配置的密钥(不存储于本技能中)
— 具备repo权限的 GitHub Token— Coolify API Token(仅在使用 Coolify 部署时需要)- 私钥 SSH 密钥 — 用于访问部署服务器
步骤 1 — 安装 Codex CLI
npm install -g @openai/codex
验证安装:
which codex codex --help
步骤 2 — 使用 ChatGPT 认证
方法 A:Device Code 流程(推荐用于服务器/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)——它是一个编码智能体(coding agent),可在本地读取、修改并测试你的代码。
简单任务
cd /path/to/your/project codex exec --json --color never --skip-git-repo-check "在此描述你要完成的任务..."
禁用 sandbox(仅当 sandbox 不被支持时使用)
⚠️ 仅在明确知晓风险且必要时才启用此选项——它将完全禁用 sandbox 隔离机制。
codex exec --json --color never --sandbox danger-full-access --skip-git-repo-check "你的任务描述..."
安全建议:切勿在存有敏感数据的机器上使用
--sandbox danger-full-access。高风险任务应优先运行于隔离容器或专用虚拟机中。
交互式任务(在具备 TTY 的终端中执行)
cd /path/to/your/project codex "描述你的任务"
关键参数(Flags)说明
| 参数 | 用途说明 |
|---|---|
--skip-git-repo-check |
允许在非受信 Git 仓库环境(如 VPS、Docker 容器)中运行 Codex |
--sandbox danger-full-access |
⚠️ 禁用 sandbox 隔离 —— 详见上方警告 |
--json |
以结构化 JSON 格式输出结果(便于自动化解析) |
--color never |
禁用 ANSI 颜色代码(适用于非 TTY 日志场景) |
Codex 任务示例
- "创建一个 Express.js 服务,并添加 GET /api/health 接口"
- "基于环境变量添加 PostgreSQL 连接"
- "修复 bug:parseJSON 函数在输入为空时崩溃"
- "为 auth 模块添加 Jest 测试用例"
步骤 4 — GitHub 仓库管理
GitHub 认证
使用 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
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/my-app git pull origin main npm install pm2 restart my-app # 或:docker compose pull && docker compose up -d --build
选项 D:Docker / Cloud Run / 其他平台
- 构建并推送 Docker 镜像至镜像仓库(registry)
- 使用对应云厂商 CLI(如 gcloud、aws 等)完成部署
生产部署检查清单
在向生产环境(prod)部署前,请确认:
- 代码已在预发布(staging)环境完成测试
- 所有环境变量均已正确配置
- 数据库迁移脚本已就绪(如适用)
- 已制定回滚预案
- 已由人工审核确认(禁止未经人工批准的自动生产部署)
典型项目结构
my-project/ ├── .env.example # 环境变量模板(严禁将真实值提交至 Git) ├── .gitignore ├── package.json ├── server.js # 应用入口文件 ├── src/ # 源代码目录 ├── tests/ # 测试目录 ├── deploy/ # 部署脚本目录 └── README.md # 项目文档
⚠️ 安全与最佳实践
- 严禁提交任何 Token、API Key、密码或真实的
.env文件 - 使用
.env.example明确记录所需环境变量 - 所有密钥类信息应作为环境变量注入运行时(如 Coolify、Railway 等平台设置)
- GitHub Token 应遵循最小权限原则授予必要权限
- SSH 密钥权限设置:私钥为
600,公钥为644 --sandbox danger-full-access:仅限在隔离环境(专用容器/VM)中使用- 绝对禁止在承载生产凭据的机器上以
--sandbox danger-full-access方式运行 Codex
参考资料
- Codex CLI 文档:https://developers.openai.com/codex/
- Coolify 文档:https://coolify.io/docs
- Railway 文档:https://docs.railway.app
- Cloudflare DNS API 文档:https://developers.cloudflare.com/api/
热门AI工具
相关专题
PHP中文网为您提供Codex Agent编程与自主开发能力调优专题。针对AI Agent全权委托开发模式,我们为您系统梳理了Harness Engineering(驾驭工程)核心理念,以及涵盖AGENTS.md规范编写、Skills技能配置、Worktree沙盒隔离与多Agent协作架构的实战指南。
128
2026.06.10
全面解析Codex AI编程工具的核心原理、功能特点与实际用途,提供适合新手的Codex入门教程、环境配置方法、代码生成演示与常见问题解答,帮助开发者快速掌握AI自动写代码能力,提升编程学习与开发效率。
270
2026.05.27
Codex 是基于通用大模型底座,通过海量代码语料与真实 Pull Request 进行专项微调的代码专用模型,能深度理解代码语法树与跨文件依赖,实现从自然语言到高质量工程代码的精准转化。在 AI 软件工程进阶中,Codex 推动了从提示词工程向“驾驭工程(Harness Engineering)”的范式跃迁。
117
2026.05.26
Codex API 集成是构建下一代 AI 编程生态的核心基石,能通过 API 将强大的代码生成与推理能力无缝接入 VS Code、JetBrains 等主流 IDE 插件,还能将其深度嵌入 CI/CD 流水线,实现自动化的代码审查、单元测试生成与 Bug 修复。结合 Amazon Bedrock 等云平台的托管服务,企业可以灵活打造符合内部安全规范的专属 AI 编程助手。
144
2026.05.26
Codex 是一款超越传统代码生成的 AI 编程代理,致力于构建全生命周期的智能开发工作流。通过持久线程保留上下文,支持多智能体并行协作与后台自动化运维。借助沙箱权限控制、Plan/Steer 任务管理机制,Codex 既能自主拆解并执行复杂工程任务,又能让开发者牢牢掌控项目进程。从需求分析、编码测试到代码审查与部署,Codex 将 AI 深度融入研发全链路,极大提升了软件工程的交付效率与质量标准。
234
2026.05.26
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。
0
2026.11.17
SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。
0
2026.11.17
热门下载
相关下载
精品课程
共0课时 | 189人学习
共0课时 | 0人学习