Home / Installation

Installation Guide

Choose your preferred installation method and get CC Alias up and running in minutes

⚡ Fastest Method: One-line installation script that automatically sets everything up.
1

Run the Installation Command

Open your terminal and run this single command:

curl -s https://raw.githubusercontent.com/netors/cc-alias/main/create_cc_alias.sh | bash
Security Notice: Always review scripts before piping to bash. You can view the script content at the GitHub Repository.
2

Activate the Alias

To start using the cc command immediately:

source ~/.zprofile

Or simply open a new terminal window.

3

Verify Installation

Test that everything is working:

cc --help
Success! If you see Claude Code's help menu, the installation is complete.
🔧 Recommended: Step-by-step installation for users who prefer to review each step.
1

Download the Script

Save the installation script to your local machine:

curl -o create_cc_alias.sh https://raw.githubusercontent.com/netors/cc-alias/main/create_cc_alias.sh
2

Review the Script

Inspect the script content to understand what it does:

cat create_cc_alias.sh

The script will:

  • Check for required dependencies
  • Create ~/.env.cc configuration file
  • Add the cc function to ~/.zprofile
  • Validate environment variables
3

Make it Executable

Grant execution permissions to the script:

chmod +x create_cc_alias.sh
4

Run the Installation

Execute the script:

./create_cc_alias.sh

Follow the interactive prompts to complete the installation.

5

Activate and Test

Load the new configuration:

source ~/.zprofile
cc --help
📊 Optional: Set up the OpenTelemetry collector with Grafana dashboards.
1

Install Docker Desktop

If you haven't already, install Docker Desktop for Mac:

Download Docker Desktop
2

Clone the OTEL Repository

Get the Claude Code OTEL project:

git clone https://github.com/ColeMurray/claude-code-otel.git
cd claude-code-otel
3

Start the Containers

Launch the OTEL collector and Grafana:

docker-compose up -d

This will start:

  • OpenTelemetry Collector on port 4317
  • Grafana Dashboard on port 3000
4

Access Grafana

Open your browser and navigate to:

http://localhost:3000

Default credentials:

  • Username: admin
  • Password: admin
5

Test the Connection

Launch Claude Code with the alias to verify OTEL connection:

cc

You should see:

Checking connection to OTEL collector at localhost:4317...
✅ OTEL collector is reachable at localhost:4317

📝 Post-Installation Configuration

Customize Environment Variables

Edit your ~/.env.cc file to adjust settings:

nano ~/.env.cc

Update the Alias

To update your CC alias after changes, simply run the installer again:

./create_cc_alias.sh

The script will detect the existing installation and prompt you to update.

Uninstall

To remove the CC alias:

  1. Edit ~/.zprofile and remove the cc() function
  2. Delete the configuration file: rm ~/.env.cc
Requirements Documentation