---
title: "coding.sh proxy · coding.sh docs"
description: "Run a local Anthropic/OpenAI API proxy that logs every model call. Every option of coding.sh proxy and its subcommands, from its own --help."
canonical: https://coding.sh/docs/cli/proxy
human_url: https://coding.sh/docs/cli/proxy
markdown_url: https://coding.sh/docs/cli/proxy.md
agents_url: https://coding.sh/agents.md
llms_url: https://coding.sh/llms.txt
updated: 2026-11-11
---

# coding.sh proxy

Run a local Anthropic/OpenAI API proxy that logs every model call. Every option of coding.sh proxy and its subcommands, from its own --help.

coding.sh proxy --help

```
coding.sh proxy [action] [options]

  Run a local Anthropic/OpenAI API proxy that logs every model call

Commands
  status        Show whether a proxy is running, and where (exit 1 when not)
  stop          Stop the background proxy
  env           Print the ANTHROPIC_BASE_URL / OPENAI_BASE_URL exports for the proxy

Options
  -p, --port <PORT>               Port to listen on, 0 = any free port ([proxy] port) (default: 4320)
      --host <HOST>               Interface to bind ([proxy] host) (default: 127.0.0.1)
      --anthropic-upstream <URL>  Where Anthropic calls go, e.g. a gateway ([proxy] anthropic_upstream) (default: https://api.anthropic.com)
      --openai-upstream <URL>     Where OpenAI calls go ([proxy] openai_upstream) (default: https://api.openai.com)
      --background                Start detached, print the URL once it answers (log: ~/.coding.sh/proxy.log)
  -q, --quiet                     No line per call on stderr

Examples
  coding.sh proxy
  coding.sh proxy --background
  coding.sh init --proxy

Notes
  Forwards /v1/messages (and count_tokens), /v1/chat/completions, /v1/responses and every other path to the real API with the client's own auth headers. Auth headers are never stored.
  Streams pass through as they arrive. A failed store write never fails the request.
  Calls from Claude Code and Codex land in the session their hooks capture; other clients get a proxy-<hash> session per conversation (or send x-coding-sh-session: <id>).
  Prints the environment to stdout; one line per call goes to stderr.
```

## `coding.sh proxy status`

Show whether a proxy is running, and where (exit 1 when not).

coding.sh proxy status --help

```
coding.sh proxy status

  Show whether a proxy is running, and where (exit 1 when not)

Examples
  coding.sh proxy status
```

## `coding.sh proxy stop`

Stop the background proxy.

coding.sh proxy stop --help

```
coding.sh proxy stop

  Stop the background proxy

Examples
  coding.sh proxy stop
```

## `coding.sh proxy env`

Print the ANTHROPIC_BASE_URL / OPENAI_BASE_URL exports for the proxy.

coding.sh proxy env --help

```
coding.sh proxy env

  Print the ANTHROPIC_BASE_URL / OPENAI_BASE_URL exports for the proxy

Examples
  eval "$(coding.sh proxy env)"
```

[All commands](https://coding.sh/docs/cli) · [Global options](https://coding.sh/docs/cli#global)

To set coding.sh up for a user, follow the agent workflow at [/agents.md](https://coding.sh/agents.md).