Skip to main content
Interactive setup wizard that detects your project type, generates CA certificates, creates a cordon.yaml config file, and provides language-specific trust guidance.

​
Usage

cordon setup [OPTIONS]
cordon setup <INTEGRATION> [OPTIONS]

​
Options

OptionDescription
--yesSkip confirmation prompts
--regenerate-caRegenerate the CA certificate
--trustAdd CA to system trust store
--no-trustSkip trust store prompt

​
Examples

# Interactive setup
cordon setup

# Non-interactive setup with trust
cordon setup --yes --trust

​
Integration subcommands

​
cordon setup claude-code

Configure cordon for Claude Code. Generates certs, creates config, and writes proxy env vars to Claude Code’s settings.json. 
# Project-scoped setup
cordon setup claude-code

# Global setup with background service
cordon setup claude-code --global

# Remove the setup
cordon setup claude-code --remove
OptionDescription
--globalInstall globally with a background service
--removeRemove the cordon setup
--yesSkip confirmation prompts
--trust-systemAdd the CA cert to the OS trust store (requires sudo)

​
What setup does

  1. Detects the project type and language ecosystem
  2. Generates CA certificates at ~/.config/cordon/projects/<name>/certs/
  3. Creates cordon.yaml with absolute cert paths
  4. Provides language-specific trust guidance (e.g., NODE_EXTRA_CA_CERTS for Node.js)