# chatgpt-codex-onboarding

Connects a ChatGPT or Codex subscription through OAuth device-code login so you can use gpt-5-codex models without an API key.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2500 installs · ★ 29
- Author: starchild
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/chatgpt-codex-onboarding/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/chatgpt-codex-onboarding

## What it does

The skill runs a device-code login for a ChatGPT Plus, Pro or Team subscription. It hands you a verification URL and a user code to enter in the browser by hand. Once you approve, the token is written to disk and the models show up under the `openai-codex/` prefix.

It is a script-mode skill, so no tools get registered. You read the file and call the exports from a `bash` block. The exports are `status`, `start`, `poll`, `logout`, `refresh`, `models` and `usage`. Each returns a dict with `ok: True` on success or `ok: False` plus an error string.

One thing to watch: after `poll()` reports success, the web frontend does not refresh the model list on its own. The user has to reload the page manually, otherwise the new models never appear in the picker and the connection looks broken. From then on, calls go straight to OpenAI with the OAuth token, bypassing the platform proxy, and they draw on subscription limits rather than the platform credit balance. This is not BYOK — if you already hold an OpenAI API key, you want a different skill.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill chatgpt-codex-onboarding -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/chatgpt-codex-onboarding/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/chatgpt-codex-onboarding/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill chatgpt-codex-onboarding -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/chatgpt-codex-onboarding/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill chatgpt-codex-onboarding -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/chatgpt-codex-onboarding/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills chatgpt-codex-onboarding
```

2. **Manually: put the files in place**
- File: `.github/skills/chatgpt-codex-onboarding/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill chatgpt-codex-onboarding -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path chatgpt-codex-onboarding
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/chatgpt-codex-onboarding/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill chatgpt-codex-onboarding -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/chatgpt-codex-onboarding/SKILL.md

## When to use it
- sign in with a ChatGPT subscription without an API key
- get gpt-5-codex access through OAuth
- check whether a credential is already stored
- log out and wipe the stored credentials
- read subscription usage stats

## Example prompts
- Connect my Claude subscription through OAuth
- Sign in to my Claude account and show me the URL and code
- Check the OAuth status and refresh the token if it expired

## Similar
- [build-chatgpt-app](https://affpapa.org/en/nevibecode/skills/build-chatgpt-app.md) — skill · 16 installs
- [oracle](https://affpapa.org/en/nevibecode/skills/steipete-oracle.md) — skill · 505 installs
- [chatgpt-app-builder](https://affpapa.org/en/nevibecode/skills/chatgpt-app-builder.md) — skill · 7100 installs
- [login-flow](https://affpapa.org/en/nevibecode/skills/login-flow.md) — skill · 2800 installs
- [google-agents-cli-onboarding](https://affpapa.org/en/nevibecode/skills/google-agents-cli-onboarding.md) — skill · 6434 installs
- [customer-churn-signals](https://affpapa.org/en/nevibecode/skills/customer-churn-signals.md) — skill · 20500 installs

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 30 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md