Ccswap — Development skill for Claude Code
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)
- Download
ccswap.bat - Copy to
C:\Windows\System32\ccswap.bat - Open new Command Prompt and run:
ccswap
Method 2: Custom Tools Directory
- Create
C:\toolsdirectory - Copy
ccswap.battoC:\tools\ccswap.bat - Add to PATH:
- Press
Win + R, typesysdm.cpl - Go to "Advanced" → "Environment Variables"
- Edit "Path" → add
C:\tools
- Press
- 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
- Run Claude Code at least once to create
settings.json - Save your first profile:
ccswap save default - 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
Related Skills
Cc Switch Simple
Cross-platform Rust CLI for switching Claude Code JSON profiles and Codex config presets.
Claude Version Picker
Windows wrapper that let's you chose between 2 different Claude Code versions you want to use. Simply enter th
RayCast Claude Code Config Selector
A Raycast extension for managing Claude Code API configurations. Easily switch between different Claude Code e
Cctx
Claude Code context manager for switching between multiple settings.json configurations
Xiaobai Switch
小白也能上手的 Claude Code / Codex 上游配置切换桌面应用 A cross-platform, site-driven desktop app for switching Claude Code & C
Opencode Claude Auth Sync
Sync Claude CLI credentials to OpenCode with cross-platform multi-account support, quota tracking, rotation, a
Related Agents
Unity Build Runner
Configures and triggers Unity builds via MCP. Handles platform switching, player settings, build profiles, Add
AgentCrew Configuration Guide
This guide explains how to configure AgentCrew to work with different AI providers, customize agents, set up t
Configuration Manager
Configuration and environment management expert that handles application settings, secrets, and deployment con