Nbility logoNbility Docs

Search documentation

Search guides and API reference content

从零开始，5 分钟上手 AI 编程工具。

目录

一、为什么需要 Nbility

这两年，AI 编程工具进步非常快。

像 Claude Code、Codex 这样的工具，已经不只是“聊天问答”了。它们可以理解项目代码、帮你写文件、排查报错、执行命令，很多时候就像一个真的在终端里协助你的工程师。

但对国内用户来说，真正开始用时，常常会遇到几个现实问题：

  • 需要科学上网，环境折腾成本高
  • 官方订阅价格不低，长期使用压力大
  • 账号存在风控和封号风险
  • 直接走 API 时，很容易不知不觉把成本打爆

Nbility 的意义，就是把这些门槛尽量压低，让你可以先把工具用起来，而不是先被环境问题拦住。

二、这些工具是什么

2.1 OpenAI 和 Anthropic

可以先把这两家公司理解成 AI 模型提供方。

  • OpenAI：主要提供 GPT 系列模型，也和 Codex 生态相关
  • Anthropic：主要提供 Claude 系列模型，也就是 Claude Code 背后的核心能力来源

它们负责训练模型、提供调用接口，而你平时看到的很多 AI 工具，本质上是在调用这些模型。

2.2 ChatGPT 和 Claude

ChatGPT 和 Claude 都是网页或 App 里的 AI 对话产品，适合聊天、写作、总结、问答、辅助思考。

如果你之前已经用过 ChatGPT 或 Claude，可以把它理解为：

  • 面向普通用户的使用入口
  • 打开网页就能对话
  • 更偏“聊天式交互”

2.3 Codex 和 Claude Code

Codex 和 Claude Code 更像是终端里的 AI 助手。

它们和普通聊天工具最大的区别是：

  • 可以在终端中运行
  • 能读取和修改本地项目文件
  • 能帮助你执行开发任务、定位错误、理解代码结构

如果说 ChatGPT 和 Claude 更像“聊天顾问”，那么 Codex 和 Claude Code 更像“能直接进工作台帮你干活的助手”。

三、什么是终端

很多新手第一次接触 Claude Code 或 Codex，最大的心理门槛其实不是 AI，而是“终端”。

你可以把终端理解成一个输入命令的窗口。很多开发工具都通过它启动。

常见打开方式：

  • Windows：按 Win + R，输入 cmd；或者打开开始菜单，搜索 Terminal
  • Mac：按 Command + 空格，输入 Terminal，回车打开

第一次看到黑色或白色的命令行窗口很正常，不用怕。你后面常用的操作，往往只是复制一条命令、回车执行而已。

四、工具运行在哪

很多人会误以为 Claude Code、Codex 是“装在自己电脑里”的完整 AI。

更准确地说，它们是：

  • 在你的本地电脑里启动
  • 再通过网络连接云端 AI 模型

也就是说，这类工具通常是“本地操作 + 云端推理”的组合。

所以你需要：

  • 一台自己的电脑
  • 正常联网环境
  • 一个可用的 API Key

五、什么是 API

API 可以理解成“让软件调用 AI 的通道”。

你在网页里和 ChatGPT 聊天，是人在直接使用 AI；而 Claude Code、Codex 这种工具，则是软件通过 API 去调用 AI。

所以当你使用 Claude Code、Codex 时，它们并不是自己会思考，而是通过你配置好的接口，把请求发到云端模型，再把结果返回给你。

这也是为什么你经常会听到这些词：

  • API Key
  • Base URL
  • 模型名称

它们都是工具接入 AI 服务时要用到的基本信息。

六、为什么很多人用不好

工具本身很强，但很多人并不是输在能力，而是输在接入成本和环境问题。

6.1 官方订阅有成本

很多官方产品按月订阅，长期用下来并不便宜。

对于只是想试试、偶尔写代码、或者还在学习阶段的用户来说，一上来就承受稳定的美元月费，门槛并不低。

6.2 国内风控风险

不少用户会遇到：

  • 网络环境不稳定
  • 机房 IP 容易被识别
  • 登录或支付时触发风控
  • 账号后续出现限制甚至被封

这些问题和“你会不会写代码”没关系，但会直接影响能不能顺利用上工具。

6.3 API 成本容易失控

很多人觉得 API 是按量计费，看起来很灵活，但一旦没有概念，很容易超预算。

比如你连续让工具读取大项目、反复改代码、长时间追问复杂问题，费用会比想象中增长得快。有些人第一次认真使用，就可能打到接近 ¥700 的量级，事后才发现。

这也是为什么“能不能控制成本”是新手接入时非常重要的一步。

七、Nbility 是什么

Nbility 可以理解为一个统一的 AI API 网关。

它的核心作用不是重新训练模型，而是帮你更顺畅地接入和使用已有模型服务。

