Codex Skill怎么安装部署？四种场景配置完整教程

Codex Skill 是以 SKILL.md 为核心的能力包，覆盖在线快捷安装、本地手动部署、自定义开发打包部署和 Function Calling 工具型 Skill 部署四种典型场景。无论选择哪种路径，均需先完成前置环境准备，才能进行后续操作。

一、前置环境准备（必做步骤）

安装 Codex CLI 与配置 OpenAI 密钥（Node.js≥18）

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

Codex Skill 存放目录规则与生效优先级（项目 > 用户 > 系统）

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

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

使用 Codex 内置安装器（会话内一键安装）

打开 codex 交互终端，执行内置指令：

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

通过 GitHub 仓库批量安装 Skill（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

通过压缩包离线安装 Skill

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

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

自定义 Skill 的最小目录结构

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

SKILL.md 标准格式配置（YAML 头部与执行指令）

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

部署自定义 Skill 到指定目录

# 全局部署
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/

启用与测试自定义 Skill

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

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

此类 Skill 绑定 外部 API 或本地脚本，支持 Codex 自动调用函数。需在 SKILL.md 中配置 functions 字段（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 Skill 管理常用命令

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

六、Codex Skill 生效规则与触发方式

1. 隐式自动触发：用户提问匹配 Skill 描述时，Codex 自动加载并执行
2. 显式调用：在会话中输入 $.技能名 强制启用
3. 修改 SKILL.md 后，需 新开 Codex 会话 方可生效，无需重启 CLI