juanmackie

Ccswap — Development skill for Claude Code

Development community

A simple, cross-platform CLI tool for quickly switching between Claude Code configuration profiles by managing different settings.json versions.

How to install Ccswap

This entry records only its repository, not the path inside it, so there is no exact command to give. Open juanmackie/ccswap and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Ccswap does

A simple, cross-platform CLI tool for quickly switching between Claude Code configuration profiles by managing different settings.json versions. Built with ❤️ by Juan Mackie

Alternatives in Development

  • Native Feel Skill — An Agent Skill for designing cross-platform desktop apps that feel native — distilled from Raycast's 2.0 deep 1.9k ★
  • Creator Buddy — Creator Buddy: orchestrated Agent Skills for cross-platform content search, creator analysis, and viral trend 1.4k ★
  • Harness Improvement — Update Kandev harness files from session learnings or explicit cross-platform harness requests 697 ★

README

ccswap

A lightweight, cross-platform command-line tool for managing multiple Claude Code configuration profiles. It allows users to easily switch between different sets of configurations, such as API keys, endpoints, and model mappings, using simple commands like `ccswap use `. The tool supports both API key and OAuth2 authentication methods.

**Version:** 2.0.0 (with OAuth2 Device Code Flow support)

Built with ❤️ by JUAN MACKIE


Windows Installation

Method 1: System32 (Easiest)

  1. Download ccswap.bat
  2. Copy to C:\Windows\System32\ccswap.bat
  3. Open new Command Prompt and run: ccswap

Method 2: Custom Tools Directory

  1. Create C:\tools directory
  2. Copy ccswap.bat to C:\tools\ccswap.bat
  3. Add to PATH:
    • Press Win + R, type sysdm.cpl
    • Go to "Advanced" → "Environment Variables"
    • Edit "Path" → add C:\tools
  4. Restart Command Prompt and run: ccswap

Unix/Linux/macOS Installation

Method 1: System-wide (Recommended)

# Make executable
chmod +x ccswap

# Move to system path
sudo mv ccswap /usr/local/bin/

# Test
ccswap help

Method 2: User Local

# Create bin directory
mkdir -p ~/bin

# Move script
mv ccswap ~/bin/

# Add to PATH (add to ~/.bashrc or ~/.zshrc)
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Test
ccswap help

Verification

After installation, verify it works:

# Windows
ccswap help

# Unix/Linux/macOS  
ccswap help

You should see the usage information if installed correctly.

First Use

  1. Run Claude Code at least once to create settings.json
  2. Save your first profile: ccswap save default
  3. Create additional profiles as needed

Example profile for GLM 4.6

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "REDACTED-INSERT YOUR KEY",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL