必须打通hf CLI认证、Codex插件加载路径、Spaces模型URL解析三者链路；需安装登录Hugging Face CLI、启用v0.4.2+ hf-spaces插件、在Codex中用@space://格式调用模型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Linux系统上让Codex直接调用Hugging Face Spaces托管的AI模型，必须打通hf CLI认证、Codex插件加载路径、Spaces模型URL解析三者之间的链路，缺一不可——否则Codex会报错“model not found”或“unauthorized access”，实际是认证未透传、插件未识别、URL未标准化导致。
安装并登录 Hugging Face CLI
执行官方一键安装脚本，自动适配当前Linux发行版架构：
curl -LsSf https://hf.co/cli/install.sh | bash
安装完成后，必须在当前Shell会话中重新加载PATH，否则后续命令会提示“command not found”：
source ~/.bashrc
运行登录命令，按提示输入Hugging Face账号密码（注意：不能用GitHub第三方登录，必须原生账号）：
hf login
【必须确认终端输出包含“Authentication successful”且 ~/.huggingface/token 文件已生成】
配置 Codex 插件支持 Spaces 模型
Codex本身不内置Spaces支持，需手动启用hf插件模块。先确认Codex已全局安装并可执行：
codex --version
进入Codex插件目录（路径因Node.js全局安装方式而异，常见位置如下）：
cd $(npm root -g)/codex/node_modules/@codex-engine/plugins
克隆官方hf-space插件仓库（注意：必须使用v0.4.2以上版本，旧版不兼容Spaces v2 API）：
git clone --branch v0.4.2 https://github.com/codex-plugins/hf-spaces.git
安装依赖并构建插件：
cd hf-spaces → npm install → npm run build
返回上层目录，编辑Codex主配置文件config.toml，在[plugins]段落下添加启用项：
[plugins]
hf-spaces = true
在 Codex 中调用 Spaces 模型
第一步：打开任意代码文件，光标置于空行
第二步：输入指令前缀 @space://，后接Spaces模型路径，格式为：
@space://<username>/<repo-name>
例如调用 clearmatte-studio 模型，应输入：
@space://huqi/clearmatte-studio
第三步：按下 Tab 键触发自动补全，Codex会向Hugging Face API发起校验请求，返回可用端点列表
第四步：选择目标Space端点（如 /api/predict），Codex自动生成调用代码块并插入当前光标位置
注意：若补全失败，请检查 ~/.huggingface/token 是否被Codex进程读取——可临时复制该文件到 $HOME/.codex/hf-token 以绕过权限限制
