glm-switch

GLM Switch Profile for claude-code

Public tool for Supermeo & Inwave DR Team

A CLI tool for managing multiple GLM API profiles in Claude Code/VS Code. Quickly switch between different GLM configurations without manual editing.

Features

• Multiple Profiles - Manage multiple profiles with different tokens and models
• Quick Switch - Switch between profiles with a single command
• Session-Local Start - Run GLM in only one terminal session without touching global settings
• Env Export - Print shell-specific exports for advanced workflows
• Bulk Update - Update config across all profiles at once
• Safe Operations - Automatic backup, JSON validation, and rollback on errors
• Cross-Platform - Support for Windows & macOS
• JSONC Support - Reads settings.json with comments
• Auto-Create - Automatically creates files if they don't exist

Installation

Method 1: Install from npm (Recommended)

npm install -g glm-switch

Method 2: Install from GitHub

# Clone repository
git clone https://github.com/supermeo-studio/glm-switch.git
cd glm-switch

# Setup
npm run setup

The npm run setup command will:

• Install dependencies
• Build TypeScript to JavaScript
• Create a global symlink via npm link

Profile Concept

Each profile is a separate GLM API configuration containing:

Config Key	Description
ANTHROPIC_BASE_URL	API endpoint for GLM
ANTHROPIC_AUTH_TOKEN	Authentication token
ANTHROPIC_DEFAULT_HAIKU_MODEL	Haiku model (lightweight)
ANTHROPIC_DEFAULT_SONNET_MODEL	Sonnet model (balanced)
ANTHROPIC_DEFAULT_OPUS_MODEL	Opus model (powerful)

Storage: Profiles are stored in ~/.claude/glm-switch/

Usage Guide

1. Create Your First Profile

# Create profile 0 with default values
glm-switch init 0

Output:

✓ Profile 0 created
  Config: {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5"
  }
  Don't forget to set your auth token:
  glm-switch set 0 token <your-token>

2. Set Token for Profile

# Set token for profile 0
glm-switch set 0 token your_token_here

3. Apply Profile

# Apply default profile (0)
glm-switch on

# Apply specific profile
glm-switch on 1

Important: After applying, restart Claude Code/VS Code for changes to take effect.

4. Start GLM for One Terminal Only (Recommended)

# Start a new child shell using profile 1 env
glm-switch start 1

# Exit child shell to return to your original terminal context
exit

This mode does not edit ~/.claude/settings.json, so other existing/new terminals keep their normal Claude setup.

5. Export Env to Current Shell (Advanced)

# macOS bash/zsh
eval "$(glm-switch env 1 --shell zsh)"

# fish
glm-switch env 1 --shell fish | source

# PowerShell
glm-switch env 1 --shell powershell | Invoke-Expression

Use this when you explicitly want to inject profile env into the current shell process.

6. Create Additional Profiles

# Create profile 1
glm-switch init 1

# Set different token for profile 1
glm-switch set 1 token another_token_here

# Apply profile 1
glm-switch on 1

7. Bulk Update - Update All Profiles

# Update Sonnet model for all profiles
glm-switch setall sonnet glm-5

# Update Opus model for all profiles
glm-switch setall opus glm-5

# Update Haiku model for all profiles
glm-switch setall haiku glm-4.5-air

# Update API endpoint for all profiles
glm-switch setall ANTHROPIC_BASE_URL https://api.z.ai/api/anthropic

8. List All Profiles

glm-switch list

Output:

Profiles:

[active] [default] 0
  Base URL: https://api.z.ai/api/anthropic
  Token: b8eb5131e...
  Haiku: glm-4.5-air
  Sonnet: glm-5
  Opus: glm-5

 1
  Base URL: https://api.z.ai/api/anthropic
  Token: (not set)
  Haiku: glm-4.5-air
  Sonnet: glm-5
  Opus: glm-5

9. Check Current Status

glm-switch status

10. Delete Profile

glm-switch delete 1

11. Disable GLM Mode (Restore Claude API)

glm-switch off

All Commands

Command	Description	Example
init [id]	Create a new profile	glm-switch init 0
set <id> <key> <value>	Set value for a specific profile	glm-switch set 0 token xxxx
setall <key> <value>	Set value for all profiles	glm-switch setall sonnet glm-5
on [id]	Apply profile (default: 0)	glm-switch on 1
start [id]	Start child shell with profile env only	glm-switch start 1
env [id] --shell <shell>	Print shell export commands	glm-switch env 1 --shell zsh
off	Remove GLM config	glm-switch off
status	Show current status	glm-switch status
list	List all profiles	glm-switch list
delete <id>	Delete a profile	glm-switch delete 1
--help	Show help	glm-switch --help
--version	Show version	glm-switch --version

