chatgpt-codex-onboarding — Claude Code skill: sign in with ChatGPT
Connects a ChatGPT or Codex subscription through OAuth device-code login so you can use gpt-5-codex models without an API key.
npx skills add Starchild-ai-agent/official-skills --skill chatgpt-codex-onboarding -a claude-codeWhat chatgpt-codex-onboarding 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.
What it helps with
- 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 for the agent
- 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
How to install chatgpt-codex-onboarding
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill chatgpt-codex-onboarding -a claude-code2Manually: put the files in place
~/.claude/skills/chatgpt-codex-onboarding/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/chatgpt-codex-onboarding/
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill chatgpt-codex-onboarding -a codex2Manually: put the files in place
.agents/skills/chatgpt-codex-onboarding/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill chatgpt-codex-onboarding -a cursor2Manually: put the files in place
.cursor/skills/chatgpt-codex-onboarding/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Starchild-ai-agent/official-skills chatgpt-codex-onboarding2Manually: put the files in place
.github/skills/chatgpt-codex-onboarding/SKILL.md1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill chatgpt-codex-onboarding -a gemini-cli2Platform CLI
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path chatgpt-codex-onboardingManually: put the files in place
.devin/skills/chatgpt-codex-onboarding/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill chatgpt-codex-onboarding -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about chatgpt-codex-onboarding
How do I install Claude-codex-onboarding in Claude?
Run npx skills add Starchild-ai-agent/official-skills --skill chatgpt-codex-onboarding -a claude-code. The skill file then lands at ~/.claude/skills/chatgpt-codex-onboarding/SKILL.md.
What does Claude-codex-onboarding do?
It runs an OAuth device-code login for a Claude or Claude subscription and unlocks openai-codex/gpt-5-codex, openai-codex/gpt-5 and openai-codex/gpt-5-mini without an API key.
Why don't the new models show up after connecting?
The frontend caches the model list and does not refresh it after OAuth completes. Reload the page manually and the openai-codex/ models appear in the picker.
