Quickstart

​

Choose your OS

• macOS: Use Terminal or iTerm and store tool configs under ~/.tool-name/
• Linux: Use your normal shell and the same ~/.tool-name/ config layout
• Windows: Use PowerShell and store tool configs under %USERPROFILE%\.tool-name\
• WSL: Follow the Linux examples inside your WSL environment

​

Reuse these values everywhere

​

macOS and Linux

export APPLEAI_BASE_URL=https://api.appleai.codes/v1
export APPLEAI_API_KEY=YOUR_APPLEAI_API_KEY
export APPLEAI_MODEL=anthropic/claude-sonnet-4

​

Windows PowerShell

$env:APPLEAI_BASE_URL="https://api.appleai.codes/v1"
$env:APPLEAI_API_KEY="YOUR_APPLEAI_API_KEY"
$env:APPLEAI_MODEL="anthropic/claude-sonnet-4"

​

Basic flow

1. Create or copy an appleai.codes API key.
2. Pick a routed model path such as anthropic/claude-sonnet-4 or openai/gpt-5.
3. Open the guide for your tool and paste the shared values into its config.
4. Run one simple request to confirm the endpoint and key work together.

​

Verify the connection first

​

macOS and Linux

curl https://api.appleai.codes/v1/models \
  -H "Authorization: Bearer $APPLEAI_API_KEY"

​

Windows PowerShell

curl.exe https://api.appleai.codes/v1/models `
  -H "Authorization: Bearer $env:APPLEAI_API_KEY"

​

Recommended order

1. Start with Claude Code, Codex CLI, or OpenCode. They expose direct config files.
2. Move to Cursor, Cline, Continue, or Roo when you want editor integration.
3. Use the MITM-only tools flow only when the product does not let you enter a custom base URL.

​

Pick a guide