One API 实用指南：让AI模型管理变得超简单

你是不是也有这种感受：手里攒了一堆各种AI平台的API密钥，OpenAI的、Claude的、通义千问的、文心一言的...每次想用的时候都要翻来覆去找密钥，换个应用又要重新配置一遍，简直要被这些密钥搞疯了？ 今天给你推荐一个神器：**One API**，一个能让你告别密钥管理噩梦的开源项目。 ## One API 是什么？ 简单说，One API 就是一个"万能转换器"。它支持 OpenAI、Azure、Anthropic Claude、Google Gemini、DeepSeek、字节豆包、ChatGLM、文心一言、讯飞星火、通义千问、360 智脑、腾讯混元等主流模型，统一 API 适配，可用于 key 管理与二次分发。 想象一下，你有一堆不同品牌的充电器，One API 就像是一个万能充电头，不管什么设备都能用同一个接口充电。所有的AI模型都通过统一的 OpenAI 格式来调用，再也不用记那么多不同的API格式了。 https://appstore.lazycat.cloud/#/shop/detail/in.zhaoj.oneapi ## 快速上手 应用安装后，打开首页  点击右上角登录，默认账号：`root`，密码：`123456`  ### 第二步：添加渠道（也就是你的各种API） 点击"渠道"菜单，添加你的API密钥：  **OpenAI配置示例：** - 渠道名称：OpenAI-GPT4 - 类型：OpenAI - 密钥：sk-xxx（你的OpenAI密钥） - 代理：如果需要代理就填，比如 `http://127.0.0.1:7890` - 模型：gpt-4,gpt-4-turbo,gpt-3.5-turbo **国内模型配置示例：** - 渠道名称：通义千问 - 类型：阿里云 - 密钥：sk-xxx（通义千问的API密钥） - 模型：qwen-turbo,qwen-plus,qwen-max  ### 第三步：创建令牌 在"令牌"页面创建一个新的API密钥，这个密钥就是你以后调用One API时要用的。  可以设置额度限制，比如每月最多花100块钱。  ### 第四步：测试一下  如果没问题的话，这里会显示响应时间  ### 模型重命名和映射 不喜欢记那些奇怪的模型名？可以自己定义： - 把 `gpt-4-turbo` 重命名为 `smart` - 把 `gpt-3.5-turbo` 重命名为 `fast` - 把 `claude-3-sonnet` 重命名为 `claude` 这样调用时就可以用 `"model": "smart"` 了，简单好记。  ### 用量监控和告警 在"日志"页面可以看到详细的调用记录和花费统计。可以定期检查哪些应用用量最大  ### 多用户管理 如果你要给团队或朋友提供API服务： - 创建不同的用户账号 - 给每个用户分配不同的额度  ## 总结 One API 这个项目很实用，特别是对于需要同时使用多个AI模型的开发者。它让原本复杂的多模型管理变得超级简单，而且部署容易、使用方便。 如今各种模型层出不穷，用One API可以轻松纳入囊中，主要原因是它支持随时切换模型，很适合我们这些喜欢尝试各种新模型的人。 总的来说，这个项目解决了一个真实存在的痛点，推荐给所有需要管理多个API的朋友试试！

[新手向]One-api：实现你的Claude Code自由

