https://github.com/cdzombak/aclaude
Claude Code launcher for alternate models/endpoints
https://github.com/cdzombak/aclaude
claude-code
Last synced: 9 months ago
JSON representation
Claude Code launcher for alternate models/endpoints
- Host: GitHub
- URL: https://github.com/cdzombak/aclaude
- Owner: cdzombak
- License: gpl-3.0
- Created: 2025-09-23T12:54:45.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-09-26T12:54:05.000Z (9 months ago)
- Last Synced: 2025-10-02T20:45:40.464Z (9 months ago)
- Topics: claude-code
- Language: Shell
- Homepage:
- Size: 42 KB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# aclaude
Claude Code launcher for alternate models. `aclaude` is a script to run Claude Code with custom endpoint and model selection, supporting both simple model selection and extended mode for configuring Opus/Sonnet/Haiku/Subagent models.
## Requirements
- `bash`
- `curl`
- `jq`
- `fzf`
- `claude` (Claude Code CLI)
- **Anthropic + OpenAPI compatible endpoint** as provided by e.g. [LiteLLM](https://litelm.com)
- Anthropic endpoint supports Claude Code
- OpenAPI endpoint allows listing available models
## Usage
```text
aclaude [OPTIONS] [-- CLAUDE_ARGS...]
```
### Options
- `-x`: Extended mode (select models for Opus/Sonnet/Haiku/Subagent)
- `-h`, `--help`: Show help message
- `-v`, `--version`: Show version information
### Arguments
```
- `-- CLAUDE_ARGS`: Pass remaining arguments to claude (after --)
```
### Examples
```shell
# Basic usage - select model interactively
aclaude
# Extended mode - configure all model types interactively
aclaude -x
# Pass complex arguments to claude
aclaude -- --dangerously-skip-permissions --verbose
aclaude -x -- --continue
```
## Configuration
Create `~/.config/aclaude` with `ENDPOINT` and `KEY` variables:
```shell
ENDPOINT=https://your-api-endpoint.com
KEY=your-api-key
```
## Installation
### macOS via Homebrew
```shell
brew install cdzombak/oss/aclaude
```
### Debian via apt repository
Install my Debian repository if you haven't already:
```shell
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://dist.cdzombak.net/deb.key | sudo gpg --dearmor -o /etc/apt/keyrings/dist-cdzombak-net.gpg
sudo chmod 0644 /etc/apt/keyrings/dist-cdzombak-net.gpg
echo -e "deb [signed-by=/etc/apt/keyrings/dist-cdzombak-net.gpg] https://dist.cdzombak.net/deb/oss any oss\n" | sudo tee -a /etc/apt/sources.list.d/dist-cdzombak-net.list > /dev/null
sudo apt-get update
```
Then install `aclaude` via `apt-get`:
```shell
sudo apt-get install aclaude
```
### Manual installation from build artifacts
Pre-built binaries are downloadable from each [GitHub Release](https://github.com/cdzombak/aclaude/releases). Debian packages for each release are available as well.
### Build and install locally
```shell
git clone https://github.com/cdzombak/aclaude.git
cd aclaude
make build
cp out/aclaude-[VERSION]-all $INSTALL_DIR/aclaude
```
## Author
Chris Dzombak
- [dzombak.com](https://www.dzombak.com)
- [GitHub @cdzombak](https://www.github.com/cdzombak)
## License
GPLv3; see [LICENSE](LICENSE) in this repository.