An open API service indexing awesome lists of open source software.

https://github.com/mileson/glm-claude-auto-install

一键安装 GLM Claude Code 与 OpenAI Codex CLI 的跨平台脚本集合
https://github.com/mileson/glm-claude-auto-install

claude-code codex-cli glm installer macos nodejs openai windows

Last synced: about 2 months ago
JSON representation

一键安装 GLM Claude Code 与 OpenAI Codex CLI 的跨平台脚本集合

Awesome Lists containing this project

README

          

# glm-claude-auto-install

> 给新手准备的一键安装工具页:按步骤下载、双击、输入信息,就能完成安装。

[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
[![macOS](https://img.shields.io/badge/macOS-supported-black?logo=apple)](./scripts/macos)
[![Windows](https://img.shields.io/badge/Windows-supported-blue?logo=windows)](./scripts/windows)
[![Codex CLI](https://img.shields.io/badge/Codex%20CLI-OpenAI-412991)](https://developers.openai.com/codex/cli)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-GLM%20helper-orange)](https://docs.bigmodel.cn/cn/coding-plan/quick-start)

[English](./README_EN.md)

## 先看这里

这个仓库一共提供两类一键安装器:

1. **GLM Coding Plan + Claude Code**
2. **OpenAI Codex CLI**

如果你的电脑里还没有完整的 Node.js,安装器会先自动补齐,再继续安装。

---

## 新手只要 3 步

### 第 1 步:先确认你要装哪个

#### 我要装 GLM Coding Plan + Claude Code

适合:

- 你要用智谱的 Coding Plan
- 你要把套餐接到 Claude Code

#### 我要装 OpenAI Codex CLI

适合:

- 你要安装 Codex 命令行工具
- 你只想让用户输入 API Key,其他配置都自动带好

---

### 第 2 步:按你的系统点击下载

## 快速开始

### 安装 GLM Coding Plan + Claude Code

| 系统 | 下载 |
|---|---|
| macOS | [下载:GLM Claude 安装器(下载后双击执行)](https://github.com/mileson/glm-claude-auto-install/releases/latest/download/GLM-Claude-macOS-App-Double-Click.zip) |
| Windows | [下载:GLM Claude 安装器(下载后双击执行)](https://github.com/mileson/glm-claude-auto-install/releases/latest/download/GLM-Claude-Windows-Download-Then-Double-Click.zip) |

### 安装 OpenAI Codex CLI

| 系统 | 下载 |
|---|---|
| macOS | [下载:OpenAI Codex 安装器(下载后双击执行)](https://github.com/mileson/glm-claude-auto-install/releases/latest/download/OpenAI-Codex-macOS-App-Double-Click.zip) |
| Windows | [下载:OpenAI Codex 安装器(下载后双击执行)](https://github.com/mileson/glm-claude-auto-install/releases/latest/download/OpenAI-Codex-Windows-Download-Then-Double-Click.zip) |

---

### 第 3 步:下载后直接执行

#### macOS

1. 下载 `.zip` 文件到桌面或下载目录
2. 双击解压
3. 双击里面的 `.app`
4. 根据窗口提示输入需要的信息
5. 等它自动安装完成

#### Windows

1. 下载 `.zip` 文件到本地
2. 先解压
3. 双击里面名字带 **双击执行** 的 `.bat`
4. 如果系统弹出管理员授权,点击允许
5. 根据窗口提示输入需要的信息
6. 等它自动安装完成

---

## 我该下载哪个

如果你只是想先把工具装好,直接按下面选就行:

- **我用 mac,想装智谱 Claude Code**
[点这里直接下载](https://github.com/mileson/glm-claude-auto-install/releases/latest/download/GLM-Claude-macOS-App-Double-Click.zip)

- **我用 Windows,想装智谱 Claude Code**
[点这里直接下载](https://github.com/mileson/glm-claude-auto-install/releases/latest/download/GLM-Claude-Windows-Download-Then-Double-Click.zip)

- **我用 mac,想装 OpenAI Codex**
[点这里直接下载](https://github.com/mileson/glm-claude-auto-install/releases/latest/download/OpenAI-Codex-macOS-App-Double-Click.zip)

- **我用 Windows,想装 OpenAI Codex**
[点这里直接下载](https://github.com/mileson/glm-claude-auto-install/releases/latest/download/OpenAI-Codex-Windows-Download-Then-Double-Click.zip)

如果你现在只是第一次安装,看到这 4 个文件就够了,其他文件你可以先不用管。

如果你想先打开完整下载页,也可以点这里:

- [打开最新版下载页](https://github.com/mileson/glm-claude-auto-install/releases/latest)

如果你以前装过旧版 GLM 环境,后面确实需要清理旧版本,再去仓库里的 `scripts/` 目录找清理脚本就可以。

---

## 下载后会发生什么

安装器会自动帮用户完成这些事:

- 检查电脑里有没有 `node`、`npm`、`npx`
- 没有的话自动安装 **系统级 Node.js**
- 自动安装对应 CLI
- 自动写入本地配置文件
- 安装前自动备份旧配置

---

## 两类安装器分别会让用户输入什么

### GLM Coding Plan + Claude Code

通常会引导用户输入:

- API Key

然后自动完成:

- 自动使用中国站配置
- Node.js 安装(如缺失)
- Claude Code 安装
- Coding Helper 安装
- Claude 配置写入

### OpenAI Codex CLI

通常会引导用户输入:

- OpenAI API Key

然后自动完成:

- Node.js 安装(如缺失)
- Codex CLI 安装
- 预设 Base URL 自动写入
- 预设模型与默认配置自动写入
- `~/.codex/config.toml` 写入
- `~/.codex/auth.json` 写入

---

## 常见问题

### 为什么 release 页面里还有 Source code (zip / tar.gz)

这是 GitHub 自动生成的源码包,不是给普通用户直接双击运行的安装器。

如果你只是想安装,请优先下载这些名字的文件:

- `Double-Click.command`
- `Download-Then-Double-Click.zip`

### Windows 为什么是 zip,不是直接一个文件

因为 Windows 安装器通常需要:

- 一个可双击启动的 `.bat`
- 一个实际执行逻辑的 `.ps1`

所以这里直接打成一个 zip,用户下载一个文件就够了。

### 安装时看到 ENOTFOUND 或 registry.npmjs.org

这表示电脑当前连不上 npm 源,通常和网络、DNS、代理或 VPN 有关。可以先换一个稳定网络,或确认代理/VPN 已经开启,然后重新运行安装器。

如果之前改过 npm 代理,也可以在终端执行:

```bash
npm config delete proxy
npm config delete https-proxy
```

如果有可用的 npm 镜像源,可以先执行:

```bash
npm config set registry <你的 npm 镜像源地址>
```

### 我是新手,应该下载哪个

最简单的判断:

- 想装 **GLM + Claude** → 选名字里有 `GLM-Claude`
- 想装 **OpenAI Codex** → 选名字里有 `OpenAI-Codex`
- 用 mac → 选 `.command`
- 用 Windows → 选 `.zip`

---

## 给第一次使用的人一句话建议

- 不要下载 `Source code`
- 直接点上面的下载链接
- 下载到本地后按系统双击执行
- 跟着提示一步一步填就行

---

## 适合谁用

- 不会自己配 Node.js 的新手
- 不想手动敲很多命令的用户
- 需要把安装流程交给别人执行的人
- 想降低远程协助成本的人

## 功能亮点

- 新手友好的双击安装入口
- 自动检测并安装 Node.js
- 自动安装 GLM Claude / OpenAI Codex
- 自动写入本地配置
- 自动备份旧配置
- 提供旧版 GLM 环境清理脚本
- 同时支持 macOS 与 Windows

## 使用说明

- GLM 安装器基于官方 Coding Tool Helper 流程与 Node.js 官方安装包。
- Codex 安装器基于官方 npm 安装路径,并自动写入本地配置。
- Codex CLI 在 Windows 上更适合作为实验性方案,长期使用仍建议 WSL2。
- 如果你是给别人分发,可以直接把上面的下载链接发给对方。

## 安全说明

- 不要把真实 API Key 提交到仓库。
- 安装器会在写入前备份旧配置。
- `~/.codex/auth.json`、`~/.chelper/config.yaml`、Claude 配置文件都应只保留在本地。
- 如发现安全问题,请查看 [SECURITY.md](./SECURITY.md)。

## 版本说明

- [v0.1.9](./docs/releases/v0.1.9.md)

## 参考资料

- [GLM Coding Plan 快速开始](https://docs.bigmodel.cn/cn/coding-plan/quick-start)
- [GLM 文档索引](https://docs.bigmodel.cn/llms.txt)
- [OpenAI Codex CLI 文档](https://developers.openai.com/codex/cli)
- [OpenAI Codex 鉴权文档](https://developers.openai.com/codex/auth)
- [Node.js 下载目录](https://nodejs.org/dist/)

## 贡献

请查看 [CONTRIBUTING.md](./CONTRIBUTING.md)。

## 许可证

MIT License,见 [LICENSE](./LICENSE)。

## 作者
- X: [Mileson07](https://x.com/Mileson07)
- 小红书: [超级峰](https://xhslink.com/m/4LnJ9aB1f97)
- 抖音: [超级峰](https://v.douyin.com/rH645q7trd8/)