今天主要想跟大家分享我的懒猫微服+One-api，在本机上搭配 CCswitch 来实现无需订阅实现白嫖 Claude code 的体验。 之前一直感觉懒猫社区中缺少一些第三方软件基础篇的教学，我也作为刚玩懒猫不久的小白，最近也遇到了一些困扰，很多软件不会配置，现在我准备开始慢慢更新一些新手向的简单入门教程，来帮助和我一样的新手玩家快速掌握一些基础用法，如有不妥，希望大佬轻喷。 https://appstore.lazycat.cloud/#/shop/detail/in.zhaoj.oneapi # 主要思路 主要的思路是在开发机上（比如 Windows 或者 macos 上），使用 Claude Code 编码，同时搭配 CC switch 来实现自定义的服务提供商；在懒猫上通过部署 One-api，来给电脑提供 api 调用服务，省去了本机上再开 docker 或者命令行运行 One-api 的麻烦，将其作为一个服务来提供。 # 下载 Claude Code ## ✅ 通用前提 - 安装 [Node.js 18+](https://nodejs.org/en/download/)（必须） - 使用终端工具：Windows 推荐 **Git Bash**，macOS 使用 **Terminal** --- ## 🖥️ Windows 安装步骤 ### 1. 安装必要工具 - 下载并安装 [Node.js](https://nodejs.org/en/download/) - 下载并安装 [Git for Windows](https://git-scm.com/downloads)（选择“Use Git from the Windows Command Prompt”或“Use Git Bash only”均可） > 💡 安装后打开 **Git Bash**（不是 CMD 或 PowerShell） ### 2. 全局安装 Claude Code ```bash npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com ``` > 🇨🇳 国内用户推荐加 `--registry` 参数加速安装 ### 3. 验证安装 & 添加环境变量（如遇 `command not found: claude`） #### 检查 npm 全局路径： ```bash npm config get prefix ``` 通常路径是：`/c/Users/你的用户名/AppData/Roaming/npm` #### 添加到 PATH： ```bash echo 'export PATH="$PATH:/c/Users/你的用户名/AppData/Roaming/npm"' >> ~/.bashrc source ~/.bashrc ``` ### 4. 启动使用 ```bash cd 你的项目目录 claude ``` 看到 `Welcome to Claude Code` 即成功！ --- ## 🍏 macOS 安装步骤 ### 1. 安装 Node.js 下载并安装 [Node.js 18+](https://nodejs.org/en/download/) ### 2. 全局安装 Claude Code ```bash npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com ``` > 🇨🇳 国内用户推荐加镜像加速 ### 3. 验证安装 & 添加环境变量（如遇 `command not found: claude`） #### 检查 npm 全局路径： ```bash npm config get prefix ``` 通常是：`/usr/local/bin` #### 添加到 PATH（Zsh）： ```bash echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.zshrc source ~/.zshrc ``` > ⚠️ 如果你用的是 Bash，请改写为 `~/.bash_profile` 或 `~/.bashrc` ### 4. 启动使用 ```bash cd 你的项目目录 claude ``` 看到 `Welcome to Claude Code` 即成功！ --- ## 📌 小贴士 - 不要用 `sudo npm install -g`，避免权限问题 - 安装后首次运行建议在项目目录中执行 `claude` # 下载 CC switch cc-switch 是一个 Claude Code / Codex / Gemini CLI 全方位辅助工具，统一管理 Claude Code、Codex 与 Gemini CLI 的供应商配置、MCP 服务器、Skills 扩展和系统提示词。其提供了图形界面方便我们轻松修改 Claude code 的 api 配置。  ## 安装 ### Windows 用户 从 github [Releases](https://github.com/farion1231/cc-switch/releases) 页面下载最新版本的 `CC-Switch-v{版本号}-Windows.msi` 安装包或者 `CC-Switch-v{版本号}-Windows-Portable.zip` 绿色版。 ### macOS 用户 **方式一：通过 Homebrew 安装（推荐）** ```shell brew tap farion1231/ccswitch brew install --cask cc-switch ``` 更新： ```shell brew upgrade --cask cc-switch ``` **方式二：手动下载** 从 [Releases](https://github.com/farion1231/cc-switch/releases) 页面下载 `CC-Switch-v{版本号}-macOS.zip` 解压使用。 > **注意**：由于作者没有苹果开发者账号，首次打开可能出现"未知开发者"警告，请先关闭，然后前往"系统设置" → "隐私与安全性" → 点击"仍要打开"，之后便可以正常打开 # One-api one-api 是一个 api 统一管理的项目，可以让我们将所有的 api 集合起来，然后统一用一个 api 来调用，同时由 one-api 来负责负载均衡或者说轮流调用，避免单个 key 的限额以及用量上限。 ## 安装 在微服商店搜索 One-API，下载即可  之后启动，我们进行账号密码的配置。 配置完毕，我们点击渠道进行 api 的配置  之后点击新的渠道添加新的渠道  我们以能为开发者提供一定用量的魔搭平台为例，按如下进行简单的配置，其他的模型重定向以及使用的模型可以自行探索，这里只提一些最基础的功能   在密钥处填入官网获取的密钥。教程可见https://www.modelscope.cn/docs/accounts/token，完成实名认证后，将所获取的令牌填入此即可。  之后完成了所有渠道的添加之后，我们可以在管理渠道处进行测试，以及优先级的设置，优先级数字越大越优先。之后在我们调用 api 的时候，one-api 会自动对模型进行负载均衡以及优先级渠道调用。 ## 获取令牌 我们点击上面的“令牌”  点击新建令牌  自用的话，我们可以不用设置模型限额以及使用限度，如图配置即可  之后我们即可复制密钥  ## 使用 我们现在就可以开始使用 CC switch 配置 Claude code 了！ 我们打开 CC switch，添加供应商  如图填写即可，注意图中码去的位置填写自己的微服名即可   点击启用，之后我们即可去 Claude code 验证  可以使用了 # 结尾 我们已经完成了基础的 one-api 结合 Claude code 是使用教学，具体可以使用的 api 还请大家自行探索，可以购买经济实惠或者使用免费的均可，因为有了 one-api，我们可以在不需要繁琐配置各个软件 api 的同时，实现便捷的模型切换，选择最合适的模型。 但是目前 one-api 似乎已有5 个月未更新，更多的开发者转向了 one-api 下游的 new-api，大家有时间可以看看新的项目，由于大模型快速的更新迭代，如果 One-api 不更新，可能会不支持以后新模型的调用，（目前我测试文本图像都没问题，完全可以使用），欢迎大家之后做关于 new-api 的迁移。