{"id":51311196,"url":"https://github.com/yujingz/use-claude-code-from-codex","last_synced_at":"2026-07-01T04:02:25.330Z","repository":{"id":365483344,"uuid":"1272129017","full_name":"yujingz/use-claude-code-from-codex","owner":"yujingz","description":"Use local Claude Code from Codex as a second opinion, reviewer, or parallel coding agent.","archived":false,"fork":false,"pushed_at":"2026-06-17T14:17:56.000Z","size":65,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-17T16:34:47.685Z","etag":null,"topics":["agent-skills","ai-agents","anthropic","claude","claude-code","code-review","codex","codex-skill","developer-tools","openai-codex"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yujingz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-17T10:10:06.000Z","updated_at":"2026-06-17T14:19:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yujingz/use-claude-code-from-codex","commit_stats":null,"previous_names":["yujingz/use-claude-code-from-codex"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/yujingz/use-claude-code-from-codex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yujingz%2Fuse-claude-code-from-codex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yujingz%2Fuse-claude-code-from-codex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yujingz%2Fuse-claude-code-from-codex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yujingz%2Fuse-claude-code-from-codex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yujingz","download_url":"https://codeload.github.com/yujingz/use-claude-code-from-codex/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yujingz%2Fuse-claude-code-from-codex/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34992071,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agents","anthropic","claude","claude-code","code-review","codex","codex-skill","developer-tools","openai-codex"],"created_at":"2026-07-01T04:02:24.497Z","updated_at":"2026-07-01T04:02:25.322Z","avatar_url":"https://github.com/yujingz.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude from Codex\n\n[![Codex Skill](https://img.shields.io/badge/Codex-Skill-000000)](https://developers.openai.com/codex/skills)\n[![Claude Code](https://img.shields.io/badge/Claude%20Code-Supported-6B5B95)](https://www.anthropic.com/claude-code)\n[![Local First](https://img.shields.io/badge/Local--first-No%20hosted%20service-2563EB)](#install)\n[![No Plugin Required](https://img.shields.io/badge/No%20Codex%20plugin-required-16A34A)](#install)\n[![Node Optional](https://img.shields.io/badge/Node-optional-F59E0B)](docs/companion-cli.md)\n\nUse local Claude Code from Codex for second opinions, code review, and parallel investigation without leaving your Codex session.\n\nPrerequisite: Claude Code should already work on your machine.\n\nWorks as a plain skill folder. No Codex plugin login or marketplace packaging is required.\n\n## 30 Second Start\n\nPaste this into Codex UI or Codex CLI:\n\n```text\nInstall the Codex skill from https://github.com/yujingz/use-claude-code-from-codex.\nPrefer the vercel-labs/skills installer if it is available.\nInstall the skill named claude-from-codex for Codex, then verify that $claude-from-codex is discoverable.\n```\n\nThen ask:\n\n```text\nUse $claude-from-codex to ask Claude for a read-only review of my current diff.\nFocus on bugs, security issues, and missing tests.\n```\n\n## Use It For\n\nThese examples use this repo's own workflow, but the same pattern works in any project.\n\n| Real situation | What to ask Codex |\n| --- | --- |\n| You changed the worker state-root logic and want another model to check it | `Use $claude-from-codex to review the current diff around jobs.mjs and state.mjs. Check whether background workers still find jobs when XDG_STATE_HOME is set.` |\n| A documentation PR feels too close to the implementation details | `Use $claude-from-codex to review README.md as a first-time Codex user. Flag anything that sounds like internal planning instead of user-facing docs.` |\n| `pnpm test` fails and Codex is already working on a fix | `Use $claude-from-codex to investigate the failing pnpm test output in parallel. Do not edit files; return the likely root cause and the smallest fix.` |\n| You have an implementation plan but want a simpler alternative | `Use $claude-from-codex to critique docs/plans/2026-06-17-001-feat-claude-from-codex-skill-plan.md. Look for overengineering, missing tests, and a smaller path.` |\n| You explicitly want Claude to make a narrow edit | `Use $claude-from-codex to add a regression test for the XDG_STATE_HOME background-job case. Keep the change scoped, then show me the diff before continuing.` |\n\nMore copy-paste prompts are in [docs/examples.md](docs/examples.md).\n\n## Install\n\n### Ask Codex To Install It\n\nIf you want a dedicated install prompt, paste this into your current agent:\n\n```text\nInstall the Codex skill from https://github.com/yujingz/use-claude-code-from-codex.\nPrefer the vercel-labs/skills installer if it is available.\nInstall the skill named claude-from-codex for Codex, then verify that $claude-from-codex is discoverable.\n```\n\n### Install From Terminal\n\nIf you prefer a terminal command, use [`vercel-labs/skills`](https://github.com/vercel-labs/skills):\n\n```sh\nnpx skills add yujingz/use-claude-code-from-codex --skill claude-from-codex -g -a codex -y\n```\n\nThis installs the skill globally for Codex.\n\n### Manual Install\n\nIf you do not want to use `npx skills`, download or clone this repo and link the skill folder yourself:\n\n```sh\ngit clone https://github.com/yujingz/use-claude-code-from-codex.git\ncd use-claude-code-from-codex\nmkdir -p \"$HOME/.agents/skills\"\nln -s \"$PWD/skills/claude-from-codex\" \"$HOME/.agents/skills/claude-from-codex\"\n```\n\nIf your Codex setup uses a different skills directory, link the same `skills/claude-from-codex` folder there instead.\n\n### Verify Discovery\n\nRestart Codex or start a new Codex session, then check that `$claude-from-codex` appears in the available skills.\n\nIf you installed from a terminal, these local checks can help:\n\n```sh\nnpx skills list -g -a codex\ncodex debug prompt-input '$claude-from-codex discovery check; do not run commands' | rg 'claude-from-codex'\n```\n\n## Basic Usage\n\nAfter installation, just ask Codex to use the skill. You do not need to run Claude commands yourself.\n\nTreat Claude's answer as one review signal, not ground truth. Keep checking files, tests, and diffs before acting on Claude's advice.\n\nFor write-capable work, say that explicitly:\n\n```text\nUse $claude-from-codex to let Claude make a small implementation pass on this bug.\nKeep the change scoped to the failing test, then show me the diff before we continue.\n```\n\n## Troubleshooting\n\nIf Claude works in your normal terminal but not inside Codex, ask Codex:\n\n```text\nUse $claude-from-codex to check whether Codex can see my local Claude Code CLI.\nReport what is missing.\n```\n\nCommon causes:\n\n- `claude` is not on the PATH visible to Codex.\n- Codex was launched from an environment that cannot see the same tools as your terminal.\n\nAdvanced diagnostics and background job commands are documented in [docs/companion-cli.md](docs/companion-cli.md).\n\n## Development\n\nRun the test suite with pnpm:\n\n```sh\npnpm test\n```\n\nThe tests use a fake Claude executable. They do not call the real Claude API.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyujingz%2Fuse-claude-code-from-codex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyujingz%2Fuse-claude-code-from-codex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyujingz%2Fuse-claude-code-from-codex/lists"}