猫肥 NekoAPI 使用教程

本文档介绍如何创建 API Key，并将 Claude Code、Codex、Cherry Studio、Chatbox 等客户端接入猫肥 NekoAPI。按顺序完成令牌、Base URL 和模型配置后，即可开始调用。

说明Claude Code / Anthropic 路线使用 https://api.999555999.com；OpenAI Compatible 路线使用 https://api.999555999.com/v1。

Claude Code 配置 Claude Code IDE 配置 Codex 安装配置 Codex IDE 配置 Chatbox CC Switch Cherry Studio 令牌创建 & Token 获取

Claude Code 配置

本章节分别介绍 macOS 与 Windows 环境下 Claude Code CLI 的安装流程，以及如何接入猫肥 NekoAPI 节点。

Mac 安装教程

使用 Homebrew 安装 Node.js

Claude Code 依赖 Node.js 运行时。macOS 推荐通过 Homebrew 管理 Node.js 版本。

安装 Homebrew

bash

# 下载并安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装 Node.js 并验证版本

bash

brew install node

node -v
npm -v

安装 Claude Code

全局安装 Claude Code CLI

bash

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

验证安装

bash

claude --version
# Claude Code x.x.x

如遇到权限问题，可在命令前加 sudo，或将 npm 全局目录配置到当前用户目录。

运行健康检查

bash

claude doctor

此命令会检测本机环境、登录状态和 API 连接状态。

提示如果 npm 安装速度慢，可临时切换镜像：npm config set registry https://registry.npmmirror.com。

配置 AUTH_TOKEN 与 BASE_URL

配置后，Claude Code 会通过猫肥 NekoAPI 调用 Claude 模型。

说明进行这一步前，请先在控制台创建 API Key；如果还没有创建，请先看文末「令牌创建 & Token 获取」。

方式一：写入 Shell 环境变量（推荐）

将以下配置写入 ~/.zshrc 或 ~/.bashrc：

~/.zshrc

# 猫肥 NekoAPI - Claude Code 配置
export ANTHROPIC_AUTH_TOKEN="sk-your-token"
export ANTHROPIC_BASE_URL="https://api.999555999.com"

bash

source ~/.zshrc

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

方式二：交互式登录

也可以直接运行 claude，按 CLI 提示输入 Token 和 Base URL：

bash

claude
# > Enter your API key: sk-your-token
# > Enter API base URL (optional): https://api.999555999.com

验证连接

bash

claude "你好，请用一句话介绍你自己"
# 我是 Claude，Anthropic 开发的 AI 助手。

Windows 安装教程

注意系统要求：Windows 10 版本 1809 / build 17763 及以上。

使用 PowerShell 安装 Node.js

以管理员身份打开 PowerShell

右键「开始」菜单，选择「Windows PowerShell（管理员）」或「终端（管理员）」。

安装 Chocolatey 和 Node.js

powershell

# 安装 Chocolatey
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# 安装 Node.js LTS
choco install nodejs-lts -y

node -v
npm -v

安装 Claude Code

全局安装 Claude Code CLI

powershell

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

验证安装

powershell

claude --version
# Claude Code x.x.x

claude doctor

提示如果 npm 安装很慢，可先执行 npm config set registry https://registry.npmmirror.com。

配置 AUTH_TOKEN 与 BASE_URL

方式一：PowerShell Profile（推荐）

先打开当前用户的 PowerShell Profile：

$PROFILE

if (!(Test-Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force }
notepad $PROFILE

在文件末尾添加并保存：

$PROFILE

# 猫肥 NekoAPI - Claude Code 配置
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-token"
$env:ANTHROPIC_BASE_URL   = "https://api.999555999.com"

powershell

. $PROFILE

方式二：系统环境变量（GUI）

适合不常用命令行的用户：打开「系统属性」→「高级」→「环境变量」，在「用户变量」中新增：

变量名变量值

ANTHROPIC_AUTH_TOKENsk-your-token

ANTHROPIC_BASE_URLhttps://api.999555999.com

保存后需要重启终端、IDE 或电脑，新的环境变量才会被读取。

验证连接

powershell

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

claude "你好，请用一句话介绍你自己"

注意请妥善保管 API Key，不要提交到 Git 仓库，也不要发到截图、群聊或公开网页。

Codex 安装配置

Codex 使用 OpenAI 兼容格式接入猫肥 NekoAPI，需要配置 Base URL、API Key 和模型提供商信息。

安装

安装 Codex CLI

bash

npm install -g @openai/codex

bash

codex --version

创建 Codex 配置目录

powershell

# Windows
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"

bash

# macOS / Linux
mkdir -p ~/.codex

配置

写入 config.toml

~/.codex/config.toml

model_provider = "nekoapi"
model = "gpt-4o"

[model_providers.nekoapi]
name = "NekoAPI"
base_url = "https://api.999555999.com/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

设置 API Key

临时测试可直接在当前终端设置：

powershell

# Windows PowerShell
$env:OPENAI_API_KEY = "sk-your-token"
codex "Hello"

bash

# macOS / Linux
export OPENAI_API_KEY="sk-your-token"
codex "Hello"

持久化 API Key

如果你使用的 Codex 版本读取 auth.json，也可以保存到配置目录：

~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-your-token"
}

