[{"data":1,"prerenderedAt":675},["ShallowReactive",2],{"content-/codex-volta-install-guide":3,"all-pages-for-dir":673,"og-image-/codex-volta-install-guide":674},{"id":4,"title":5,"body":6,"category":656,"description":657,"extension":658,"meta":659,"navigation":216,"ogImage":660,"path":661,"project_name":660,"published":662,"publishedAt":663,"seo":664,"stem":665,"tags":666,"todo":660,"unpublished":662,"updatedAt":660,"__hash__":672},"pages/2026-01/2026-01-14/codex-volta-install-guide.md","OpenAI Codex インストール・アップデート手順（Volta環境）",{"type":7,"value":8,"toc":633},"minimark",[9,13,18,25,42,45,54,64,67,70,73,81,85,88,110,119,122,126,134,137,145,149,155,170,174,177,191,196,229,234,262,267,270,278,285,289,292,297,306,311,320,325,353,356,359,392,395,398,407,411,414,417,423,427,477,481,556,567,570,599,602,629],[10,11,5],"h1",{"id":12},"openai-codex-インストールアップデート手順volta環境",[14,15,17],"h2",{"id":16},"結論やるべきこと","結論：やるべきこと",[19,20,21],"p",{},[22,23,24],"strong",{},"Volta環境でCodexをインストール・アップデートする場合は、以下のコマンドを使う：",[26,27,32],"pre",{"className":28,"code":29,"language":30,"meta":31,"style":31},"language-powershell shiki shiki-themes vitesse-light vitesse-light","volta install @openai/codex\n","powershell","",[33,34,35],"code",{"__ignoreMap":31},[36,37,40],"span",{"class":38,"line":39},"line",1,[36,41,29],{},[19,43,44],{},"確認：",[26,46,48],{"className":28,"code":47,"language":30,"meta":31,"style":31},"codex --version\n",[33,49,50],{"__ignoreMap":31},[36,51,52],{"class":38,"line":39},[36,53,47],{},[55,56,57],"blockquote",{},[19,58,59,60,63],{},"Voltaがパッケージを直接管理するため、",[33,61,62],{},"npm install -g"," より安全で確実。",[65,66],"hr",{},[14,68,69],{"id":69},"問題の概要",[19,71,72],{},"Volta環境でCodexのインストールやアップデートを行う際、以下のようなエラーが発生することがある：",[26,74,79],{"className":75,"code":77,"language":78},[76],"language-text","Volta error: Could not remove directory\nat C:\\Users\\\u003Cユーザー名>\\AppData\\Local\\Volta\\tools\\image\\packages\\@openai/codex\n\nPlease ensure you have correct permissions to the Volta directory.\n","text",[33,80,77],{"__ignoreMap":31},[82,83,84],"h3",{"id":84},"主な原因",[19,86,87],{},"Windows環境では以下の要因でエラーが発生しやすい：",[89,90,91,98,104],"ul",{},[92,93,94,97],"li",{},[22,95,96],{},"ファイルロック",": 他のプロセスがファイルを使用中",[92,99,100,103],{},[22,101,102],{},"権限不足",": 管理者権限が必要な場合がある",[92,105,106,109],{},[22,107,108],{},"不完全な前回インストール",": 中断されたインストールの残骸",[19,111,112,113,118],{},"この問題はClaude Codeでも発生する。詳細は",[114,115,117],"a",{"href":116},"/claude-code-version-troubleshooting","Claude Code バージョン管理トラブルシューティング","を参照。",[14,120,121],{"id":121},"解決策",[82,123,125],{"id":124},"方法1-volta-installを使う推奨","方法1: volta installを使う（推奨）",[26,127,128],{"className":28,"code":29,"language":30,"meta":31,"style":31},[33,129,130],{"__ignoreMap":31},[36,131,132],{"class":38,"line":39},[36,133,29],{},[19,135,136],{},"バージョン確認：",[26,138,139],{"className":28,"code":47,"language":30,"meta":31,"style":31},[33,140,141],{"__ignoreMap":31},[36,142,143],{"class":38,"line":39},[36,144,47],{},[82,146,148],{"id":147},"方法2-アンインストールしてから再インストール","方法2: アンインストールしてから再インストール",[19,150,151,154],{},[33,152,153],{},"volta install"," でエラーが出る場合、まずアンインストールを試す：",[26,156,158],{"className":28,"code":157,"language":30,"meta":31,"style":31},"volta uninstall @openai/codex\nvolta install @openai/codex\n",[33,159,160,165],{"__ignoreMap":31},[36,161,162],{"class":38,"line":39},[36,163,164],{},"volta uninstall @openai/codex\n",[36,166,168],{"class":38,"line":167},2,[36,169,29],{},[82,171,173],{"id":172},"方法3-手動でディレクトリを削除最終手段","方法3: 手動でディレクトリを削除（最終手段）",[19,175,176],{},"上記で解決しない場合のみ、手動削除を行う。",[19,178,179,182,183,186,187,190],{},[22,180,181],{},"重要",": ",[33,184,185],{},"@openai/codex"," だけを削除し、他の ",[33,188,189],{},"@openai/*"," パッケージを巻き込まないこと。",[19,192,193],{},[22,194,195],{},"PowerShellで削除：",[26,197,199],{"className":28,"code":198,"language":30,"meta":31,"style":31},"# Codexディレクトリのみを削除\nRemove-Item -Recurse -Force \"$env:LOCALAPPDATA\\Volta\\tools\\image\\packages\\@openai\\codex\" -ErrorAction Stop\n\n# 再インストール\nvolta install @openai/codex\n",[33,200,201,206,211,218,224],{"__ignoreMap":31},[36,202,203],{"class":38,"line":39},[36,204,205],{},"# Codexディレクトリのみを削除\n",[36,207,208],{"class":38,"line":167},[36,209,210],{},"Remove-Item -Recurse -Force \"$env:LOCALAPPDATA\\Volta\\tools\\image\\packages\\@openai\\codex\" -ErrorAction Stop\n",[36,212,214],{"class":38,"line":213},3,[36,215,217],{"emptyLinePlaceholder":216},true,"\n",[36,219,221],{"class":38,"line":220},4,[36,222,223],{},"# 再インストール\n",[36,225,227],{"class":38,"line":226},5,[36,228,29],{},[19,230,231],{},[22,232,233],{},"Git Bashで削除（PowerShellで失敗する場合）：",[26,235,239],{"className":236,"code":237,"language":238,"meta":31,"style":31},"language-bash shiki shiki-themes vitesse-light vitesse-light","rm -rf \"$LOCALAPPDATA/Volta/tools/image/packages/@openai/codex\"\n","bash",[33,240,241],{"__ignoreMap":31},[36,242,243,247,251,255,259],{"class":38,"line":39},[36,244,246],{"class":245},"senZ8","rm",[36,248,250],{"class":249},"snbK4"," -rf",[36,252,254],{"class":253},"sMJiu"," \"",[36,256,258],{"class":257},"sdGka","$LOCALAPPDATA/Volta/tools/image/packages/@openai/codex",[36,260,261],{"class":253},"\"\n",[55,263,264],{},[19,265,266],{},"PowerShellで削除できない場合、ファイルがロックされている可能性がある。Git Bashは異なる方法でファイルにアクセスするため、成功することがある。",[19,268,269],{},"削除後、PowerShellで再インストール：",[26,271,272],{"className":28,"code":29,"language":30,"meta":31,"style":31},[33,273,274],{"__ignoreMap":31},[36,275,276],{"class":38,"line":39},[36,277,29],{},[19,279,280],{},[281,282],"img",{"alt":283,"src":284},"volta install成功","/2026-01/2026-01-14/images/volta-install-success.png",[82,286,288],{"id":287},"方法4-特定バージョンを指定してインストール","方法4: 特定バージョンを指定してインストール",[19,290,291],{},"最新版でエラーが発生する場合、別のバージョンを試す。",[19,293,294],{},[22,295,296],{},"利用可能なバージョンを確認：",[26,298,300],{"className":28,"code":299,"language":30,"meta":31,"style":31},"npm view @openai/codex versions --json\n",[33,301,302],{"__ignoreMap":31},[36,303,304],{"class":38,"line":39},[36,305,299],{},[19,307,308],{},[22,309,310],{},"特定バージョンをインストール：",[26,312,314],{"className":28,"code":313,"language":30,"meta":31,"style":31},"volta install @openai/codex@0.79.0\n",[33,315,316],{"__ignoreMap":31},[36,317,318],{"class":38,"line":39},[36,319,313],{},[19,321,322],{},[22,323,324],{},"失敗時の戻し方：",[26,326,328],{"className":28,"code":327,"language":30,"meta":31,"style":31},"# 問題のあるバージョンをアンインストール\nvolta uninstall @openai/codex\n\n# 動作確認済みのバージョンを再インストール\nvolta install @openai/codex@0.78.0\n",[33,329,330,335,339,343,348],{"__ignoreMap":31},[36,331,332],{"class":38,"line":39},[36,333,334],{},"# 問題のあるバージョンをアンインストール\n",[36,336,337],{"class":38,"line":167},[36,338,164],{},[36,340,341],{"class":38,"line":213},[36,342,217],{"emptyLinePlaceholder":216},[36,344,345],{"class":38,"line":220},[36,346,347],{},"# 動作確認済みのバージョンを再インストール\n",[36,349,350],{"class":38,"line":226},[36,351,352],{},"volta install @openai/codex@0.78.0\n",[14,354,355],{"id":355},"トラブルシューティング",[82,357,358],{"id":358},"権限エラーが続く場合",[360,361,362,371,377],"ol",{},[92,363,364,182,367,370],{},[22,365,366],{},"使用中のプロセスを確認",[33,368,369],{},"codex"," を使用しているターミナルをすべて閉じる",[92,372,373,376],{},[22,374,375],{},"管理者権限で実行",": PowerShellを管理者として起動して再試行",[92,378,379,382,383],{},[22,380,381],{},"権限を確認",":\n",[26,384,386],{"className":28,"code":385,"language":30,"meta":31,"style":31},"Get-Acl \"$env:LOCALAPPDATA\\Volta\\tools\\image\\packages\\@openai\\codex\"\n",[33,387,388],{"__ignoreMap":31},[36,389,390],{"class":38,"line":39},[36,391,385],{},[82,393,394],{"id":394},"エラーログの確認",[19,396,397],{},"Voltaはエラー詳細をログに書き出す：",[26,399,401],{"className":28,"code":400,"language":30,"meta":31,"style":31},"Get-Content \"$env:LOCALAPPDATA\\Volta\\log\\volta-error-*.log\" | Select-Object -Last 50\n",[33,402,403],{"__ignoreMap":31},[36,404,405],{"class":38,"line":39},[36,406,400],{},[14,408,410],{"id":409},"voltaでのグローバルパッケージ管理","Voltaでのグローバルパッケージ管理",[19,412,413],{},"Voltaを使っている場合、npmグローバルパッケージもVolta経由で管理される。",[82,415,416],{"id":416},"ディレクトリ構成",[26,418,421],{"className":419,"code":420,"language":78},[76],"C:\\Users\\\u003Cユーザー名>\\AppData\\Local\\Volta\\\n├── bin\\\n│   └── codex.exe  ← 実際に呼ばれるshim\n└── tools\\\n    └── image\\\n        └── packages\\\n            └── @openai\\\n                └── codex\\  ← 実際のパッケージ\n",[33,422,420],{"__ignoreMap":31},[82,424,426],{"id":425},"voltaコマンド一覧","Voltaコマンド一覧",[428,429,430,443],"table",{},[431,432,433],"thead",{},[434,435,436,440],"tr",{},[437,438,439],"th",{},"コマンド",[437,441,442],{},"説明",[444,445,446,457,467],"tbody",{},[434,447,448,454],{},[449,450,451],"td",{},[33,452,453],{},"volta install @openai/codex",[449,455,456],{},"インストール/アップデート",[434,458,459,464],{},[449,460,461],{},[33,462,463],{},"volta uninstall @openai/codex",[449,465,466],{},"アンインストール",[434,468,469,474],{},[449,470,471],{},[33,472,473],{},"volta list",[449,475,476],{},"インストール済みパッケージ一覧",[14,478,480],{"id":479},"claude-codeとcodexの比較インストール方法","Claude CodeとCodexの比較（インストール方法）",[428,482,483,496],{},[431,484,485],{},[434,486,487,490,493],{},[437,488,489],{},"項目",[437,491,492],{},"Claude Code",[437,494,495],{},"OpenAI Codex",[444,497,498,512,526,541],{},[434,499,500,503,508],{},[449,501,502],{},"パッケージ名",[449,504,505],{},[33,506,507],{},"@anthropic-ai/claude-code",[449,509,510],{},[33,511,185],{},[434,513,514,517,522],{},[449,515,516],{},"Voltaでのインストール",[449,518,519],{},[33,520,521],{},"volta install @anthropic-ai/claude-code",[449,523,524],{},[33,525,453],{},[434,527,528,531,536],{},[449,529,530],{},"バージョン確認",[449,532,533],{},[33,534,535],{},"claude --version",[449,537,538],{},[33,539,540],{},"codex --version",[434,542,543,546,551],{},[449,544,545],{},"設定ファイル",[449,547,548],{},[33,549,550],{},"CLAUDE.md",[449,552,553],{},[33,554,555],{},"AGENTS.md",[55,557,558],{},[19,559,560,561,118],{},"AGENTS.mdの設定方法については",[114,562,566],{"href":563,"rel":564},"https://developers.openai.com/codex/guides/agents-md/",[565],"nofollow","Custom instructions with AGENTS.md",[14,568,569],{"id":569},"参考リンク",[89,571,572,579,586,593],{},[92,573,574],{},[114,575,578],{"href":576,"rel":577},"https://github.com/openai/codex/issues/1480",[565],"EACCESS permission issue with npm install -g @openai/codex",[92,580,581],{},[114,582,585],{"href":583,"rel":584},"https://github.com/openai/codex/issues/5015",[565],"Cannot update codex",[92,587,588],{},[114,589,592],{"href":590,"rel":591},"https://github.com/volta-cli/volta/issues/964",[565],"npm global installation fails on Windows - Volta",[92,594,595],{},[114,596,598],{"href":563,"rel":597},[565],"Custom instructions with AGENTS.md - OpenAI",[14,600,601],{"id":601},"まとめ",[360,603,604,610,620,626],{},[92,605,606,607,609],{},"Volta環境では ",[33,608,153],{}," を使う",[92,611,612,613,616,617,619],{},"エラー時は ",[33,614,615],{},"volta uninstall"," → ",[33,618,153],{}," を試す",[92,621,622,623,625],{},"手動削除は最終手段、",[33,624,185],{}," のみを対象にする",[92,627,628],{},"権限エラーが続く場合はファイルロックや権限設定を確認",[630,631,632],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .senZ8, html code.shiki .senZ8{--shiki-default:#59873A;--shiki-dark:#59873A}html pre.shiki code .snbK4, html code.shiki .snbK4{--shiki-default:#A65E2B;--shiki-dark:#A65E2B}html pre.shiki code .sMJiu, html code.shiki .sMJiu{--shiki-default:#B5695977;--shiki-dark:#B5695977}html pre.shiki code .sdGka, html code.shiki .sdGka{--shiki-default:#B56959;--shiki-dark:#B56959}",{"title":31,"searchDepth":167,"depth":167,"links":634},[635,636,639,645,649,653,654,655],{"id":16,"depth":167,"text":17},{"id":69,"depth":167,"text":69,"children":637},[638],{"id":84,"depth":213,"text":84},{"id":121,"depth":167,"text":121,"children":640},[641,642,643,644],{"id":124,"depth":213,"text":125},{"id":147,"depth":213,"text":148},{"id":172,"depth":213,"text":173},{"id":287,"depth":213,"text":288},{"id":355,"depth":167,"text":355,"children":646},[647,648],{"id":358,"depth":213,"text":358},{"id":394,"depth":213,"text":394},{"id":409,"depth":167,"text":410,"children":650},[651,652],{"id":416,"depth":213,"text":416},{"id":425,"depth":213,"text":426},{"id":479,"depth":167,"text":480},{"id":569,"depth":167,"text":569},{"id":601,"depth":167,"text":601},"dev","Volta環境でOpenAI Codexをインストール・アップデートする際の正しい手順と、権限エラーの解決方法","md",{},null,"/codex-volta-install-guide",false,"2026-01-14T00:00:00.000Z",{"title":5,"description":657},"2026-01/2026-01-14/codex-volta-install-guide",[667,668,669,670,671],"openai-codex","volta","nodejs","troubleshooting","windows","lFirlYBIsHYd4vrfCLVZ5qaWKCEoR8Y_bcQv5LQm2QY",[],"https://log.eurekapu.com/og/blog/codex-volta-install-guide.png?v=2026-01-14T00%3A00%3A00.000Z&title=OpenAI%20Codex%20%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%83%BB%E3%82%A2%E3%83%83%E3%83%97%E3%83%87%E3%83%BC%E3%83%88%E6%89%8B%E9%A0%86%EF%BC%88Volta%E7%92%B0%E5%A2%83%EF%BC%89&author=Kei%20Komatsu&sig=0f4b85d045743a7d",1782528795202]