Federation & Service

Local Proxy

Use a skill to create a local Federation service backed by Codex or Claude Code through CLIProxyAPI

Local Proxy

Use the Downcity local proxy skill when you want a local Federation service that exposes Codex or Claude Code model access without registering anything into an existing Fed server.

The generated project runs:

  • CLIProxyAPI on 127.0.0.1:8317
  • Downcity local Federation on 127.0.0.1:3000
  • Model endpoints under /v1/ai/models and /v1/ai/chat/completions

Install the skill

Install the skill with the Vercel Labs skills CLI:

npx skills add https://github.com/wangenius/downcity-local-proxy-skill \
  --skill downcity-local-proxy \
  --agent codex \
  --global \
  --yes

Prompt Codex

After installing, ask Codex:

Use downcity-local-proxy to create ./downcity/local-proxy with Codex and Claude Code enabled, then install dependencies and start the local Federation service.

Start manually

The skill creates a standalone project. From the generated directory:

cd ./downcity/local-proxy
pnpm install
pnpm start --codex
pnpm start --claude-code
pnpm start --codex --claude-code

Use --login when CLIProxyAPI needs OAuth setup or refresh:

pnpm start --codex --login
pnpm start --claude-code --login

The local proxy writes runtime files under .downcity/ inside the generated project. It does not modify global Downcity CLI state or register itself with an existing Fed server.

Continue with: