v0.3.0 · 健康检查 / 一键安装 / npm 发布

三种安装方式

# 1. 已有 Node.js（最快，24KB）
npm install -g geekapi-cli

# 2. macOS / Linux 一键脚本
curl -fsSL https://raw.githubusercontent.com/CoderKuo/geekapi-cli/main/install.sh | bash

# 3. Windows PowerShell 一键脚本
irm https://raw.githubusercontent.com/CoderKuo/geekapi-cli/main/install.ps1 | iex

---

新增功能

配置后自动健康检查

配完 Claude / Codex 立即调 /v1/models 验证 key 是否可用：

• 401/403：API Key 错误或分组不支持
• 404：Base URL / 路由不对
• 网络错误：中转站不可达
  针对性提示，不再让用户配错后跑 claude 黑盒撞墙。

余额查询

菜单新增"查询余额 / 用量"，调 /v1/usage 显示剩余额度。

打开 GeekAPI 控制台

菜单新增"打开 GeekAPI 控制台"，自动调用系统浏览器。

原子写入 + 滚动备份

• 写配置先写 .tmp 再 rename，防止崩溃留半截文件
• 备份命名为 <file>.bak.<timestamp>，自动保留最近 5 份

一键安装脚本

• install.sh（macOS/Linux）：自动检测平台架构，拉 GitHub Releases 最新版
• install.ps1（Windows）：自动加 PATH，UTF-8 with BOM 保证中文不乱码

发布到 npm

• 包名：geekapi-cli
• 大小：24KB（gzip）
• 支持 Node 18+
• 用 child_process 替换 Bun.spawn，Node/Bun 双兼容

---

直接下载

系统	文件
Windows 10/11 x64	geekapi-win.exe
macOS（Intel）	geekapi-mac
macOS（Apple Silicon）	geekapi-mac-arm
Linux x64	geekapi-linux

v0.2.0 · 支持 Codex 一键配置

更新内容

新增

• Codex 一键配置：自动检测 OpenAI Codex CLI 是否安装，未装时引导 npm install -g @openai/codex
• 写入 Codex 配置文件：
  • ~/.codex/config.toml（gpt-5.5 / xhigh reasoning effort / responses wire_api / 1M 上下文窗口）
  • ~/.codex/auth.json（OPENAI_API_KEY）
  • 写入前自动备份原文件为 .bak
• 启动流程新增配置目标选择：仅 Claude / 仅 Codex / 都配 / 跳过
• 主菜单扩展：Claude 与 Codex 平行的"配置 / 安装 / 启动"入口
• "查看当前配置" 同时显示两个产品的 base URL 与 API Key（已脱敏）

改进

• Codex 安装复用 v0.1.1 的 npm 镜像自动切换逻辑

---

下载

系统	文件
Windows 10/11 x64	geekapi-win.exe
macOS（Intel）	geekapi-mac
macOS（Apple Silicon）	geekapi-mac-arm
Linux x64	geekapi-linux

详细使用方法见 使用教程。

---

⚠️ 注意

Codex 配置写入时会整体覆盖 ~/.codex/config.toml（带 .bak 备份）。如果你已经有自定义的 config.toml 配置，从 .bak 中手动合并需要的字段即可。

v0.1.1 · 自动镜像切换

更新内容

新增

• 自动检测并按需切换 npm 国内镜像：安装 Claude Code 前预检测 registry.npmjs.org 连通性，不通时询问用户切到 registry.npmmirror.com 重试
• 用 --registry 标志单次注入，不修改用户的全局 ~/.npmrc 配置，保留私服等已有设置不变
• 安装失败兜底：用官方源失败时再次询问是否切镜像重试，每一步切换都需用户确认

文档

• 使用教程的下载表格加上 GitHub Releases 直链

---

下载

系统	文件
Windows 10/11 x64	geekapi-win.exe
macOS（Intel）	geekapi-mac
macOS（Apple Silicon）	geekapi-mac-arm
Linux x64	geekapi-linux

详细使用方法见 使用教程。

v0.1.0 · 首发

GeekAPI · Claude Code 快捷配置工具 v0.1.0

零基础一键完成 Claude Code 的下载、安装和 API 配置。

下载

系统	文件
Windows 10/11 x64	geekapi-win.exe
macOS（Intel）	geekapi-mac
macOS（Apple Silicon）	geekapi-mac-arm
Linux x64	geekapi-linux

功能

• 自动检测 Claude Code / Node.js / npm / Bun
• 没装运行时 → 引导安装（Windows winget / macOS Homebrew / Linux 包管理器）
• 没装 Claude Code → 自动 npm install -g @anthropic-ai/claude-code
• 默认中转站 https://www.geek2api.com，支持自定义
• 一键写入 ~/.claude/settings.json，写入前自动备份 .bak

使用

详见 使用教程。

macOS / Linux 首次运行：

```bash
chmod +x geekapi-mac # 或 geekapi-mac-arm / geekapi-linux
./geekapi-mac
```

Windows 直接双击即可。