[新手向]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 配置。 ![Pasted image 20251127124418.png](https://dl.playground.lazycat.cloud/guidelines/976/bafab652-f1c3-48f5-b8b2-4f7c2357b490.png "Pasted image 20251127124418.png") ## 安装 ### 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，下载即可 ![Pasted image 20251127124835.png](https://dl.playground.lazycat.cloud/guidelines/976/72254458-f201-412b-acb5-076da894c866.png "Pasted image 20251127124835.png") 之后启动，我们进行账号密码的配置。配置完毕，我们点击渠道进行 api 的配置 ![Pasted image 20251127124950.png](https://dl.playground.lazycat.cloud/guidelines/976/33093721-5276-4954-84c1-e0d82e5fb51f.png "Pasted image 20251127124950.png") 之后点击新的渠道添加新的渠道 ![Pasted image 20251127125044.png](https://dl.playground.lazycat.cloud/guidelines/976/39e618fd-91a4-47b2-bcef-c4a7a9aba431.png "Pasted image 20251127125044.png") 我们以能为开发者提供一定用量的魔搭平台为例，按如下进行简单的配置，其他的模型重定向以及使用的模型可以自行探索，这里只提一些最基础的功能 ![Pasted image 20251127125211.png](https://dl.playground.lazycat.cloud/guidelines/976/c41467d3-719d-44d5-884a-9c6534ca92b0.png "Pasted image 20251127125211.png") ![Pasted image 20251127125304.png](https://dl.playground.lazycat.cloud/guidelines/976/bfeb3516-c299-4286-8651-ef594a3b1458.png "Pasted image 20251127125304.png") 在密钥处填入官网获取的密钥。教程可见https://www.modelscope.cn/docs/accounts/token，完成实名认证后，将所获取的令牌填入此即可。 ![Pasted image 20251127125541.png](https://dl.playground.lazycat.cloud/guidelines/976/05ad88dc-6ed0-4a8b-b518-dbdec083f342.png "Pasted image 20251127125541.png") 之后完成了所有渠道的添加之后，我们可以在管理渠道处进行测试，以及优先级的设置，优先级数字越大越优先。之后在我们调用 api 的时候，one-api 会自动对模型进行负载均衡以及优先级渠道调用。 ## 获取令牌我们点击上面的“令牌” ![Pasted image 20251127125744.png](https://dl.playground.lazycat.cloud/guidelines/976/0e183f36-4a45-4b95-874f-2538727c71f7.png "Pasted image 20251127125744.png") 点击新建令牌 ![Pasted image 20251127125833.png](https://dl.playground.lazycat.cloud/guidelines/976/b54767da-1795-4532-ad3d-802a670208fc.png "Pasted image 20251127125833.png") 自用的话，我们可以不用设置模型限额以及使用限度，如图配置即可 ![Pasted image 20251127125919.png](https://dl.playground.lazycat.cloud/guidelines/976/2ceb49ce-b19c-4dd6-a3dd-bf63c463c664.png "Pasted image 20251127125919.png") 之后我们即可复制密钥 ![Pasted image 20251127130000.png](https://dl.playground.lazycat.cloud/guidelines/976/1ee373d0-143b-4973-8760-c5dfdf95d5b6.png "Pasted image 20251127130000.png") ## 使用我们现在就可以开始使用 CC switch 配置 Claude code 了！我们打开 CC switch，添加供应商 ![Pasted image 20251127130418.png](https://dl.playground.lazycat.cloud/guidelines/976/dab2b040-13de-4ab7-a478-6c163b69b999.png "Pasted image 20251127130418.png") 如图填写即可，注意图中码去的位置填写自己的微服名即可 ![Pasted image 20251127130752.png](https://dl.playground.lazycat.cloud/guidelines/976/6e4c8568-b38d-4be1-afbb-16b69f308364.png "Pasted image 20251127130752.png") ![Pasted image 20251127130735.png](https://dl.playground.lazycat.cloud/guidelines/976/662032b8-806c-4205-953a-3bd801795de8.png "Pasted image 20251127130735.png") 点击启用，之后我们即可去 Claude code 验证 ![Pasted image 20251127130953.png](https://dl.playground.lazycat.cloud/guidelines/976/7e14b32a-7683-4381-a360-715b60a6cef3.png "Pasted image 20251127130953.png") 可以使用了 # 结尾我们已经完成了基础的 one-api 结合 Claude code 是使用教学，具体可以使用的 api 还请大家自行探索，可以购买经济实惠或者使用免费的均可，因为有了 one-api，我们可以在不需要繁琐配置各个软件 api 的同时，实现便捷的模型切换，选择最合适的模型。但是目前 one-api 似乎已有5 个月未更新，更多的开发者转向了 one-api 下游的 new-api，大家有时间可以看看新的项目，由于大模型快速的更新迭代，如果 One-api 不更新，可能会不支持以后新模型的调用，（目前我测试文本图像都没问题，完全可以使用），欢迎大家之后做关于 new-api 的迁移。