Codex Skill如何安装部署?一文掌握Codex Skill四种场景下配置的完整教程

Codex Skill本质是能力包以SKILL.md作为核心，分为：四种部署场景包括Function Calling工具型Skill部署、自定义开发打包部署、本地手动部署和在线快捷安装前置环境完成后，再进入四大场景的部署。

一、必做的前置环境准备

安装Codex CLI（Node.js≥18）

# 全局安装CLI
npm install -g @openai/codex
# 配置OpenAI密钥（二选一）
export OPENAI_API_KEY="sk-xxx"
# 交互式登录授权
codex login

项目>用户>系统：Skill存放目录的优先级规则

目录路径	生效范围
./.codex/skills/	项目级：生效范围限于当前代码仓库，团队可通过提交Git共享
~/.codex/skills/	用户全局：自动加载到本机所有项目（最常用）
/opt/codex/system/skills/	全机器的所有用户均受系统级设置影响

二、方式1：社区Skill快捷在线部署（3种安装命令）

会话内一键安装：Codex内置安装器

内置指令需在打开的codex交互终端中执行：

$skill-installer
# 弹出技能列表→输入编号安装，默认装到用户目录~/.codex/skills
# --local 参数安装到当前项目 .codex/skills
$skill-installer --local

GitHub仓库一键安装（CLI命令）

# 整仓批量安装
npx skills add ComposioHQ/awesome-codex-skills -g
# 单个技能指定路径安装
python skill-installer/scripts/install-skill-from-github.py --repo 用户名/仓库 --path skills/技能名
# 直接克隆安装
git clone https://github.com/xxx/xxx-skill ~/.codex/skills/skillname

离线安装压缩包

unzip skill包.zip -d ~/.codex/skills/
# 校验：目录内必须存在SKILL.md
ls ~/.codex/skills/skillname/SKILL.md

三、自研技能部署方式2：手动定制Skill

最小化目录结构

my-api-tool/          # 技能名（目录=技能ID）
├─ SKILL.md           # 【必填】元数据+执行规则
├─ scripts/           # 可选：shell/python执行脚本
├─ references/        # 可选：模板、参考文档
└─ assets/            # 可选：配置、静态资源

头部YAML+正文指令构成SKILL.md标准格式

---
name: api-generator
description: 根据参数自动生成RESTful接口代码
metadata:
  version:1.0
  author:xxx
---
## 触发规则
用户要求创建接口时自动启用本Skill
## 执行步骤
1. 解析入参（路由、请求方式、参数）
2. 生成TS/Express接口代码
3. 输出文件到src/routes

完成部署落地

# 全局部署
mkdir -p ~/.codex/skills/api-generator
# 复制编写好的全部文件到此目录
cp -r ./my-api-tool/* ~/.codex/skills/api-generator/
# 项目局部部署
mkdir -p .codex/skills/api-generator
cp -r ./my-api-tool/* .codex/skills/api-generator/

启用&测试

# 查看已安装技能
codex skill list
# 显式调用技能
$.api-generator
# 启动codex并临时挂载单个技能（不写入目录）
codex --instructions ./my-api-tool/SKILL.md

四、Function Calling部署：方式3（工具调用型Skill）

绑定关系属于这类Skill外部API/本地脚本，函数可由Codex自动调用：

补充内容写入SKILL.mdfunctions配置（JSON Schema定义函数）

---
name:http-request
functions:
  - name:curl_api
    description:发起http接口请求
    parameters:
      type:object
      properties:
        url:{type:string},method:{enum:[GET,POST]}
---
# 正文：Codex收到接口调用需求自动调用curl脚本

在scripts/curl_api.py完成对应函数逻辑

目录按上述位置部署，函数调用在Codex启动时开启：

codex --enable-function-call

五、常用命令：技能管理

# 添加注册技能
codex skills add ./技能目录
# 更新已部署技能
codex skills update ./技能目录
# 卸载删除技能
codex skills remove 技能名
# 查看全部已加载Skill
codex skill list

六、生效机制

1. 隐式自动触发：Codex依据与Skill描述匹配的用户提问，自动执行加载
2. 显式调用：在会话中输入$.技能名强制启用
3. 完成SKILL.md修改后Codex会话另行新建无需重启CLI便会生效