验证配置

bash

codex "请回复你当前运行的模型名称"

说明model 请按猫肥 NekoAPI 控制台当前可用的模型 ID 填写，例如 gpt-4o 或你的分组已开放模型。

Claude Code IDE 配置

在编辑器中安装 Claude Code 扩展后，可以在侧边栏与 Claude 对话、执行代码分析，并让它协助修改项目文件。

提示本教程适用于 VS Code、Cursor、Windsurf、Trae 等基于 VS Code 内核的 IDE。

说明前置条件：先完成「Claude Code 配置」里的 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 设置。

安装扩展

打开扩展面板

在 IDE 中按 Ctrl+Shift+X，macOS 可使用 Shift+Command+X。

搜索 Claude Code 并安装

text

Claude Code

选择由 Anthropic 发布的扩展并点击安装，注意核对发布者，避免安装同名仿冒扩展。

也可以使用命令行安装

bash

# VS Code
code --install-extension anthropic.claude-code

# Cursor
cursor --install-extension anthropic.claude-code

# Windsurf
windsurf --install-extension anthropic.claude-code

# Trae
trae --install-extension anthropic.claude-code

注意Cursor、Windsurf、Trae 可能使用 Open VSX 扩展源。如果扩展市场搜索不到，可下载对应 .vsix离线包，然后从扩展面板右上角菜单选择「从 VSIX 安装」。

配置认证

从终端启动 IDE

为确保 IDE 继承 Shell 环境变量，建议从已配置好的终端中启动项目：

bash

# VS Code
code .

# Cursor
cursor .

# Windsurf
windsurf .

# Trae
trae .

Windows 用户确认系统环境变量

如果你平时双击图标打开 IDE，请把 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 写入系统环境变量，并重启 IDE。

在 IDE 中验证

打开 Claude Code 面板，发送一个简单问题；如果控制台请求日志正常出现，说明 IDE 已成功读取配置。

Codex IDE 配置

Codex IDE 扩展复用 Codex CLI 的配置文件。核心是确保 IDE 能读取 ~/.codex/config.toml 和 API Key。

说明前置条件：先完成「Codex 安装配置」章节，确保本机已有 Codex CLI 配置。

安装扩展

打开扩展面板

在 IDE 中按 Ctrl+Shift+X，macOS 可使用 Shift+Command+X。

搜索 Codex 并安装

text

Codex

选择 OpenAI 发布的官方扩展。扩展市场中同名插件较多，请优先核对发布者。

也可以使用命令行安装

bash

# VS Code
code --install-extension openai.chatgpt

# Cursor
cursor --install-extension openai.chatgpt

# Windsurf
windsurf --install-extension openai.chatgpt

# Trae
trae --install-extension openai.chatgpt

配置认证

确认 config.toml

~/.codex/config.toml

model_provider = "nekoapi"
model = "gpt-4o"

[model_providers.nekoapi]
name = "NekoAPI"
base_url = "https://api.999555999.com/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

确认 API Key

Windows 用户可用系统环境变量，也可以在 PowerShell Profile 中写入：

powershell

$env:OPENAI_API_KEY = "sk-your-token"

macOS / Linux 用户可写入 ~/.zshrc：

bash

export OPENAI_API_KEY="sk-your-token"

重启 IDE 并验证

完全退出并重新打开 IDE，在 Codex 面板发送测试消息：

text

请回复你当前运行的模型名称

注意Windows 下配置目录通常是 %USERPROFILE%\.codex\。修改配置后必须重启 IDE，扩展才会重新读取文件和环境变量。

Chatbox

Chatbox 是跨平台 AI 聊天客户端，支持 macOS、Windows、Linux、Android、iOS。它可以通过 Claude API 或 OpenAI 兼容接口接入猫肥 NekoAPI。

下载安装

下载 Chatbox

访问 chatboxai.app，下载对应平台的安装包。桌面端与移动端配置方式一致。

配置接入

按目标模型族选择一种配置方式。

方式 A：使用 Claude 系列模型

打开设置 → 模型

点击 Chatbox 左下角齿轮图标进入设置，选择「模型」标签页。

模型提供方选择 Claude API

字段取值

API Hosthttps://api.999555999.com

API Keysk-your-token

Model按控制台可用 Claude 模型填写

