https://github.com/dsw7/claudifier
A C++ Claude CLI interface! I use this as my day-to-day toolkit for working with Anthropic products.
https://github.com/dsw7/claudifier
claude claude-api command-line-tool cpp26 libcurl
Last synced: 29 days ago
JSON representation
A C++ Claude CLI interface! I use this as my day-to-day toolkit for working with Anthropic products.
- Host: GitHub
- URL: https://github.com/dsw7/claudifier
- Owner: dsw7
- License: mit
- Created: 2026-03-16T07:19:04.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-04-07T11:12:33.000Z (about 1 month ago)
- Last Synced: 2026-04-07T12:24:43.004Z (about 1 month ago)
- Topics: claude, claude-api, command-line-tool, cpp26, libcurl
- Language: C++
- Homepage:
- Size: 177 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Claudifier
[](https://raw.githubusercontent.com/dsw7/claudifier/master/LICENSE)
## Overview
**Claudifier** is a command line tool designed to interact with Claude's API.
The program supports a few operations out of the box, such as running stateless
queries, running a chatbot, and fetching current models. This program is
written purely in C++ because python just feels clunky and slow. This program
is tested on Ubuntu/Debian and macOS.
**Please note that I built this purely because I wanted a program with a very
small binary footprint. Anthropic already provides numerous CLI tools for
interacting with its API. Please use those - they are probably better than mine
:)**
## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [The `run` command](#the-run-command)
- [The `models` command](#the-models-command)
- [The `chat` command](#the-chat-command)
- [Administration](#administration)
- [The `costs` command](#the-costs-command)
- [Uninstall Claudifier](#uninstall-claudifier)
- [License](#license)
## Installation
### Prerequisites
This program requires [CMake](https://cmake.org/), [{fmt}](https://fmt.dev/latest/) and
[libcurl](https://curl.se/libcurl/). These can be installed as follows:
#### Ubuntu/Debian
```console
apt install cmake libfmt-dev libcurl4-openssl-dev
```
#### macOS
```console
brew install cmake fmt
# libcurl usually comes bundled with macOS
```
#### Other systems
This program should work on other Unix-like systems (i.e. other Linux
distributions) however I do not extensively test these.
#### Set up environment variables
You will need a valid Anthropic API key. Set it as an environment variable:
```bash
export ANTHROPIC_API_KEY=""
```
### Step 1: Compile the binary
Compile the binary by executing the `make` target:
```console
make
```
The binary will be installed into the directory specified by CMake's [install()
function](https://cmake.org/cmake/help/latest/command/install.html#command:install).
To clean up generated
artifacts:
```console
make clean
```
### Step 2: Test setup
Start the program:
```console
claudifier --help
```
The program will print a help message if it was set up correctly. You may get
some variation of:
```
-bash: claudifier: command not found
```
If so, try running `claudifier` in a new terminal window.
## Usage
### The `run` command
Create a message from a prompt. **This command is stateless.** The program will
read in a prompt interactively by default:
```console
claudifier run
```
A prompt can instead be provided via command line argument:
```console
claudifier run --prompt="Why are oranges orange?"
```
A file named `Inputfile` can also be used to read long, multiline prompts. If
`claudifier` finds the file in the current working directory, it will
automatically read the prompt from this file. The help messages provide
additional useful options:
```console
claudifier run --help
```
### The `chat` command
Participate in an interactive, multi-turn conversation with an Anthropic LLM.
**This command is stateful.** This command will use more tokens owing to the
stateful nature of a multi-turn conversation. To use this command, run:
```console
claudifier chat
```
Or just:
```console
claudifier
```
This command will also expose several subcommands. For example, one can type
`i` at any time to inspect the existing conversational turns. The `c` command
can be used to clear context in order to switch topics and save on tokens.
### The `models` command
The `models` command can be used to print all available Anthropic models. The
model ID column can be used to specify models to be passed via the `--model` or
`-m` options for the `chat` and `run` commands.
## Administration
> [!NOTE]
> The commands in this section assume that a valid `ANTHROPIC_ADMIN_API_KEY` is
> set as an environment variable.
### The `costs` command
The `costs` command can be used to determine overall monetary usage of
Anthropic resources over a specified number of days. For example:
```console
claudifier costs --days=5
```
Will return the usage per day over the past 5 days and the overall usage over
the 5 days.
## Uninstall Claudifier
Verify that the `claudifier` command in your `$PATH` is the Claudifier binary
and not an alias for another application:
```console
claudifier -h
```
If confirmed, proceed to remove the binary with the following command:
```console
rm $(which claudifier)
```
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE)
file for details.