# Oc Codex Setup

> Install or refresh oc-codex-multi-auth in OpenCode, choose the right config mode, and verify Codex OAuth with ChatGPT Plus or Pro access.

- Skill: `ndycode/oc-codex-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ndycode/oc-codex-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ndycode/oc-codex-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: ndycode (https://skillmd.com/u/ndycode)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ndycode/oc-codex-setup

---


# oc-codex-setup

Use this skill when the user wants to install, reinstall, upgrade, or troubleshoot `oc-codex-multi-auth` in OpenCode.

## Default install (provider preserving)

```bash
npx -y oc-codex-multi-auth@latest
```

This is the default. It registers the OpenCode and TUI plugin entries without changing `provider.openai`.

## Compact modern catalog

```bash
npx -y oc-codex-multi-auth@latest --modern
```

Use this when the shipped 13 base OAuth model families and 59 OpenCode variant presets are required.

## Config-safe update

```bash
npx -y oc-codex-multi-auth@latest update
```

Use this to refresh an existing installation. It only clears the managed package cache and never reads or writes `opencode.json` or `tui.json`. Restart OpenCode afterward.

## Plugin-only install

```bash
npx -y oc-codex-multi-auth@latest install --plugin-only
```

Use this when the user already manages `provider.openai`. It registers the OpenCode and TUI plugin entries without changing that provider configuration.

## Full install (explicit selector IDs)

```bash
npx -y oc-codex-multi-auth@latest --full
```

Use this when the user needs direct selector IDs such as `openai/gpt-5.5-medium`, `openai/gpt-6-astra-high`, or `openai/gpt-5.6-sol-high` in addition to the compact bases.

## Legacy install (older OpenCode)

```bash
npx -y oc-codex-multi-auth@latest --legacy
```

Use this on older OpenCode versions that do not support variant-based model entries. Installs 59 explicit model IDs only.

## Other installer flags

- `--dry-run` — show changed config paths without values or writes
- `--no-cache-clear` — skip clearing the OpenCode plugin cache
- `--modern` — install the compact modern catalog
- `--plugin-only` — preserve `provider.openai`; cannot be combined with a catalog mode

## Standalone CLI (no agent cost)

```bash
oc-codex-multi-auth status
oc-codex-multi-auth list
oc-codex-multi-auth warm
oc-codex-multi-auth doctor
```

Also available: `limits`, `dashboard`, `health`, `diag`.

## Login and verification

1. Run `opencode auth login`.
2. Run a quick verification request after OpenCode or `--modern` supplies the selector:

```bash
opencode run "Explain this repository" --model=openai/gpt-5.5 --variant=medium
```

Do **not** use `openai/gpt-5.5-medium` unless the user installed with `--full` or `--legacy`.

3. Optional GPT-6 Astra / GPT-5.6 smoke:

```bash
opencode run "Explain this repository" --model=openai/gpt-6-astra --variant=medium
opencode run "Explain this repository" --model=openai/gpt-5.6-sol --variant=medium
```

4. For a Codex-focused workflow, try:

```bash
opencode run "Refactor the retry logic and update the tests" --model=openai/gpt-5-codex --variant=high
```

5. After `--full`, explicit IDs are valid:

```bash
opencode run "Explain this repository" --model=openai/gpt-5.5-medium
```

## Troubleshooting

- Confirm `"plugin": ["oc-codex-multi-auth"]` is present in the OpenCode config.
- Re-run `opencode auth login` if tokens expired or the wrong workspace was selected.
- Inspect `~/.opencode/logs/codex-plugin/` after a failed request.
- Set `ENABLE_PLUGIN_REQUEST_LOGGING=1` for deeper request logging.
- For full docs, see `docs/getting-started.md`, `docs/configuration.md`, `docs/troubleshooting.md`, and `docs/faq.md`.

## Usage boundaries

This project is for personal development use with your own ChatGPT Plus or Pro subscription. For production or shared services, prefer the OpenAI Platform API.