NoneLinear 生图 Skill 可以让 Claude Code、Codex 等 Agent 工具通过自然语言生成图片、编辑本地图片或融合多张参考图，无需手动编写 API 请求。 当前版本：0.3.0

​
支持能力

  • 文生图
  • 单图编辑
  • 多图融合
  • 本地图片安全上传
  • 自动处理不同模型的参数差异
  • 返回可直接访问的图片 URL
  • 阻止 base64 图片进入 Agent 上下文

​
下载

推荐下载 Universal ZIP：

​
环境要求

  • Node.js 18 或更高版本
  • Agent 可以执行本地 Node.js 命令
  • 拥有可用的 NoneLinear API Key
Skill 自带无第三方依赖的脚本，不需要安装 NoneLinear CLI，也不需要运行 npm install。

​
API Key 自动复用

如果 Claude Code、Codex 或 cc-switch 已经配置并正在使用 NoneLinear API，生图 Skill 通常可以直接复用当前 Agent 进程中的 API Key，不需要重复配置。
Skill 按以下顺序读取凭据：
优先级环境变量使用条件
1NONELINEAR_API_KEY直接作为 NoneLinear API Key 使用
2OPENAI_API_KEYOPENAI_BASE_URL 必须指向 api.nonelinear.com
3ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEYANTHROPIC_BASE_URL 必须指向 api.nonelinear.com
因此：
  • Codex 已通过 OPENAI_API_KEY 和 NoneLinear Base URL 接入时，Skill 可以复用该凭据。
  • Claude Code 已通过 Anthropic 环境变量和 NoneLinear Base URL 接入时，Skill 可以复用该凭据。
  • cc-switch 将当前配置注入 Agent 子进程时，Skill 也可以直接复用。
出于安全考虑，只有 Base URL 的 HTTPS 主机名严格等于 api.nonelinear.com 时，Skill 才会复用 OpenAI 或 Anthropic 凭据，避免把其他平台的 API Key 用于生图请求。 Skill 不会读取 Claude Code、Codex 或 cc-switch 的配置文件和数据库。如果宿主没有把凭据传入 Skill 子进程，会返回： 
missing_api_key
只有出现该错误时，才需要单独配置 NONELINEAR_API_KEY。

​
手动配置备用凭据

macOS / Linux： 
export NONELINEAR_API_KEY="nl-xxx"
Windows PowerShell： 
$env:NONELINEAR_API_KEY="nl-xxx"
Windows CMD： 
set "NONELINEAR_API_KEY=nl-xxx"
配置后需要重新启动 Agent 或新建会话。不要把真实 API Key 写入 Skill 文件、项目文件或聊天消息。

​
安装到 Claude Code

macOS / Linux： 
mkdir -p ~/.claude/skills
unzip nonelinear-image-0.3.0.zip -d ~/.claude/skills
Windows PowerShell： 
New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills" | Out-Null
Expand-Archive .\nonelinear-image-0.3.0.zip -DestinationPath "$HOME\.claude\skills" -Force
安装后新建 Claude Code 会话： 
/nonelinear-image 生成一张 1:1 产品图：白色陶瓷马克杯放在胡桃木桌面上，清晨自然光，真实摄影风格。

​
安装到 Codex

macOS / Linux： 
mkdir -p ~/.agents/skills
unzip nonelinear-image-0.3.0.zip -d ~/.agents/skills
Windows PowerShell： 
New-Item -ItemType Directory -Force -Path "$HOME\.agents\skills" | Out-Null
Expand-Archive .\nonelinear-image-0.3.0.zip -DestinationPath "$HOME\.agents\skills" -Force
安装后新建 Codex 会话： 
使用 $nonelinear-image 生成一张 16:9 图片：雨后的上海街道，霓虹灯倒映在路面，电影摄影风格。

​
其他工具

TRAE 可以将 Skill 放到项目目录： 
<project>/.trae/skills/nonelinear-image/SKILL.md
Cherry Studio、WorkBuddy 等支持 Skills 管理的工具，可以直接导入 nonelinear-image-0.3.0.zip。 TRAE、Cherry Studio、WorkBuddy 的不同版本可能存在导入入口、环境变量继承和本地命令权限差异。

​
图片编辑

编辑公开图片： 
使用 nonelinear-image 编辑 https://example.com/product.png，把背景替换成浅灰色摄影棚，保留产品外观。
编辑本地图片： 
使用 nonelinear-image 编辑本地图片 /home/user/images/product.png，把背景替换成浅灰色摄影棚。不要读取或附加图片，直接把路径交给 Skill。
Windows 示例： 
使用 nonelinear-image 编辑本地图片 C:\Users\user\Pictures\product.png，把背景替换成浅灰色摄影棚。不要读取或附加图片，直接把路径交给 Skill。

​
多图融合

使用 nonelinear-image 融合 /home/user/product.png 和 /home/user/scene.png，把第一张图的产品自然放入第二张图的场景，保持产品外观和比例。
本地路径和公开 HTTPS URL 可以混合使用，参考图顺序会被保留。

​
安全与计费

  • 图片生成请求发送到 https://api.nonelinear.com/v1/images/generations。
  • 本地图片只会上传到固定的 https://nonelinear.com/api/upload-file。
  • API Key、Authorization Header、base64 和完整请求体不会出现在 Agent 回复中。
  • 每次生成请求都可能产生费用。
  • Skill 不会在失败后自动重新生成，避免重复计费。
  • 用户指定模型时，Skill 不会静默切换到其他模型。

​
常见问题

​
Skill 没有被识别

确认解压后的目录结构为： 
nonelinear-image/
├── SKILL.md
├── agents/
├── references/
└── scripts/
安装后需要新建 Claude Code 或 Codex 会话。

​
返回 missing_api_key

说明宿主没有把现有 NoneLinear 凭据传给 Skill 子进程。此时可以单独设置 NONELINEAR_API_KEY，然后重新打开 Agent。

​
返回 Node.js 版本错误

执行： 
node --version
需要 Node.js 18 或更高版本。

​
请求成功但没有图片

部分模型可能返回文本结果、空图片数组或内容策略错误。Skill 会将其视为失败，不会自动重试。可以修改 Prompt 后再次主动发起请求。