CheckClaude

https://github.com/zzusec/checkclaude
Admin
CheckClaude is a cross-platform menu bar/tray app that scores your machine's environment on 26...
Tokens:5,430
Snippets:44
Trust Score:7.3
License:MIT
Update:1 day ago
Show doc for...
Tokens:
Raw
### Build and install on macOS

Source: https://github.com/zzusec/checkclaude/blob/main/README.md

Clone the repository, build, install to /Applications, register login item, and optionally produce a distributable DMG. No sudo required. The app is self-contained with detection scripts in CheckClaude.app/Contents/Resources/ and data in ~/Library/Application Support/CheckClaude. Turn off 'Set time zone automatically' in System Settings to avoid conflicts.

```bash
git clone https://github.com/zzusec/CheckClaude.git
cd CheckClaude
bash install.sh          # build, install to /Applications, register login item — no sudo
bash build_dmg.sh        # produce a distributable CheckClaude.dmg
bash uninstall.sh
```

--------------------------------

### Windows command line usage

Source: https://github.com/zzusec/checkclaude/blob/main/README.md

Run the executable from the terminal. Use --check to print the full report without starting the tray, and --version to display version information.

```plaintext
CheckClaude.exe --check     # print the full report, do not start the tray
CheckClaude.exe --version
```

--------------------------------

### Build on Linux

Source: https://github.com/zzusec/checkclaude/blob/main/README.md

Build a pure-Go static binary (CLI, no GTK dependency) plus a GTK3 + Ayatana AppIndicator tray. Requires a remote build box accessible via SSH.

```bash
LINUX_HOST=root@your-build-box bash linux/build-remote.sh
```

--------------------------------

### Build and test on Windows remotely

Source: https://github.com/zzusec/checkclaude/blob/main/README.md

Build and test the Windows .NET Framework 4.8 bridge from a Mac using a remote Windows host. Set WIN_HOST to the target machine. The test includes a real-Edge end-to-end run.

```bash
WIN_HOST=win-ding bash windows/build-remote.sh 4.18
WIN_HOST=win-ding bash windows/test-remote.sh
```

--------------------------------

### Run offline tests

Source: https://github.com/zzusec/checkclaude/blob/main/README.md

Run all offline test suites: scoring model, network-jitter state machine, browser report page, upgrade flow, codex proxy (against a fake local upstream), Linux policy engine, and Windows bridge (including a real-Edge end-to-end run).

```bash
bash test-claude-check.sh     # scoring model
bash test-auto-timezone.sh    # network-jitter state machine
bash test-browser-report.sh   # full browser report page
bash test-upgrade.sh          # upgrade flow
bash test-codex-guard.sh      # codex proxy, against a fake local upstream
cd linux && go test ./...     # Linux policy engine
bash windows/test-remote.sh   # Windows bridge, incl. a real-Edge end-to-end run
```

--------------------------------

### macOS command line usage

Source: https://github.com/zzusec/checkclaude/blob/main/README.md

Run the check script from the terminal. Use --fix to apply safely reversible fixes, --fix-locale to also set the system region, and --dry-run for auto-timezone to preview changes without applying.

```bash
~/CheckClaude/claude-check.sh               # full report
~/CheckClaude/claude-check.sh --fix         # apply the safely reversible fixes
~/CheckClaude/claude-check.sh --fix-locale  # also set system region to the exit country
~/CheckClaude/auto-timezone.sh --check      # three-path consistency only, no timezone change
~/CheckClaude/auto-timezone.sh --dry-run    # show the timezone it would set, change nothing
```

--------------------------------

### Reverse proxy architecture diagram

Source: https://github.com/zzusec/checkclaude/blob/main/README.md

Shows the data flow of the reverse proxy bound to 127.0.0.1:8788 that collects, validates, and injects the x-codex-turn-state header before forwarding to chatgpt.com/backend-api.

```text
codex ──► 127.0.0.1:8788/backend-api ──► chatgpt.com/backend-api
             collect / validate / inject state
```

--------------------------------

### Enable auto timezone on macOS

Source: https://github.com/zzusec/checkclaude/blob/main/README.md

Run with sudo to grant NOPASSWD for systemsetup/networksetup; without it, changing the timezone prompts for authorization once.

```bash
sudo bash enable-auto-timezone.sh
```

--------------------------------

### Linux command line usage

Source: https://github.com/zzusec/checkclaude/blob/main/README.md

Run the checkclaude command with various flags: --check for full report, --json for machine-readable output, --browser to open the default browser and render an HTML report, --fix to apply safely reversible fixes, --fix-locale to write a user-level region-format override, and --tray-status for a single-line TSV.

```bash
checkclaude --check         # full report
checkclaude --json          # machine-readable JSON
checkclaude --browser       # open the default browser, collect real fingerprints, render an HTML report
checkclaude --fix           # apply the safely reversible fixes (timezone / GNOME PAC)
checkclaude --fix-locale    # write a user-level region-format override, display language untouched
checkclaude --tray-status   # single-line TSV for the tray
```

--------------------------------

### Remove quarantine attribute on macOS

Source: https://github.com/zzusec/checkclaude/blob/main/README.md

Use this command to clear the quarantine attribute from the CheckClaude app on macOS, allowing it to launch without the 'Open Anyway' workaround.

```bash
xattr -dr com.apple.quarantine /Applications/CheckClaude.app
```
Tokens:
Raw