Claude Code

Prerequisites

• Node.js 18 or newer installed on your system (for npm installation)
• An Apertis API Key (obtain from Apertis Dashboard)

Installation

Native Installer (Recommended)

macOS / Linux / WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

npm Installation

Alternatively, install via npm with Node.js 18+:

npm install -g @anthropic-ai/claude-code

Configuration

Configure Claude Code to connect to Apertis API using the switch script below. You only need to modify two values: your API key and your preferred default model.

Setup

Create a file named ccswitch.sh in your home directory (or any location you prefer):

#!/usr/bin/env bash

# ─── User Configuration ────────────────────────────────────────
# Replace the values below with your own credentials and preferences.

APERTIS_BASE_URL="https://api.apertis.ai"
APERTIS_AUTH_TOKEN="your_apertis_api_key"      # ← Your API key from https://apertis.ai/setting?tab=keys
DEFAULT_MODEL="code:claude-opus-4-8"            # ← Default model when using --apertis

# ─── Script Logic (no changes needed below) ────────────────────

usage() {
  cat <<EOF
Usage:
  ccs --apertis          Switch to Apertis API (uses DEFAULT_MODEL)
  ccs --cc               Revert to default Anthropic endpoint
  ccs --model <model-id> Switch to Apertis with a specific model
EOF
}

export_apertis() {
  local model="$1"

  export ANTHROPIC_BASE_URL="$APERTIS_BASE_URL"
  export ANTHROPIC_AUTH_TOKEN="$APERTIS_AUTH_TOKEN"
  export ANTHROPIC_MODEL="$model"

  echo "✅ Apertis enabled"
  echo "   MODEL=$ANTHROPIC_MODEL"
}

unset_all() {
  unset ANTHROPIC_BASE_URL
  unset ANTHROPIC_AUTH_TOKEN
  unset ANTHROPIC_MODEL

  echo "🧹 Anthropic env unset — reverted to defaults"
}

if [[ $# -eq 0 ]]; then
  usage
  return 1
fi

case "$1" in
  --apertis)
    export_apertis "$DEFAULT_MODEL"
    ;;
  --cc)
    unset_all
    ;;
  --model)
    if [[ -z "$2" ]]; then
      echo "❌ Missing model id"
      usage
      return 1
    fi
    export_apertis "$2"
    ;;
  *)
    usage
    return 1
    ;;
esac

Activate the Script

Add the following alias to your shell profile (~/.bashrc or ~/.zshrc):

alias ccs="source ~/ccswitch.sh"

Then reload your shell:

source ~/.zshrc  # or source ~/.bashrc

Commands

Configuration Variables

Edit the top of ccswitch.sh to match your credentials:

Available Model IDs

When using ccs --model, pass the model ID directly. Only Claude models require the code: prefix; all other models use their standard ID as-is.

Claude Models (require code: prefix, except Haiku):

For more Claude models, see the Claude Models page.

Other Models (no prefix needed):

ccs --model gpt-5.4
ccs --model gemini-3.1-pro-preview
# and more...

For the full list of available model IDs, check the Model List.

Example Usage

# Switch to Apertis with the default model
ccs --apertis
# ✅ Apertis enabled
#    MODEL=code:claude-opus-4-8

# Switch to a specific model
ccs --model code:claude-sonnet-4-6
# ✅ Apertis enabled
#    MODEL=code:claude-sonnet-4-6

# Revert to default Anthropic endpoint
ccs --cc
# 🧹 Anthropic env unset — reverted to defaults

Launch and Verify

Navigate to your project directory and start Claude Code:

cd your-project-directory
claude

Grant file access permissions when prompted.

Verify Connection

Run the status command inside Claude Code to verify your configuration:

/status

You should see output similar to:

Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://api.apertis.ai

Model Configuration

Coding Model IDs

When using Claude Code (or any coding tool) with Apertis, use the code: prefix for Claude model IDs. This routes requests through optimized coding channels:

Selecting Models in Claude Code

You can also switch models directly inside Claude Code using the /model command:

/model

Your configured model ID will appear in the list. Select it to start using a different model.

For the latest available models, check the Model List.

Troubleshooting

Configuration Not Taking Effect

• Close all Claude Code windows and open a new terminal
• Run ccs --apertis again to re-export environment variables
• Then run claude to start with new settings

Verify Configuration

Inside Claude Code, run /status to verify the API endpoint:

Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://api.apertis.ai

Connection Issues

If you encounter connection errors:

1. Verify your API key is correct at Apertis Dashboard
2. Ensure APERTIS_BASE_URL in ccswitch.sh is https://api.apertis.ai
3. Check your network connection and firewall settings

Tool Use Failures

If Claude Code fails to execute file operations or commands:

• Ensure your selected model supports tool use capabilities
• All Claude models available through Apertis support tool use
• Check that you have granted the necessary file access permissions

Features

Claude Code provides powerful capabilities including:

• Code Understanding: Analyzes your entire codebase context
• Automated Refactoring: Helps refactor and improve code quality
• Git Workflow: Manages commits, branches, and pull requests
• Bug Fixing: Identifies and helps fix issues in your code
• Documentation: Generates documentation and comments
• Testing: Helps write and run tests

Related Resources

• Apertis API Documentation
• Model List
• API Keys Management
• Claude Code Official Documentation