Skip to content
Swixter Docs

Quick Start

Quick Start

Section titled “Quick Start”

This guide walks you through creating your first Swixter profile and applying it to an AI coding assistant.

1. Install Swixter

Section titled “1. Install Swixter”

Pick whichever channel fits your setup:

Terminal window
# Shell installer (macOS / Linux)
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/dawnswwwww/swixter/releases/latest/download/swixter-installer.sh | sh


# Homebrew
brew install dawnswwwww/tap/swixter


# npm
npm install -g swixter

See Installation for Cargo, PowerShell, and other options.

2. List Available Providers

Section titled “2. List Available Providers”

Swixter comes with built-in providers and supports user-defined ones:

Terminal window
swixter providers list

Output shows built-in and user-defined providers, including their wire_api type (used for Codex compatibility).

3. Create a Profile

Section titled “3. Create a Profile”

A profile bundles a provider with your API key and settings:

Terminal window
swixter claude create my-profile

The interactive prompt asks for:

  • Provider: Choose from Anthropic, Ollama, or custom providers
  • API Key: Your provider’s API key (stored locally)
  • Base URL: Optional custom endpoint (for Ollama or proxies)
  • Model: Optional default model
  • Auth Token: (Claude only) Optional ANTHROPIC_AUTH_TOKEN

4. Switch to Your Profile

Section titled “4. Switch to Your Profile”

Set the profile as active for a coder:

Terminal window
swixter claude switch my-profile

Profiles are per-coder — you can have different active profiles for Claude Code vs Codex.

5. Apply the Profile

Section titled “5. Apply the Profile”

Write the active profile to the coder’s config file:

Terminal window
swixter claude apply

This writes the configuration to the coder’s native config file (e.g., ~/.claude/settings.json for Claude Code).

6. Launch Your Coder

Section titled “6. Launch Your Coder”
Terminal window
claude

Your coder is now using the Swixter-managed configuration.

Common Workflow

Section titled “Common Workflow”
Terminal window
# Create profiles for different providers
swixter claude create work-profile    # Anthropic
swixter claude create local-profile   # Ollama


# Switch between them
swixter claude switch work-profile
swixter claude apply


# List all profiles
swixter claude list


# Edit a profile
swixter claude edit work-profile

Using with Codex

Section titled “Using with Codex”

Codex requires environment variables set before launch. Use the run command:

Terminal window
swixter codex create codex-profile
swixter codex switch codex-profile
swixter codex run  # applies profile, sets env vars, launches codex

Next Steps

Section titled “Next Steps”