Claude 桌面版和 Claude Code 如何接入 8848API

很多人想用 Claude，但会遇到两个现实问题：一是官方账号和额度不稳定，二是团队里想统一 API Key、统一模型、统一成本管理。8848API 提供 Anthropic 兼容接口，可以让 Claude 桌面 App 和 Claude Code 命令行都通过同一个网关调用模型。

这篇教程分成两部分：

• 桌面 App 版：适合普通用户，直接在 Claude 桌面端里配置 8848API。
• 命令行版：适合开发者，在 Claude Code 里通过环境变量接入 8848API。

提示：Claude 桌面 App 在开启开发者模式、保存第三方推理配置、切换网关时，过程中可能会提示重启 2-3 次。这是正常现象，按提示点击 Relaunch now 或手动退出后重新打开即可。

第一部分：Claude 桌面 App 接入 8848API

第一步：打开 Claude 桌面 App

启动 Claude 桌面 App 后，如果设备上已经存在本地配置，页面会显示 Continue with Gateway。这表示 Claude 已识别到本机有第三方推理网关配置。

先不要急着登录 Anthropic 官方账号，我们要进入菜单里配置第三方推理服务。

第二步：开启开发者模式

在 macOS 顶部菜单栏依次点击：

Help → Troubleshooting → Enable Developer Mode

开启后，顶部菜单栏会多出一个 Developer 菜单。

注意：开启开发者模式后 Claude 会提示重启，按 Relaunch now 即可。

第三步：进入第三方推理配置

点击顶部菜单：

Developer → Configure Third-Party Inference…

第四步：填写 8848API 网关信息

在配置窗口里选择 Gateway，然后填写以下三项：

Gateway base URL

https://api.884819.xyz

Gateway API key

填写你在 8848API 后台创建的 API Key，格式类似：

sk-xxxxxxxxxxxxxxxx

Gateway auth scheme

选择 bearer

填好后，点击右下角 Apply locally，Claude 会再次提示重启。

第五步：重启 Claude

点击 Relaunch now 完成重启。整个配置过程中可能会弹出 2-3 次重启提示，都按提示操作即可。

第六步：选择模型开始使用

重启后回到 Claude 主界面，在模型下拉菜单里选择你要用的模型。

第二部分：Claude Code 命令行接入 8848API

适合开发者在终端里使用 Claude Code，把请求转到 8848API。

准备信息

• API 地址：https://api.884819.xyz
• API Key：你的 8848API Key

临时配置（当前终端生效）

export ANTHROPIC_BASE_URL="https://api.884819.xyz"
export ANTHROPIC_AUTH_TOKEN="你的8848API-Key"

然后在项目目录启动：

cd 你的项目目录
claude

长期配置（写入 shell 配置文件）

macOS / zsh：

echo 'export ANTHROPIC_BASE_URL="https://api.884819.xyz"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的8848API-Key"' >> ~/.zshrc
source ~/.zshrc

Linux / bash：

echo 'export ANTHROPIC_BASE_URL="https://api.884819.xyz"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的8848API-Key"' >> ~/.bashrc
source ~/.bashrc

推荐模型

日常开发推荐：claude-sonnet-4-6

复杂任务推荐：claude-opus-4-6-thinking

常见问题

Key 无效？ 检查是否复制完整，前后不要有空格。

连接失败？ 确认地址：https://api.884819.xyz，部分工具需要加 /v1。

还是走官方 Claude？ 检查环境变量是否生效：

echo $ANTHROPIC_BASE_URL

总结

• 普通用户 → Claude 桌面 App + Gateway 配置，界面直观
• 开发者 → Claude Code + 环境变量，在项目里直接读写代码

两种方式都是把请求交给 8848API 统一转发，方便统一管理 Key、模型和成本。

本文由 8848AI 原创，转载请注明出处。