https://github.com/nancheung/cc-releases
Automated mirror of Claude Code offline installers—tracks new releases, verifies SHA256, and publishes them as GitHub Releases.Claude Code 离线安装程序的自动镜像——跟踪新版本，验证 SHA256，并将其发布为 GitHub Releases。
https://github.com/nancheung/cc-releases
antigravity claude-code codex installer linux macos offline-installer release-mirror windows
Last synced: about 1 month ago
JSON representation
Automated mirror of Claude Code offline installers—tracks new releases, verifies SHA256, and publishes them as GitHub Releases.Claude Code 离线安装程序的自动镜像——跟踪新版本，验证 SHA256，并将其发布为 GitHub Releases。
- Host: GitHub
- URL: https://github.com/nancheung/cc-releases
- Owner: nancheung
- License: agpl-3.0
- Created: 2026-01-09T11:34:45.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-10T12:02:27.000Z (6 months ago)
- Last Synced: 2026-01-10T22:43:20.813Z (6 months ago)
- Topics: antigravity, claude-code, codex, installer, linux, macos, offline-installer, release-mirror, windows
- Language: Python
- Homepage:
- Size: 181 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Claude Code Releases - Offline Installer Archive
**[English](README.md) | [中文](README.zh-CN.md)**
[](https://github.com/nancheung/cc-releases/blob/main/LICENSE)
[](https://github.com/anthropics/claude-code/releases)
[](https://github.com/nancheung/cc-releases/releases)
[](https://github.com/nancheung/cc-releases/actions)
Automated mirror of [Claude Code](https://github.com/anthropics/claude-code) offline installers for all supported platforms. This repository automatically detects new releases, downloads official binaries, verifies integrity, and publishes them as GitHub Releases for easy access.
## ✨ Features
- 🤖 **Fully Automated** - GitHub Actions checks for updates every 6 hours
- 🌍 **Cross-Platform** - Supports Windows, macOS (Intel & Apple Silicon), and Linux (x64, ARM64, musl)
- 🔒 **Integrity Verified** - SHA256 checksums validated for all downloads
- 📦 **Version Archive** - Access any version >= 1.0.37 from a single location
- 🚀 **Fast Downloads** - Concurrent downloads from official Google Cloud Storage
- 📝 **Changelog Included** - Each release includes official release notes
## 📥 Quick Start
### Download Latest Version
**[→ Go to Releases Page](../../releases/latest)** to download installers for your platform.
### Platform Support
| Platform | Architecture | File Pattern | Installation |
|----------|-------------|--------------|--------------|
| 🪟 **Windows** | x64 | `claude-{version}-win32-x64.exe` | `.\claude-{version}-win32-x64.exe install` |
| 🍎 **macOS** | Apple Silicon (M1/M2/M3) | `claude-{version}-darwin-arm64` | `chmod +x claude-{version}-darwin-arm64 && ./claude-{version}-darwin-arm64 install` |
| 🍎 **macOS** | Intel x64 | `claude-{version}-darwin-x64` | `chmod +x claude-{version}-darwin-x64 && ./claude-{version}-darwin-x64 install` |
| 🐧 **Linux** | x64 (glibc) | `claude-{version}-linux-x64` | `chmod +x claude-{version}-linux-x64 && ./claude-{version}-linux-x64 install` |
| 🐧 **Linux** | ARM64 (glibc) | `claude-{version}-linux-arm64` | `chmod +x claude-{version}-linux-arm64 && ./claude-{version}-linux-arm64 install` |
| 🐧 **Linux** | x64 (musl) | `claude-{version}-linux-x64-musl` | `chmod +x claude-{version}-linux-x64-musl && ./claude-{version}-linux-x64-musl install` |
| 🐧 **Linux** | ARM64 (musl) | `claude-{version}-linux-arm64-musl` | `chmod +x claude-{version}-linux-arm64-musl && ./claude-{version}-linux-arm64-musl install` |
> **Note:** musl builds are for Alpine Linux and other musl-based distributions
> **Installation Notes:**
> - **Windows**: Run the downloaded `.exe` file with the `install` command
> - **macOS/Linux**: Grant execution permission with `chmod +x` before running
> - Replace `{version}` with the actual version number (e.g., `1.0.112`)
> - The `install` command sets up shell integration and the `claude` CLI launcher
### Browse All Versions
Visit **[Releases](../../releases)** to download specific versions or explore the full version history.
## 🔄 How It Works
This repository uses a two-stage GitHub Actions pipeline:
### 1. Update Detection (Every 6 Hours)
The [`check-update.yml`](.github/workflows/check-update.yml) workflow:
- Parses the [official CHANGELOG.md](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) for version numbers
- Compares discovered versions against `version.json` (our local index)
- Filters versions >= 1.0.37 (minimum supported version)
- Batches up to 5 versions per run to respect API rate limits
- Triggers the sync workflow if new versions are found
### 2. Release Synchronization (On-Demand)
The [`sync-release.yml`](.github/workflows/sync-release.yml) workflow:
1. Fetches `manifest.json` from official Google Cloud Storage bucket
2. Downloads all platform binaries concurrently (7 parallel workers)
3. Verifies each download against SHA256 checksums from manifest
4. Creates GitHub Release with changelog notes and verified binaries
5. Updates `version.json` index and commits changes
### Data Sources
- **Official Repository:** [anthropics/claude-code](https://github.com/anthropics/claude-code)
- **Install Script:** [claude.ai/install.sh](https://claude.ai/install.sh) (provides GCS bucket URL)
- **Changelog:** [CHANGELOG.md](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)
## 🛠️ Manual Operations
You can manually trigger synchronization via GitHub Actions:
### Trigger Update Check
1. Go to **[Actions → Check for Updates](../../actions/workflows/check-update.yml)**
2. Click **Run workflow** → **Run workflow**
### Sync Specific Versions
1. Go to **[Actions → Sync Releases](../../actions/workflows/sync-release.yml)**
2. Click **Run workflow**
3. Enter JSON array of versions (e.g., `["2.1.0","2.1.1"]`)
4. Click **Run workflow**
## 📚 Technical Details
Project Structure
```
cc-releases/
├── .github/workflows/
│ ├── check-update.yml # Scheduled update detection
│ └── sync-release.yml # Release synchronization
├── scripts/
│ ├── check_update.py # Update detection entry point
│ ├── sync_release.py # Sync entry point
│ └── lib/ # Core modules
│ ├── config.py # Constants and settings
│ ├── fetcher.py # GCS bucket and manifest fetching
│ ├── changelog.py # CHANGELOG.md parsing
│ ├── downloader.py # Concurrent downloads with verification
│ ├── version.py # version.json management
│ └── release.py # GitHub Release operations
├── version.json # Synced versions index
└── README.md
```
Version Index Schema
`version.json` tracks synchronized releases:
```json
{
"synced": ["2.1.0", "1.0.38", "1.0.37"],
"lastRun": "2026-01-09T10:30:00Z",
"latestSynced": "2.1.0"
}
```
**Fields:**
- `synced`: Array of synchronized versions, sorted newest → oldest
- `lastRun`: ISO 8601 UTC timestamp of last synchronization
- `latestSynced`: Latest synchronized version (first element of `synced` array)
Development Setup
**Prerequisites:** Python 3.8+, [GitHub CLI](https://cli.github.com/)
```bash
# Install dependencies
pip install -r requirements.txt
# Test update detection
python scripts/check_update.py
# Test syncing specific versions
python scripts/sync_release.py '["2.1.0","2.1.1"]'
```
## ❓ FAQ
Why are versions older than 1.0.37 not available?
Earlier versions do not have `manifest.json` files in the official Google Cloud Storage bucket, making automated integrity verification impossible.
How often are new versions synced?
The update checker runs every 6 hours. Manual synchronization is also available via GitHub Actions.
Are these official binaries?
Yes. All binaries are downloaded directly from Anthropic's official Google Cloud Storage bucket and verified using SHA256 checksums from official manifests.
Can I download older versions?
Yes. All versions >= 1.0.37 are archived in the [Releases](../../releases) section.
## 🔗 Related Links
- [Claude Code Official Repository](https://github.com/anthropics/claude-code)
- [Claude Code Documentation](https://github.com/anthropics/claude-code#readme)
- [Official Changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)
- [Report Issues](https://github.com/anthropics/claude-code/issues)
## 📄 License
This repository is licensed under the [AGPL v3 License](LICENSE).
**Note:** Claude Code itself is distributed under its own license terms. Please refer to the [official repository](https://github.com/anthropics/claude-code) for Claude Code licensing information.
---
Maintained by automated workflows • Not affiliated with Anthropic