Agentic Engineering Amplified

Cloding is a universal wrapper that lets you run Claude Code, Gemini CLI, Codex CLI, OpenCode, or GitHub Copilot CLI — use OpenRouter, Direct API keys, or link to your paid plan.

Cloding Terminal Demo

Code with any LLM in a Docker sandbox. Configurable multi-stage code orchestration

Claude Opus 4.6 costs 5ドル/25ドル per Mtok.
Qwen 3 Coder Next costs 0ドル.12/0ドル.75 per Mtok.
That's 42x cheaper on input, 33x cheaper on output.

Run multiple coding CLIs from one command, with model shortcuts and optional pipeline orchestration.

Supported tools:

• Claude Code (claude)
• Gemini CLI (gemini)
• Codex CLI (codex)
• GitHub Copilot CLI (copilot)
• OpenCode (opencode, via custom model entries)

Cloding enhances your development workflow through:

Seamlessly switch between leading AI coding assistants using a single, unified interface.

Leverage deeply discounted models via OpenRouter while maintaining high performance. Avoid expensive subscription lock-ins.

Run AI-generated code safely. The built-in Docker mode executes tools in an isolated sandbox with configurable CPU/memory limits, preventing untrusted code from accessing your host system.

The Python-based orchestrator enables multi-stage workflows:

• Plan: Analyze requirements and design solutions.
• Explore: Gather context from large codebases.
• Code: Implement the planned changes.
• Review: Automatically verify and refine the code.

Read our comprehensive documentation site for in-depth walkthroughs and a dedicated Troubleshooting guide.

No Node.js required — download a single standalone binary:

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/claudlos/cloding/master/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/claudlos/cloding/master/install.ps1 | iex

If you already have Node.js 18+ installed:

npm i -g cloding

Installing Node.js 18+
If you don't have Node.js installed, you can quickly install the latest version using the following commands:

macOS / Linux (via nvm):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install node

Windows (PowerShell via winget):

winget install OpenJS.NodeJS

(Alternatively, you can download the official installer directly from nodejs.org)

# 1. Set your OpenRouter API key
export OPENROUTER_API_KEY=sk-or-v1-your-key-here
# 2. Install all CLI tools (Claude Code, Gemini, Codex, Copilot, OpenCode)
cloding setup
# 3. Start coding!
cloding

cloding # interactive (default: qwen)
cloding -m sonnet # choose a specific shortcut
cloding -p "fix failing tests" # one-shot prompt
cloding --list-models # list shortcuts and prices
cloding -h # view help

cloding setup detects and installs all supported CLI tools:

cloding setup # check status + install missing tools
cloding setup --check # status report only, no installation
cloding setup --force # reinstall all tools

It checks for:

Prerequisites (detected, not installed):

• Node.js 18+
• Python 3.11+ (for pipeline mode)
• Docker (for Docker mode)

CLI Tools (detected + installed automatically):

• Claude Code — via native installer
• Gemini CLI — via npm
• Codex CLI — via npm
• GitHub Copilot CLI — via npm
• OpenCode — via npm

Each Anthropic model (haiku, sonnet, opus) supports three routing modes:

Examples:

cloding -m sonnet # Sonnet via OpenRouter (default)
cloding -m sonnet-o # Sonnet via OpenRouter (explicit)
cloding -m sonnet-a # Sonnet via your Anthropic API key
cloding -m sonnet-p # Sonnet via your Claude paid plan

Other tools use their own auth:

OPENROUTER_API_KEY=sk-or-v1-your-key-here
CLODING_DEFAULT_MODEL=qwen
# Direct Anthropic API key (for -a variants: haiku-a, sonnet-a, opus-a)
ANTHROPIC_API_KEY=sk-ant-your-key-here
# Optional direct-provider keys
GOOGLE_API_KEY=your-google-api-key
OPENAI_API_KEY=your-openai-api-key
GITHUB_TOKEN=your-github-token

If you want to use account linking instead of API keys, open each CLI directly once and complete sign-in:

gemini
copilot

With current behavior:

• cloding -m gemini can run with linked account; if OPENROUTER_API_KEY is unset, cloding uses Gemini CLI account mode.
• cloding -m gemini-3 can run with linked account; GOOGLE_API_KEY is optional in that case.
• cloding -m copilot can run with linked account; GITHUB_TOKEN is optional in that case.

Any OpenRouter model ID can be passed directly:

cloding -m meta-llama/llama-4-scout

cloding -m qwen
cloding -m sonnet-a -p "review this file" # direct Anthropic API
cloding -m opus-p # use Claude paid plan
cloding -m codex-5 "implement retry logic"
cloding -m codex-5-a "implement retry logic"
cloding -m copilot

Unknown flags are passed through to the underlying CLI.

cloding docker build
cloding docker run "fix lint errors"
cloding docker run -m sonnet-a "build endpoint tests"
cloding docker run -m codex-5 "debug my code"
cloding docker run -m opus-p "make a plan"
cloding docker shell -m sonnet
cloding docker status
cloding docker stop
cloding docker clean

Docker options:

cloding docker run -w /path/to/project "prompt" # mount workspace
cloding docker run --memory 4g --cpus 2 "prompt" # resource limits
cloding docker run --name my-container "prompt" # custom name
cloding docker run --no-rm "prompt" # keep after exit

Important current behavior:

• cloding docker run/shell requires the selected model's auth env var (for example: OPENROUTER_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_API_KEY, or GITHUB_TOKEN).
• Plan mode (-p variants) does not require any API key.
• Docker images include all supported CLIs.

cd pipeline
pip install -e .
cloding pipeline "Add auth middleware" --workspace ./myapp --no-docker
cloding pipeline -c configs/default.yaml "Refactor API layer"
cloding pipeline --dry-run -c configs/default.yaml "preview only"
cloding pipeline --resume code --run-id <run-id> "original request"

Pipeline flags:

• -c, --config — Path to YAML pipeline config
• -w, --workspace — Path to target workspace
• -f, --file — Read request from file
• --context-files — Comma-separated list of key files
• --no-docker — Run locally instead of in Docker
• --no-git — Skip git workspace preparation
• --dry-run — Print config and exit
• --resume STAGE — Resume from a specific stage
• --run-id ID — Run ID to resume from
• --prompts-dir — Prompt templates directory
• -v, --verbose — Debug logging

• OpenRouter key — for default/OpenRouter shortcuts (get one here)
• Node.js 18+ — required for CLI tool installs (Claude Code, Gemini, etc.)
• Node.js 24+ — if you want to run copilot / cloding -m copilot
• Docker — optional, for Docker mode
• Python 3.11+ — optional, for pipeline mode

Tip: Run cloding setup to automatically detect and install all CLI tools.

Add entries in models.json:

{
 "my-model": {
 "id": "provider/model-id",
 "name": "My Model",
 "tool": "gemini",
 "provider": "google",
 "api_key_env": "GOOGLE_API_KEY",
 "in": 0.0,
 "out": 0.0
 }
}

Supported tool values: claude (default), gemini, codex, copilot, opencode

Supported provider values: openrouter (default), anthropic, plan, google, openai, github

MIT