首页TokenhotAPI文档工具集成
语言
语言
  • English
  • 中文
首页TokenhotAPI文档工具集成
语言
语言
  • English
  • 中文
  1. Codex
  • 导航
  • OpenClaw
  • hermes
  • Gemini CLI
  • OpenCode
  • Cherry Studio
  • CC-Switch
  • Workbuddy
  • Claude
    • 概述
    • 安装Claude Code
    • 配置模型供应商
    • CCometixLine 状态栏插件
    • Skills配置
  • Codex
    • 配置模型供应商
    • Codex CLI安装
    • 配置skill
  1. Codex

配置skill

TokenHot AI Codex Skill 接入教程#

TokenHot AI Skill 让 Codex 按需调用 TokenHot 的外部模型:
聊天与分析:可把用户授权的文件、搜索资料交给指定模型分析。
文生图、图片编辑:自动保存生成结果,并在 Codex 桌面端尝试展示。
文生视频、图生视频:自动提交、轮询任务、下载结果。
使用时写 $tokenhot-ai,例如:
$tokenhot-ai 请使用 claude-opus-4-7 分析这份 PRD 的风险。
不要在 Codex 对话中发送 TokenHot API Key。请只在本机终端按提示输入。

1. 让 Codex 安装(推荐)#

新建一个 Codex 任务,按系统复制对应的一段话。

Windows#

请安装 TokenHot AI Skill。发行清单是 https://codex.tokenhot.ai/manifest.json。下载前校验清单、Windows 安装器和 Skill ZIP 的大小与 SHA-256,不要通过管道执行远程脚本。安装后优先打开新的、可交互的 PowerShell 7(pwsh)窗口运行 setup-windows.ps1,让我在窗口中隐藏输入 TokenHot API Key;不要在对话或命令参数中索取 Key。若 pwsh 不可用,只能使用 Windows PowerShell 时,先运行 Import-Module Microsoft.PowerShell.Security -ErrorAction Stop;模块加载失败就停止、不要让我输入 Key,并说明需要安装 PowerShell 7。配置成功后自动运行 doctor -Json 并告诉我结果。

macOS#

请安装 TokenHot AI Skill。发行清单是 https://codex.tokenhot.ai/manifest.json。下载前校验清单、macOS 安装器和 Skill ZIP 的大小与 SHA-256,不要通过管道执行远程脚本。安装后打开 Terminal 运行 setup-unix.sh,让我在终端中隐藏输入 TokenHot API Key;不要在对话或命令参数中索取 Key。配置成功后自动运行 doctor --json 并告诉我结果。

Linux#

请安装 TokenHot AI Skill。发行清单是 https://codex.tokenhot.ai/manifest.json。下载前校验清单、Linux 安装器和 Skill ZIP 的大小与 SHA-256,不要通过管道执行远程脚本。安装后打开可交互终端运行 setup-unix.sh,让我在终端中隐藏输入 TokenHot API Key;不要在对话或命令参数中索取 Key。配置成功后自动运行 doctor --json 并告诉我结果;如果无法打开图形终端,再给我一条可复制的本机命令。
安装路径默认为:
平台路径
Windows%USERPROFILE%\.codex\skills\tokenhot-ai
macOS/Linux$HOME/.codex/skills/tokenhot-ai
设置 CODEX_HOME 时,Skill 会安装到 $CODEX_HOME/skills/tokenhot-ai。

2. 终端安装命令#

如果你想自行安装,请按系统选择一段命令。macOS/Linux 需要 pwsh、curl、unzip 与 python3。

Windows(PowerShell)#

$installer = Join-Path $env:TEMP 'install-tokenhot.ps1'
Invoke-WebRequest 'https://codex.tokenhot.ai/install-tokenhot.ps1' -OutFile $installer
& $installer -ManifestUrl 'https://codex.tokenhot.ai/manifest.json'

macOS(Terminal)#

Linux(Terminal)#

如果提示已安装,Windows 在最后加 -Update;macOS/Linux 在最后加 --update。更新会先创建备份,不会删除已保存的 API Key。

3. 手动放置文件夹(离线安装)#

可以不运行安装器。下载 TokenHot AI Skill 0.11.6 ZIP,解压后把其中的 tokenhot-ai 文件夹复制到下面目录:
平台目标目录
Windows%USERPROFILE%\.codex\skills\tokenhot-ai
macOS/Linux${CODEX_HOME:-$HOME/.codex}/skills/tokenhot-ai
复制完成后,目录应当直接包含 SKILL.md、scripts/、references/ 和 agents/:
.../skills/tokenhot-ai/SKILL.md
.../skills/tokenhot-ai/scripts/tokenhot.ps1
如果原目录已经存在,先改名或备份旧的 tokenhot-ai 文件夹,再替换。随后按下方步骤配置 Key,并新建一个 Codex 任务或重启 Codex。

4. 配置 API Key(未自动弹出窗口时)#

使用上面的“让 Codex 安装”指令时,Codex 会在安装完成后打开独立终端,并提示你在那里输入隐藏的 Key。保存成功后会自动继续 doctor 检查;不需要回到对话确认。只有窗口没有弹出、等待超时或检测失败时,才在本机终端运行下面的对应命令。

Windows#

& "$env:USERPROFILE\.codex\skills\tokenhot-ai\scripts\setup-windows.ps1"

macOS#

Linux#

Windows 使用 DPAPI,macOS 使用 Keychain,Linux 使用 Secret Service 保存 Key。Linux 没有密钥环时,可在启动 Codex 的进程中设置 TOKENHOT_API_KEY。

5. 检查是否成功#

Windows#

& "$env:USERPROFILE\.codex\skills\tokenhot-ai\scripts\tokenhot.ps1" doctor -Json

macOS#

Linux#

成功时会返回 Skill 版本、TokenHot API 连通状态、可用模型数量和默认模型状态。

6. 开始使用#

用户可以通过调用Tokenhot的模型
$tokenhot-ai 请列出当前可用模型,并标出聊天、图片和视频的默认模型。
列出模型列表
$tokenhot-ai 
调用模型
聊天模型不能直接联网、读写文件或执行其他 Skill;这些能力始终由 Codex 在获得用户授权后执行,再把必要结果交给外部模型。图片和视频生成结果会保存到 outputs/tokenhot/,除非你指定其他目录。
Previous
Codex CLI安装
Built with