GPT / Claude 安装与配置
开始前请准备
不同电脑的环境可能略有差异。遇到报错时，请先记录完整错误信息再排查。安装前请先完成下方的 API 密钥准备。
小北科研 API 售后群
获取 API 密钥
- 访问 https://beiapi.cn 注册并登录
- 在在线充值页面充值，或在购买页面购买兑换码
- 在钱包中兑换额度
- 点击侧边栏的 API 密钥，再点击创建 API 密钥
- 名称可自行填写，分组选择默认，然后保存更改。
- 复制创建好的 API 密钥，并妥善保存。
Windows：安装 Codex / ChatGPT
视频教程
可参考飞书中的 Codex 超简易安装教程。
安装 Codex / ChatGPT 桌面版
使用 winget（Windows 内置包管理器，Win10/11 自带）：
- 在Windows任务栏搜索框输入
PowerShell打开 - 直接复制下面命令，粘贴到
PowerShell，按回车键运行
winget install Codex -s msstore回车后会自动下载安装（约 1.1 GB），完成后直接启动 Codex 即可。
也可以直接在 Microsoft Store 中搜索 Codex 安装。
小贴士：
- 如果提示“winget 未找到”，先更新 Windows 或在 Microsoft Store 搜索“应用安装程序”安装 winget。
- 还有除此之外的问题，可询问 AI 解决，安装非常简单
获取 API Key
请查看获取API密钥
安装 CC-Switch
可以在这里下载：https://github.com/farion1231/cc-switch/releases
下载完成后安装即可。
填写配置
- 打开安装好的CC Switch，点击加号:
- 进入到添加新供应商界面，往下滑动：
填写这三个位置：
- 供应商名称随便填
- API KEY就是上面获取到的 sk-xxxxx（点击查看获取方法）
- 请求地址 URL填写：
https://api.beiapi.cn/v1
然后点击添加：
- 选择刚刚添加的供应商
重启 Codex
完成后重启 Codex 即可使用。下图为配置完成后的示例，不同版本界面可能略有差异。
macOS：安装 Codex / ChatGPT
先安装 Codex / ChatGPT 桌面版（Mac）（如果还没装）
- 最推荐：打开 App Store → 搜索 “Codex” → 点击“获取”安装（国内直连，需要外区Apple Id）。
- 或者官方 .dmg： 浏览器打开 https://persistent.oaistatic.com/codex-app-prod/Codex.dmg 双击 → 把 Codex.app 拖到「应用程序」文件夹 → 打开 安装完先别急着登录，继续下一步。
安装 CC Switch（Mac 专用，5 分钟搞定）
请从 CC-Switch Releases 下载 macOS 版 .dmg 文件并安装。若提示“来自未知开发者”，请打开系统设置 → 隐私与安全性，点击“仍要打开”。
下载完成后安装即可。
填写配置
打开安装好的CC Switch，点击这个加号:
进入到添加新供应商界面，往下滑动：
填写好这三个地方：
- 供应商名称随便填
- API KEY就是上面获取到的 sk-xxxxx（点击查看获取方法）
- 请求地址 URL填写：
https://api.beiapi.cn/v1
然后点击保存或添加。
选择刚刚添加的供应商
重启 Codex
完成后重启 Codex 即可使用。下图为配置完成后的示例，不同版本界面可能略有差异。
Windows：安装 Claude Code
打开终端
在Windows任务栏搜索框输入PowerShell打开，这个就是终端。
安装并配置 Claude Code
安装
将下面命令的sk-xxx改为你的API密钥，按照这里获取，密钥填写完之后粘贴到终端按回车键执行：
& ([scriptblock]::Create((irm https://claude.beiapi.cn/install.ps1))) -ApiKey "sk-xxx"安装过程中出现类似这样的弹窗，选择“是”
升级
irm https://claude.beiapi.cn/upgrade.ps1 | iex卸载
需要什么命令直接复制到终端里执行：
- 卸载但保留配置
irm https://claude.beiapi.cn/uninstall.ps1 | iex- 卸载并删除配置
& ([scriptblock]::Create((irm https://claude.beiapi.cn/uninstall.ps1))) -RemoveSettings- 卸载并删除配置以及备份文件
& ([scriptblock]::Create((irm https://claude.beiapi.cn/uninstall.ps1))) -RemoveSettings -RemoveBackups使用 Claude
再次打开PowerShell或cmd输入claude，即可正常使用（第一次打开可能会有引导界面，可以截图发给AI翻译，用上下键来选择，回车键来确定）
如果claude无法运行，执行这个命令
Set-ExecutionPolicy RemoteSigned -Scope CurrentUsermacOS：安装 Claude Code
打开终端
按 Command + 空格，搜索终端并打开。
安装 Node.js
在终端中运行：
curl -fsSL https://nodejs.org/dist/v22.14.0/node-v22.14.0.pkg -o node.pkg && open node.pkg按向导完成安装后，关闭并重新打开终端。
切换 npm 国内镜像源
npm config set registry https://registry.npmmirror.com▎ 此步骤可避免 npm 安装时因网络问题失败。
- 创建用户专属全局安装目录
mkdir -p ~/.npm-global- 配置 npm 使用该目录作为全局前缀
npm config set prefix '~/.npm-global'- 将该目录加入系统 PATH（永久生效）
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc- 立即生效配置
source ~/.zshrc安装 Claude Code
npm install -g @anthropic-ai/claude-code验证安装：
claude --version看到版本号即安装成功。
如需更新：
npm update -g @anthropic-ai/claude-code获取 API Key
请查看获取API密钥
安装 CC-Switch
请从 CC-Switch Releases 下载 macOS 版 .dmg 文件并安装。若提示“来自未知开发者”，请打开系统设置 → 隐私与安全性，点击“仍要打开”。
下载完成后安装即可。
填写配置
打开安装好的CC Switch，点击这个加号:
进入到添加新供应商界面，往下滑动：
填写好这三个地方：
- 供应商名称随便填。
- API KEY就是上一步获取到的
- 请求地址填写：
https://api.beiapi.cn/v1
然后点击添加：
选择刚刚添加的供应商
使用 Claude
再次打开终端输入 claude，即可正常使用
常见问题
Codex 回复慢
模型推理速度由 OpenAI 上游决定，参考以下文档启用 WebSocket 可以减少网络请求延迟
在 CC-Switch 中修改或增加对应配置，保存后重启 Codex。也可直接参考提高 Codex 回复速度。
Codex 无法生图
Codex 在指定模型后调用其他模型
Codex会自动启用子agent处理任务，在处理某些轻量的任务时，会调用gpt-5.4-min，详情见官方文档。