Valid Config Keys

When using set or setall commands, you can use full keys or shorthand aliases:

ANTHROPIC_BASE_URL
ANTHROPIC_AUTH_TOKEN
ANTHROPIC_DEFAULT_HAIKU_MODEL
ANTHROPIC_DEFAULT_SONNET_MODEL
ANTHROPIC_DEFAULT_OPUS_MODEL
token
haiku
sonnet
opus

How It Works

File Storage Structure

~/.claude/
├── settings.json              # Claude Code settings
└── glm-switch/                # GLM Switch profiles directory
    ├── profile-0.json        # Profile 0 config
    ├── profile-1.json        # Profile 1 config
    ├── active-profile.json   # Currently active profile
    └── default-profile.json  # Default profile (0)

Profile File Format

{
  "id": "0",
  "config": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your-token-here",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5"
  },
  "createdAt": "2025-01-14T10:00:00.000Z",
  "updatedAt": "2025-01-14T10:00:00.000Z"
}

Settings.json Modification

When running glm-switch on [id], the tool injects config from the profile into ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your-token-here",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5"
  }
}

Session-Local Mode (No Global Changes)

When running glm-switch start [id], the tool:

• Starts a new child shell at current cwd
• Injects profile env only into that child session
• Does not modify ~/.claude/settings.json
• Leaves other terminals unaffected

Recommended Workflows

First-Time Setup

# 1. Create profile 0
glm-switch init 0

# 2. Set your token
glm-switch set 0 token your_token_here

# 3. Apply
glm-switch on

# 4. Restart Claude Code

Add New Profile

# 1. Create new profile
glm-switch init 1

# 2. Set token
glm-switch set 1 token another_token

# 3. Apply when needed
glm-switch on 1

Use GLM in One Terminal, Keep Others Default

# Start isolated GLM shell from current directory
glm-switch start 1

# Work with GLM in this shell only...

# Exit back to normal Claude environment
exit

Update Models for All

glm-switch setall sonnet glm-5
glm-switch setall opus glm-5
glm-switch setall haiku glm-4.5-air

Safety Features

• Automatic Backup - Creates .backup file before modifying
• Atomic Writes - Uses temp files to prevent corruption
• JSON Validation - Validates structure before writing
• Rollback on Error - Restores from backup if modification fails
• Non-destructive - Preserves other settings
• Session isolation - start mode does not change global settings
• No hardcoded token default - Profile token defaults to empty

Troubleshooting

Command not found after installation

# Close and reopen terminal
# Or check npm bin path
npm bin -g

# Ensure npm bin is in your PATH

Changes not taking effect

# 1. Check status
glm-switch status

# 2. Restart Claude Code/VS Code COMPLETELY
# 3. Check status again

Profile does not exist

# List all profiles
glm-switch list

# Create profile if needed
glm-switch init 0

Invalid config key

✗ Invalid config key: invalid_key
  Valid keys: ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL

Permission errors

Windows: Run terminal as Administrator

macOS:

# Check permissions
ls -la ~/.claude/

# Fix permissions
chmod 644 ~/.claude/settings.json

Development

Clone & Setup

git clone https://github.com/supermeo-studio/glm-switch.git
cd glm-switch
npm run setup

Build

npm run build

Watch Mode

npm run dev

Clean

npm run clean

Uninstallation

Global npm package

npm uninstall -g glm-switch

Manual cleanup (optional)

# Remove profiles directory
rm -rf ~/.claude/glm-switch

Platform Support

Platform	Status	Settings Location
Windows 10/11	✅ Supported	C:\Users\{username}\.claude\settings.json
macOS	✅ Supported	~/.claude/settings.json
Linux	⚠️ Untested	~/.claude/settings.json

Version History

v2.0.5 (Current)

• ✨ New command: start [id] for session-local GLM shell (no global settings changes)
• ✨ New command: env [id] --shell <shell> for shell export output
• 🔒 Security: removed hardcoded auth token default
• 🧩 Added shorthand config key aliases: token, haiku, sonnet, opus

v2.0.0

• ✨ Multi-profile support
• ✨ New commands: init, set, setall, list, delete
• ✨ Profile storage in ~/.claude/glm-switch/
• ✨ Default profile concept

v1.1.0

• ✅ JSONC support (comments in settings.json)
• ✅ Auto-create settings.json

v1.0.0

• 🎉 Initial release
• ✅ Basic on/off switching

License

MIT © Supermeo & Inwave DR Team

Links

• npm: https://www.npmjs.com/package/glm-switch
• GitHub: https://github.com/supermeo-studio/glm-switch

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.