Migration

Move from OpenAI to Claude in one PR

Point us at a repo that uses the OpenAI SDK. We’ll open a pull request that swaps in the Claude API and optimizes your project for the Claude platform.

{/* Big primary card */}

BETA ~3 min average

Automated OpenAI migration

We support chat completions, tool calling, streaming, and structured outputs. Embeddings and audio are coming soon.

{showCredit && (

${creditAmount} in free credits after merge

)}

{/* Other-provider interest signal */} {/* Quiet secondary */}

Prefer to do it yourself? Read the migration guide → · Cookbook examples

); } /* ---------- STEP 2: Repo picker (OpenAI variant) ---------- */ function Idea3PickRepo({onPick, onBack}){ const I = window.Idea2Icons; const [search,setSearch]=useState3(''); const [hovered,setHovered]=useState3(null); const filtered = OAI_REPOS.filter(r=>r.name.toLowerCase().includes(search.toLowerCase())||r.desc.toLowerCase().includes(search.toLowerCase())); const suggested = OAI_REPOS.find(r=>r.match); return (

GitHub connected · acme-eng

Which repo should we migrate?

We’ll scan it for OpenAI SDK usage, propose the equivalent Claude code, and open a PR for your review.

{suggested && (

Suggested · heavy OpenAI usage detected

{suggested.owner}/{suggested.name} {suggested.visibility}

{suggested.desc}

SDK{suggested.detected.sdk} Framework{suggested.detected.framework} API calls{suggested.detected.calls} Tool defs{suggested.detected.tools} Models{suggested.detected.models}

)}

setSearch(e.target.value)} placeholder="Search your repositories..." style={{flex:1,background:'transparent',border:'none',color:'#fff',fontSize:14,fontFamily:'var(--font-sans)',outline:'none'}}/> {filtered.length} of {OAI_REPOS.length}

{filtered.map((r,i)=>(

onPick(r)} onMouseEnter={()=>setHovered(r.name)} onMouseLeave={()=>setHovered(null)} style={{display:'flex',alignItems:'center',gap:14,padding:'14px 16px',borderBottom:i

{r.owner}/{r.name} {r.visibility}

{r.desc}

{r.lang} {r.updated}

))}

); } /* ---------- STEP 3: Scanning / transforming ---------- */ function Idea3Scanning({repo, showRecs, onDone}){ const I = window.Idea2Icons; const steps = [ 'Cloning ' + repo.owner + '/' + repo.name, 'Parsing OpenAI SDK imports (47 call sites)', 'Classifying API patterns: chat, tools, streaming', 'Mapping 8 tool definitions to Anthropic tool use', 'Generating Claude-equivalent code', 'Validating against migration test suite (92/100)', ...(showRecs ? [ 'Scanning for prompt caching opportunities', 'Identifying model right-sizing opportunities', ] : []), 'Creating branch claude/migrate-from-openai', 'Opening pull request' ]; const [done,setDone]=useState3(0); useEffect3(()=>{ if(done>=steps.length){const t=setTimeout(onDone,600);return()=>clearTimeout(t);} const t=setTimeout(()=>setDone(d=>d+1), done===0?400:500+Math.random()*250); return()=>clearTimeout(t); },[done]); return (

Migrating

Translating OpenAI → Claude

{steps.map((s,i)=>{ const state=i {state==='done' && } {state==='active' && } {state==='pending' && } {s}

); })}

{/* PR header */}

Pull request ready · {repo.owner}/{repo.name}

Migrate from OpenAI to Claude

claude/migrate-from-openai · 5 files changed · +91 −27

{[['diff','Files changed',5],['recs','Recommendations',showRecs?4:null],['summary','Summary',null]].map(([id,label,count])=>( ))}

{tab==='diff' && (

{/* File sidebar */}

Changed files

{FILES.map((f,i)=>(

{f[0]} {f[2]}

))}

{/* Diff */}

app/api/chat/route.ts +18 −14

{DIFF_LINES.map((l,i)=>(

{l.n[0]||''} {l.n[1]||''} {l.type==='add'?'+':l.type==='rem'?'−':' '} {l.text}

))}

... 9 more hunks in this file

)} {tab==='recs' && showRecs && (

After a clean migration, we looked for Claude-specific patterns that could cut cost or latency. Apply each independently — none are required for the PR to merge.

{[ {title:'Enable prompt caching on your system prompt',saves:'Saves ~$240/mo at current volume',impact:'High',body:'Your 4.2k-token system prompt is static across requests. Add `cache_control: { type: "ephemeral" }` to the last system block to cache it for 5 minutes. With your current request pattern (~18k/day), this cuts input token cost by ~88% on cached hits.',code:`system: [{ type: "text", text: SYSTEM_PROMPT, cache_control: { type: "ephemeral" } }]`, file:'lib/llm-adapters.ts'}, {title:'Right-size for classification calls',saves:'Saves ~$95/mo + 40% faster',impact:'High',body:'Three call sites use the full model for short classification prompts (<200 tokens in/out). Claude Haiku handles these equally well and is ~5× cheaper.',code:`model: "claude-haiku-4-5" // was claude-sonnet-4-5`, file:'app/api/classify/route.ts'}, {title:'Use Claude\u2019s native tool use instead of the compat shim',impact:'Medium',body:'Your tool definitions are currently passed through a translation layer. Rewriting them in Claude\u2019s native format removes one abstraction and enables parallel tool use.',file:'lib/tools.ts'}, {title:'Consider extended thinking for the triage agent',impact:'Low',body:'The triage agent makes multi-step decisions that benefit from visible reasoning. Toggling `thinking: { type: "enabled" }` can improve accuracy on complex tickets without client changes.',file:'lib/agents/triage.ts'}, ].map((r,i)=>(

{r.impact} IMPACT {r.saves && {r.saves}} {r.file}

{r.title}

{r.body}

{r.code && (

{r.code}

)}

))}

)} {tab==='summary' && (

What changed

Replaced openai with @anthropic-ai/sdk across 3 files.
Converted 8 tool definitions to Claude’s input_schema format.
Mapped gpt-4o → claude-sonnet-4-5 and gpt-4o-mini → claude-haiku-4-5.
Preserved streaming semantics via a small adapter in lib/llm-adapters.ts.
Added ANTHROPIC_API_KEY to .env.example.

Test coverage

Migration test suite92 / 100 passing

8 tests need human review. These cover JSON mode edge cases and image inputs in tool responses. Links are annotated inline in the PR.

)}

); } /* ---------- STEP 5: Done / celebrate ---------- */ function Idea3Done({repo, showCredit, creditAmount}){ const I = window.Idea2Icons; return (

You’re on Claude

Your migration PR is live on GitHub. Merge when it looks right, and your app will be serving Claude responses on the next deploy.

{showCredit && (

Migration bonus credited

${creditAmount} in free API credits added to your workspace

Credits appear once your PR is merged. Valid for 90 days.

)}

Migrate from OpenAI to Claude

{repo.owner}/{repo.name} · #{42}

{[['Files changed','5'],['Additions','+91'],['Deletions','−27'],['Tests passing','92/100']].map(([k,v])=>(

{k}

{v}

))}

{[ ['View live usage','Watch the first requests hit Claude once you merge.','Usage dashboard'], ['Tune with evals','Confirm behavior matches with a test harness against your real traffic.','Set up evals'], ['Read the migration guide','For deeper patterns \u2014 batch inference, vision, long context.','Read docs'], ['Talk to us','Our DevRel team helps high-volume teams fine-tune the migration.','Book a call'] ].map(([t,d,cta])=>(

{t}

{d}

{cta} →

))}

); } /* ---------- Main Idea 3 App w/ stepper ---------- */ const IDEA3_TWEAK_DEFAULTS = /*IDEA3MODE-BEGIN*/{ "showRecs": true, "showCredit": true, "creditAmount": 20 }/*IDEA3MODE-END*/; function Idea3App({tweaks, setTweak, showTweaks}){ const [step,setStep]=useState3(()=>localStorage.getItem('idea3_step')||'welcome'); const [repo,setRepo]=useState3(null); useEffect3(()=>{localStorage.setItem('idea3_step',step);},[step]); const ConsoleChrome = window.ConsoleChrome; if(!ConsoleChrome) return

; return (

{step==='welcome' && setStep('pickrepo')} showCredit={tweaks.showCredit} creditAmount={tweaks.creditAmount}/>} {step==='pickrepo' && {setRepo(r);setStep('scanning');}} onBack={()=>setStep('welcome')}/>} {step==='scanning' && repo && setStep('review')}/>} {step==='review' && repo && setStep('done')}/>} {step==='done' && repo && } {/* Step jumper */}

Jump to {[['welcome','1'],['pickrepo','2'],['scanning','3'],['review','4'],['done','5']].map(([s,n])=>( ))}

{showTweaks && (

Tweaks · Idea 3

Show optimization recommendations

Offer migration credit bonus

Credit amount

{[5,10,20,50].map(v=>( ))}

)}

); } Object.assign(window, {Idea3App, IDEA3_TWEAK_DEFAULTS});

Move from OpenAI to Claude in one PR

Automated OpenAI migration

Which repo should we migrate?

Migrate from OpenAI to Claude

{r.title}

What changed

Test coverage

You’re on Claude

Next

Tweaks · Idea 3