Codex Skill怎么安裝部署?一文看懂Codex Skill四種場景下配置的完整教程
發(fā)布時間：2026-07-28 11:59:49 作者：_codemonster 
我要評論
我要評論Codex Skill本質(zhì)是以SKILL.md為核心的能力包，主要提供了四種部署方式，即在線快捷安裝，本地手動部署，自定義開發(fā)打包部署和Function Calling工具型Skill部署,手把手教你快速上手,讓你的AI助手能力瞬間升級
Codex Skill本質(zhì)是以SKILL.md為核心的能力包，分：在線快捷安裝、本地手動部署、自定義開發(fā)打包部署、Function Calling工具型Skill部署四大場景，先完成前置環(huán)境再部署。
一、前置環(huán)境準備（必做）
安裝Codex CLI（Node.js≥18）
# 全局安裝CLI npm install -g @openai/codex # 配置OpenAI密鑰（二選一） export OPENAI_API_KEY="sk-xxx" # 交互式登錄授權(quán) codex login
Skill存放目錄規(guī)則（優(yōu)先級：項目>用戶>系統(tǒng)）
| 目錄路徑 | 生效范圍 |
|---|---|
./.codex/skills/ | 項目級：僅當前代碼倉庫生效，可提交Git團隊共享 |
~/.codex/skills/ | 用戶全局：本機所有項目自動加載（最常用） |
/opt/codex/system/skills/ | 系統(tǒng)級：全機器所有用戶生效 |
二、方式1：快捷在線部署社區(qū)Skill（3種安裝命令）
Codex內(nèi)置安裝器（會話內(nèi)一鍵安裝）
打開codex交互終端，執(zhí)行內(nèi)置指令：
$skill-installer # 彈出技能列表→輸入編號安裝，默認裝到用戶目錄~/.codex/skills # --local 參數(shù)安裝到當前項目 .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/ # 校驗：目錄內(nèi)必須存在SKILL.md ls ~/.codex/skills/skillname/SKILL.md
三、方式2：手動自定義Skill部署（自研技能）
最小目錄結(jié)構(gòu)
my-api-tool/ # 技能名（目錄=技能ID）
├─ SKILL.md # 【必填】元數(shù)據(jù)+執(zhí)行規(guī)則
├─ scripts/ # 可選：shell/python執(zhí)行腳本
├─ references/ # 可選：模板、參考文檔
└─ assets/ # 可選：配置、靜態(tài)資源
SKILL.md標準格式（頭部YAML+正文指令）
--- name: api-generator description: 根據(jù)參數(shù)自動生成RESTful接口代碼 metadata: version:1.0 author:xxx --- ## 觸發(fā)規(guī)則 用戶要求創(chuàng)建接口時自動啟用本Skill ## 執(zhí)行步驟 1. 解析入?yún)ⅲ酚?、請求方式、參?shù)） 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 # 顯式調(diào)用技能 $.api-generator # 啟動codex并臨時掛載單個技能（不寫入目錄） codex --instructions ./my-api-tool/SKILL.md
四、方式3：Function Calling（工具調(diào)用型Skill）部署
這類Skill綁定外部API/本地腳本，支持Codex自動調(diào)用函數(shù)：
在SKILL.md中補充functions配置（JSON Schema定義函數(shù)）
---
name:http-request
functions:
- name:curl_api
description:發(fā)起http接口請求
parameters:
type:object
properties:
url:{type:string},method:{enum:[GET,POST]}
---
# 正文：Codex收到接口調(diào)用需求自動調(diào)用curl腳本在scripts/curl_api.py實現(xiàn)對應函數(shù)邏輯
部署目錄同上，啟動Codex時開啟函數(shù)調(diào)用：
codex --enable-function-call
五、技能管理常用命令
# 添加注冊技能 codex skills add ./技能目錄 # 更新已部署技能 codex skills update ./技能目錄 # 卸載刪除技能 codex skills remove 技能名 # 查看全部已加載Skill codex skill list
六、生效規(guī)則
- 隱式自動觸發(fā)：用戶提問匹配Skill描述，Codex自動加載執(zhí)行
- 顯式調(diào)用：會話輸入
$.技能名強制啟用 - 修改SKILL.md后新開Codex會話生效，無需重啟CLI
以上就是Codex Skill怎么安裝部署?一文看懂Codex Skill四種場景下配置的完整教程的詳細內(nèi)容，更多關(guān)于Codex Skill部署的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
從零搭建Codex工作臺,告別混亂配置！本文手把手教你安裝CLI與桌面App,詳解AGENTS.md項目規(guī)則、config.toml與Skills配置,并直擊MCP與插件連接外部工具的核心方法,讀完即可將2026-07-16
本文主要介紹了Codex配置Skill的實現(xiàn)步驟，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2026-07-29
