qapten-codex

Polar Sponsor
爱发电 赞助
.NET 9.0

分步指南,教你如何使用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)为开发者提供分步指导,涵盖以下环节:

  1. 安装并认证 OpenAI Codex CLI
  2. 使用 Codex 编码(从简单任务到复杂任务)
  3. 管理 GitHub 仓库
  4. 部署至服务器(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)

  1. 前提:已安装 Coolify(https://coolify.io)

  2. 在 Coolify 控制台中配置应用(关联 GitHub 仓库、指定分支、配置环境变量)

  3. 触发部署:

    # 通过 Coolify API 触发
    curl -X POST "https:///api/v1/deploy" 
      -H "Authorization: Bearer " 
      -H "Content-Type: application/json" 
      -d '{"uuid":"","force":true}'
    

选项 B:Railway

  1. 在 Railway 控制台中绑定 GitHub 仓库
  2. 每次向 GitHub 推送代码时自动触发部署
  3. 环境变量在 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             # 项目文档

⚠️ 安全与最佳实践

  1. 严禁提交任何 Token、API Key、密码或真实的 .env 文件
  2. 使用 .env.example 明确记录所需环境变量
  3. 所有密钥类信息应作为环境变量注入运行时(如 Coolify、Railway 等平台设置)
  4. GitHub Token 应遵循最小权限原则授予必要权限
  5. SSH 密钥权限设置:私钥为 600,公钥为 644
  6. --sandbox danger-full-access:仅限在隔离环境(专用容器/VM)中使用
  7. 绝对禁止在承载生产凭据的机器上以 --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/

相关专题

更多
Codex Agent编程与自主开发能力调优专题
Codex Agent编程与自主开发能力调优专题

PHP中文网为您提供Codex Agent编程与自主开发能力调优专题。针对AI Agent全权委托开发模式,我们为您系统梳理了Harness Engineering(驾驭工程)核心理念,以及涵盖AGENTS.md规范编写、Skills技能配置、Worktree沙盒隔离与多Agent协作架构的实战指南。

2026.06.10

128

7

Codex AI编程工具新手指南
Codex AI编程工具新手指南

全面解析Codex AI编程工具的核心原理、功能特点与实际用途,提供适合新手的Codex入门教程、环境配置方法、代码生成演示与常见问题解答,帮助开发者快速掌握AI自动写代码能力,提升编程学习与开发效率。

2026.05.27

270

10

Codex 模型原理与AI软件工程进阶
Codex 模型原理与AI软件工程进阶

Codex 是基于通用大模型底座,通过海量代码语料与真实 Pull Request 进行专项微调的代码专用模型,能深度理解代码语法树与跨文件依赖,实现从自然语言到高质量工程代码的精准转化。在 AI 软件工程进阶中,Codex 推动了从提示词工程向“驾驭工程(Harness Engineering)”的范式跃迁。

2026.05.26

117

10

Codex API集成与AI编程生态开发
Codex API集成与AI编程生态开发

Codex API 集成是构建下一代 AI 编程生态的核心基石,能通过 API 将强大的代码生成与推理能力无缝接入 VS Code、JetBrains 等主流 IDE 插件,还能将其深度嵌入 CI/CD 流水线,实现自动化的代码审查、单元测试生成与 Bug 修复。结合 Amazon Bedrock 等云平台的托管服务,企业可以灵活打造符合内部安全规范的专属 AI 编程助手。

2026.05.26

144

10

Codex AI 编程代理与智能开发工作流
Codex AI 编程代理与智能开发工作流

Codex 是一款超越传统代码生成的 AI 编程代理,致力于构建全生命周期的智能开发工作流。通过持久线程保留上下文,支持多智能体并行协作与后台自动化运维。借助沙箱权限控制、Plan/Steer 任务管理机制,Codex 既能自主拆解并执行复杂工程任务,又能让开发者牢牢掌控项目进程。从需求分析、编码测试到代码审查与部署,Codex 将 AI 深度融入研发全链路,极大提升了软件工程的交付效率与质量标准。

2026.05.26

234

10

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Codex 应用程序简介
Codex 应用程序简介

共0课时 | 189人学习

Codex官方文档
Codex官方文档

共0课时 | 0人学习