Claude Code tutorial series

Claude Code vs OpenAI Codex

Compare week-one fit: surfaces, instruction files, and how you review a diff. Not a scoreboard and not a price list.

How to compare without a flame war

Both are repo agents. Both can live in a terminal. Both grow instruction files, skills, and MCP. The useful question is which loop you will actually finish this week.

Account gates, regions, and default models move. We do not crown a winner or quote a plan.

If your team already standardized, learn that tool deeply before you dual-wield.

Where Claude Code tends to fit

People who already pay for Claude or live in Anthropic's IDE and desktop surfaces. CLAUDE.md is the native brief.

Public GitHub mentions and Actions-style automation are part of the conversation around Code. Useful after a local loop works.

doctor is a first-class habit when PATH and settings go weird.

  • Native 2026 installer.
  • CLAUDE.md as the repo brief.
  • Desktop door if you refuse the shell.
  • doctor for install health.
Side-by-side sketch of Claude Code and Codex as two repo agents.
Same job, different clients and instruction filenames.

Where Codex tends to fit

People who already live in ChatGPT Codex, the Codex CLI, or the official editor extension. AGENTS.md is the brief that course teaches.

If your org is already an OpenAI shop for coding agents, switching for a blog post is expensive.

This site has a full Codex series. Use it instead of a paragraph here.

  • ChatGPT, CLI, and IDE doors.
  • AGENTS.md as the repo brief.
  • Same MCP idea, different client files.
  • Read the Codex course for install truth.

What is the same

You still review diffs. You still keep secrets out of git. You still want one practice repo.

Skills and MCP are shared ideas, not copy-paste configs.

  • Diff ownership stays with you.
  • Instruction file in git.
  • One MCP server at a time.
  • No prices in a comparison chart.

A practical pick for the next month

If Claude Code already launches and doctor is clean, stay. Finish skills and MCP here.

If Codex already finishes tasks at work, stay there and skim this series for CLAUDE.md ideas you might rename.

Trying both is fine for a weekend, not for a production incident.

  • Pick the account you already have.
  • Pick the door you will open daily.
  • Re-evaluate after ten real diffs.

GitHub-side agents

Both ecosystems talk about PR review and mentions from issues. The mention syntax and the Action name are not interchangeable.

Do not enable a bot on a private customer repo as your first experiment.

  • Local diff first.
  • Least-privilege tokens.
  • Read the official GitHub page for that product.

Team cost is not the sticker

The hidden cost is two instruction files and two MCP dialects. Standardize the brief even if individuals try both.

Write down how to revert an agent PR. That document matters more than the logo.

  • One shared verify command.
  • Named human owners.
  • No dual MCP stacks in week one.

Comparison mistakes

Picking from a YouTube thumbnail of tokens per second.

Copying AGENTS.md into CLAUDE.md without deleting the Codex-only commands.

  • Price arguments with invented numbers.
  • Two CLIs fighting PATH.
  • Enabling both GitHub bots overnight.

Done looks like this

You can say which tool you will use for the next ten diffs and why.

  1. Account already works.
  2. Instruction file named.
  3. Door named.
  4. No second bot this week.
  5. You know where the other course lives.

Next: keep a repair kit

Troubleshooting covers PATH, doctor, login, and duplicate binaries.

If you chose Codex instead, switch to that series. The repair ideas still rhyme.

FAQ

Which is better?

The one whose login already works and whose diff you will review. That answer can change next quarter.

Can I run both?

Yes. Keep PATH and instruction files honest. Do not dual-write production.

Do they share MCP config?

Do not assume it. Translate on purpose.

What about Cursor?

Different product. This site has a separate comparison.

Does GitHub @claude replace the CLI?

No. It is another door. Local review still teaches you faster.

Should we migrate AGENTS.md?

Only the facts that still apply. Delete tool-specific commands.

Will this page stay current?

We hedge. Re-read official product pages when you choose for a team.

All chapters in this series

  1. 1. What Claude Code is (and is not)
  2. 2. Install Claude Code the 2026 way
  3. 3. Finish your first reviewable Claude Code task
  4. 4. CLAUDE.md and project instructions
  5. 5. Claude Code skills you can reuse
  6. 6. Add one MCP server to Claude Code
  7. 7. Claude Code vs OpenAI Codex
  8. 8. Claude Code troubleshooting