方式 B：使用 GPT 系列模型

模型提供方选择 OpenAI API

字段取值

API Hosthttps://api.999555999.com/v1

API Keysk-your-token

Model按控制台可用 GPT 模型填写

提示填写完成后点击「保存」，新建会话发送一条消息，能正常收到回复即表示配置成功。

CC Switch

CC Switch 用于统一管理 Claude Code、Codex、Gemini CLI 等命令行工具的供应商配置。它会替你修改底层 CLI 配置文件，实现一键切换。

说明官网：ccswitch.io；源码：github.com/farion1231/cc-switch。

下载安装

下载对应系统安装包

从官网或 GitHub Releases 页面下载。macOS 首次启动若被系统拦截，可在「系统设置 → 隐私与安全性」中放行。

前置条件：先装好 CLI

CC Switch 在 ~/.claude/ 与 ~/.codex/ 目录之上运作，请先完成 Claude Code 或 Codex 的基础安装。

新增供应商

Claude Code 供应商

切到 Claude Code 标签页

在 CC Switch 顶部标签栏切换到「Claude Code」，点击「添加供应商」。

填写猫肥 NekoAPI 配置

字段取值

Name猫肥 NekoAPI

ANTHROPIC_BASE_URLhttps://api.999555999.com

ANTHROPIC_AUTH_TOKENsk-your-token

Codex 供应商

切到 Codex 标签页并添加供应商

字段取值

Name猫肥 NekoAPI

base_urlhttps://api.999555999.com/v1

wire_apiresponses

model按控制台可用模型填写

OPENAI_API_KEYsk-your-token

切换与验证

一键切换

在供应商列表中点击「猫肥 NekoAPI」。CC Switch 会自动改写 Claude Code 或 Codex 的相关配置文件。

在终端验证

bash

# Claude Code
claude "Hello"

# Codex
codex "Hello"

注意如果 CLI 已经在运行，需要重启 CLI 才能让新配置生效。

Cherry Studio

Cherry Studio 是支持 Windows、macOS、Linux 的桌面 AI 客户端，可通过自定义模型服务商接入猫肥 NekoAPI。

说明下载地址：cherry-ai.com。

下载安装

按平台安装

从官网下载对应系统安装包，安装完成后启动应用。

添加服务商

打开设置 → 模型服务

点击左下角齿轮图标进入设置，左侧菜单选择「模型服务」或「服务商」。

新增 OpenAI Compatible 服务商

字段取值

服务商类型OpenAI Compatible

服务商名称猫肥 NekoAPI

API 地址https://api.999555999.com/v1

API Keysk-your-token

提示如果要走 Claude 原生协议，可将服务商类型改为 Anthropic，API 地址填写 https://api.999555999.com。

添加模型

手动添加模型 ID

Cherry Studio 通常不会自动拉取模型列表，需要在服务商详情页点击「添加模型」，填入控制台中可用的模型 ID。

text

gpt-4o
gpt-4.1
claude-sonnet-4-5
claude-opus-4-1

启用服务商并设置默认模型

打开服务商开关，回到对话界面，从模型下拉框选择刚添加的猫肥 NekoAPI 模型并发送测试消息。

注意如果模型名填写错误或当前分组未开通，请求通常会返回 404 或权限错误。

令牌创建 & Token 获取

使用猫肥 NekoAPI 前，需要先登录控制台并创建 API Key。建议给不同客户端分别创建独立令牌，便于权限隔离和问题排查。

访问猫肥 NekoAPI 官网

在浏览器中打开 999555999.com/login，进入登录 / 注册页面。

创建账号

选择注册方式：

›邮箱注册（推荐）：填写邮箱和密码，完成邮箱验证

登录控制台

注册完成后，进入 Dashboard 控制台，即可查看账号余额、使用量统计等信息。

令牌创建

进入令牌管理

在控制台中找到「令牌」或「API Key」页面，点击「创建令牌」。

填写令牌名称

建议按用途命名，方便后续排查请求日志和权限问题。

text

Claude Code - Windows
Codex - Desktop
Cherry Studio - Desktop
Chatbox - Mobile

配置权限与额度

按需要绑定分组、模型权限、图片生成权限和额度限制。正式使用前建议先设置较小额度测试。

复制 Token 和 Base URL

text

OpenAI Compatible:
Base URL: https://api.999555999.com/v1
API Key:  sk-your-token

Claude Code / Anthropic:
Base URL: https://api.999555999.com
API Key:  sk-your-token

小额测试

正式使用前，先用简单问题测试文本、图片、余额扣费、请求日志是否正常。确认无误后再扩大使用范围。

注意Token 只在创建时最容易完整复制。保存后请妥善保管；如果怀疑泄露，立即在控制台禁用或删除。