ZCF - Nbility AI 网关

ZCF 是面向 Claude Code 和 Codex 的增强工具，目标是把初始化配置、工作流模版和 MCP 服务接入尽量收敛到一条命令里。

如果你还没有可用的 Nbility 账号和令牌，建议先去新手指南完成准备，再继续下面的配置。

ZCF 能做什么

常见用途包括：

帮你快速写入 API 提供商配置
安装常用开发工作流
接入 MCP 服务
统一语言、模板和输出风格

对于希望尽量减少手工配置的人，这种方式会更省事。

常用初始化参数

API 相关

参数	作用
`-p custom`	使用自定义提供商，接入 Nbility 时常用
`-t api_key`	与上面的方式等价，也表示使用 API Key
`-k "sk-xxx"`	传入你的令牌
`-u "https://api.nbility.dev/"`	指定 Nbility 的基础地址
`-M "claude-sonnet-4-5-20250929"`	设置主模型
`-H "claude-haiku-4-5-20251001"`	设置快速模型

例如：

npx zcf i -s -t api_key -k "sk-xxx" -u "https://api.nbility.dev/" \
  -M "claude-sonnet-4-5-20250929" \
  -H "claude-haiku-4-5-20251001"

工作流相关

参数	作用
`-w all`	安装全部工作流
`-w sixStepsWorkflow,gitWorkflow`	只装指定工作流
`-w skip`	不安装工作流

可选项通常包括 commonTools、sixStepsWorkflow、featPlanUx、gitWorkflow、bmadWorkflow。

MCP 服务相关

参数	作用
`-m all`	安装全部 MCP 服务
`-m context7,open-websearch`	仅安装部分服务
`-m skip`	跳过 MCP 配置

可选服务有 context7、open-websearch、spec-workflow、mcp-deepwiki、Playwright、exa、serena。

其他常见参数

参数	作用
`-g zh-CN`	统一为中文界面与中文输出
`-s`	关闭交互提示，适合脚本执行
`-r backup`	决定已有配置如何处理
`-x false`	不安装额外状态栏能力

典型命令

如果你想快速完成一轮初始化，可以从下面这种方式开始：

npx zcf i -s -t api_key -k "sk-xxx" -u "https://api.nbility.dev/" -g zh-CN

这里的 sk-xxx 需要换成你在 /console/token 获取到的真实令牌。

可用工作流命令

安装完毕后，在 Claude Code 里通常可以直接调用这些斜杠命令：

命令	用途
`/zcf:workflow`	六阶段研发流程
`/zcf:feat`	用于新功能规划与实现
`/zcf:git-commit`	生成提交信息
`/zcf:git-rollback`	回退历史版本
`/zcf:git-worktree`	管理 worktree
`/zcf:bmad-init`	启动更完整的敏捷流程

MCP 服务速览

MCP 可以让你的编码工具连接外部文档、搜索和自动化能力。ZCF 内置服务大致如下：

服务	说明	是否额外需要 Key
`context7`	查询库的最新文档和示例	否
`open-websearch`	进行网页搜索	否
`spec-workflow`	按需求、设计、实现的结构组织工作	否
`mcp-deepwiki`	查看 GitHub 仓库资料	否
`Playwright`	浏览器自动化与截图	否
`exa`	语义搜索能力	是
`serena`	更接近 IDE 的代码检索体验	否

下面是几项常见用途：

context7：适合查最新 API 文档，避免模型引用过期写法
open-websearch：适合做网页检索，不需要自己额外接 API
spec-workflow：适合把需求到实现拆成结构化步骤
Playwright：适合需要自动点页面、填表单或截图的场景

如果你使用 exa，还需要单独设置：

export EXA_API_KEY="your-api-key"

配置文件位置

安装完成后，MCP 相关配置一般会写进 ~/.claude/settings.json，结构大致如下：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context-labs/context7"]
    },
    "open-websearch": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-open-websearch"]
    }
  }
}