对新手来说，最直接的价值在于：

  • 一个 API Key 可以接入 40+ AI 模型
  • 不需要为不同模型反复折腾多个账号
  • 可以按分组使用，管理模型和成本更直观
  • 更适合国内用户完成实际接入

如果你只是想尽快把 Claude Code、Codex、Cursor 这些工具跑起来，Nbility 的重点不是“概念更高级”，而是“接入更省事”。

八、遇到报错怎么办

报错是正常现象，尤其是第一次装命令行工具时。

不要把报错理解为“我不适合学这个”，更实际的做法是：看懂现象，逐个排查。

8.1 用 AI 助手排查

你可以把报错截图发给豆包、ChatGPT 或其他 AI 助手，让它帮助你判断问题方向。

如果你完全是新手，建议明确告诉对方：

  • 你是命令行新手
  • 你当前做到哪一步了
  • 你希望它一步一步带你排查

8.2 怎么截图

  • Mac：按 Cmd + Shift + 4
  • Windows：按 Win + Shift + S

尽量把完整报错、你输入的命令、终端窗口标题都截进去，这样更容易定位问题。

8.3 怎么提问

下面这个提问模板对新手很实用：

我是命令行新手，目标是[你的目标]，请一步步指导我，一次只给一步。

你也可以继续补充：

  • 我现在在第几步
  • 我刚执行了什么命令
  • 报错内容是什么
  • 我使用的是 Mac 还是 Windows

8.4 常见问题对照表

症状先查什么
timeout / ECONNREFUSED代理环境
command not foundPATH 环境变量
Permission denied权限问题
版本不兼容Node.js 版本

8.5 代理环境问题

这是最容易忽略的一类问题。

很多翻墙软件不仅影响浏览器，也会影响终端里的网络请求。有时候网页能打开，但命令行工具请求 API 时却超时、拒绝连接或者走错代理。

遇到这类问题，最简单的处理方法是：

  1. 完全退出代理软件
  2. 关闭当前终端窗口
  3. 重新打开终端
  4. 再执行安装或配置命令

如果这样之后问题消失，基本就说明是代理环境干扰导致的。

九、开始使用注册与充值

第 1 步：注册账号

打开 注册页面，先完成账号注册。

第 2 步：充值

登录后进入控制台，在充值入口完成加款。新手建议先小额充值，确认工具能正常跑通后再逐步增加。

定价说明

Nbility 的一个实用理解方式是：

官方美元价格 × 分组倍率 ÷ 7 = 人民币价格

倍率1 元约等于官方美金额度代表分组
0.2x$5.00codex（GPT 系列）
0.8x$1.25claude（Claude 系列）
1.5x$0.67gemini（Gemini 系列）

第 3 步：创建 API 密钥

进入控制台的令牌页面，点击创建令牌。

建议按工具选择分组：

  • Claude Code：claude / claude-mix
  • Codex：codex

创建完成后复制你的 API Key，后面配置工具时会用到。

十、安装配置工具

安装前检查

如果你电脑里开着翻墙软件，先完全退出，再重开终端。这样能减少安装阶段很多莫名其妙的超时问题。

第 4 步：安装 Node.js

Node.js 是 Claude Code 和 Codex 常见的安装前提。

Mac：

  • 前往 Node.js 官网下载安装 LTS 版本

Windows：

winget install OpenJS.NodeJS.LTS

安装后验证：

node -v
npm -v

第 5 步：安装 Codex CLI

Mac：

sudo npm install -g @openai/codex@latest

Windows：

npm install -g @openai/codex@latest

验证是否安装成功：

codex --version

第 6 步：安装 Claude Code

Mac：

sudo npm install -g @anthropic-ai/claude-code@latest

Windows：

npm install -g @anthropic-ai/claude-code@latest

验证是否安装成功：

claude --version

第 7 步：配置 API

你可以用两种方式配置。

方法一：在令牌页面点击 CC-Switch 按钮，一键导入配置。

方法二：手动配置环境变量。

Claude Code：

export ANTHROPIC_BASE_URL=https://api.nbility.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key

Codex：

export OPENAI_API_KEY=sk-your-key
export OPENAI_BASE_URL=https://api.nbility.dev/v1

如果你是 Windows 用户，环境变量写法会不同，但核心信息是一样的：一个 Key，加一个正确的 Base URL。

十一、入门使用

11.1 使用前确认

正式开始前，请确认这三件事：

  • 令牌里有余额
  • 环境变量已经配置完成
  • 终端已经打开

11.2 先用哪个

如果你还不知道先从哪个工具开始，可以这样选：

  • Claude Code：更适合聊天、思考、讨论方案
  • Codex：更适合直接执行任务、排查问题、动手改项目

你不需要一开始就全会。先把一个工具跑通，再慢慢扩展即可。

11.3 启动 Claude Code

在终端输入：

claude

11.4 启动 Codex

在终端输入：

codex

如果命令能正常启动，说明你已经完成最关键的第一步。