Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Changelog

1.0.0

First stable release.

  • Launcher that sets environment variables per profile and runs the official claude binary
  • All 235 official Claude Code environment variables supported as first-class YAML fields, plus an env: escape hatch for anything unmapped
  • Named profiles with automatic --<profile> shortcuts, collision-checked against Claude Code flags
  • Two-level config merge: user-level config (carries secrets) and optional project-level config (./ccode.yaml or ./.claude/ccode.yaml) merged at the field level
  • --config <path> flag to swap in an explicit project-level config
  • Global env: block applied to all profiles; per-profile env: blocks take priority
  • Subscription passthrough via the empty default: {} profile (launches Claude Code as-is with your existing subscription)
  • Auth validation per profile with [no auth] warning in ccode profiles
  • Built-in profile examples for Anthropic (direct + API), Amazon Bedrock, Bedrock Mantle, Google Vertex AI, Microsoft Foundry, DeepSeek, OpenRouter (with preset support), Z.AI, Moonshot Kimi, Alibaba Qwen, and MiniMax
  • Local model support (llama.cpp, vLLM, Ollama, LM Studio) via anthropic_base_url
  • Launch modes: always_control / always_auto / always_yolo config flags with matching --control / --auto / --yolo CLI overrides (and --no-* counterparts)
  • Warning when combining --control with --auto or --yolo, since Claude Code’s remote-control ignores permission flags at the time of writing
  • ccode init-config with --reset, --minimal, and custom output path
  • ccode edit-config opens the config in your preferred editor (command arg > $EDITOR > $VISUAL > platform default)
  • ccode install for user-level install, --system for system-wide; PATH updated via Windows registry + WM_SETTINGCHANGE broadcast, or shell rc files on Unix (bash, zsh, fish, .profile)
  • ccode profiles lists available profiles, default, launch modes, shortcuts, and auth status
  • Argument passthrough for unknown flags, with -- as the explicit passthrough sentinel
  • Subcommand typo hints (ccode init -> init-config, ccode --install -> install, etc.)
  • Cross-platform builds for Windows, Linux, and macOS (amd64 + arm64)
  • Pre-build drift detection against upstream Claude Code docs (env vars, CLI flags, config reference)
  • Em-dash and en-dash replacement script for consistent formatting
  • mdBook documentation site at ccode.kronis.dev