Access most Chinese LLMs — Kimi K3, Hunyuan3 (Hy3), DeepSeek-V4, GLM-5.2, MiniMax-M3 — inside OpenAI Codex through Tencent CodeBuddy.

English · 简体中文

codex-buddy is a local proxy setup that wires Codex's Responses API to CodeBuddy's Chat Completions, so you can use CodeBuddy's aggregated model catalog as the brain behind Codex App / CLI.

flowchart LR
    Codex["Codex App / CLI"] -->|Responses API| Gateway["opencodex\n127.0.0.1:10100"]
    Gateway -->|Chat Completions| Proxy["CodeBuddy2api\n127.0.0.1:8001"]
    Proxy --> CodeBuddy["CodeBuddy CN / Global"]
    CodeBuddy --> Models["Kimi / Hunyuan / DeepSeek / GLM / MiniMax / GPT / Claude"]

Instead of configuring Codex against a single model provider, CodeBuddy gives you a unified gateway to most domestic Chinese models:

CodeBuddy has two editions:

Both editions are supported by the proxy via CODEBUDDY_INTERNET_ENVIRONMENT.

./scripts/setup-codebuddy2api.sh

The script clones Sliverkiss/CodeBuddy2api, creates a venv, installs dependencies, and asks for your CODEBUDDY_API_KEY. Edit CodeBuddy2api/.env, then re-run the script.

To target the International edition, set this in CodeBuddy2api/.env:

CODEBUDDY_INTERNET_ENVIRONMENT=public

For the China edition (default):

CODEBUDDY_INTERNET_ENVIRONMENT=internal

Verify it is healthy:

curl http://127.0.0.1:8001/codebuddy/v1/models

npm install -g @bitkyc08/opencodex

ocx provider add codebuddy \
  --adapter openai-compatible \
  --base-url http://127.0.0.1:8001/codebuddy/v1 \
  --api-key dummy \
  --allow-private-network \
  --set-default \
  --sync

--api-key dummy is fine: real authentication is handled by CodeBuddy2api. --allow-private-network is required because the proxy runs on 127.0.0.1.

ocx start

Open Codex App or run codex. CodeBuddy models now appear in the model picker.

Use opencodex's provider/model routing:

# CLI
 codex -m "codebuddy/kimi-k3" "refactor this function"
 codex -m "codebuddy/hy3-high" "explain this algorithm"

In Codex App, pick the model directly from the picker. To browse available models visually, run:

ocx gui

Copy the contents of PROMPT.md into a Codex chat. Codex will install, configure, start, and verify the proxy automatically.

So you don't need to keep a terminal open:

ocx service install
ocx service start

Stop or restore at any time:

ocx stop        # stop proxy and restore native Codex
ocx restore     # restore Codex config without stopping

Confirm CodeBuddy returns tool_calls before relying on agent features:

curl http://127.0.0.1:8001/codebuddy/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model":"auto-chat",
    "messages":[{"role":"user","content":"calculate 1+1 with the calc tool"}],
    "tools":[{"type":"function","function":{"name":"calc","description":"calculate","parameters":{"type":"object","properties":{"expr":{"type":"string"}}}}}],
    "tool_choice":"auto"
  }'

If the response contains "tool_calls", Codex can read, edit, and execute. If not, your CodeBuddy account/model does not have function calling enabled.

codex-buddy/
├── README.md                 # This file
├── README_ZH.md              # 简体中文
├── PROMPT.md                 # Paste into Codex to auto-configure
├── scripts/
│   └── setup-codebuddy2api.sh # Start CodeBuddy2api
├── TROUBLESHOOTING.md        # Common issues
└── LICENSE                   # MIT

MIT