AppleのXcode 27リリースノートは、Appleが作成したAgent SkillsがCodexに表示されない既知の問題と、Xcode 27を選択してCodex向けに書き出す対処を案内しています。今週は、まずxcrunが使うツールチェーンを確認し、公式手順で書き出したあと、保存先とCodexの読み込みを別々に検証してください。書き出し成功だけでは、Codexがスキルを読み込んだとは判断できません。
この記事は、CodexでSwiftやSwiftUIを開発し、Xcode 27に付属するAppleの指針を使いたい方に向けています。
SSH経由でリモートMacを管理し、複数のXcodeツールチェーンを維持するDevOps担当者にも役立ちます。
個人用の設定とチーム共有の指示を分けて管理したい開発基盤の担当者も対象です。
SECTION 01 症状を「ツールチェーン・書き出し先・読み込み」に分ける
Agent Skillsが見つからないときは、「コマンドが利用できない」「書き出したファイルが想定先にない」「ファイルはあるのにCodexが使わない」のどこで止まっているかを分けます。Xcode 27がインストール済みでも、選択中の開発者ディレクトリが別のXcodeを指していれば、xcrunが呼び出すツールは期待したものになりません。
Appleのコマンドラインツールに関する説明では、選択中の開発者ディレクトリがコマンドの実行環境に関わります。そこで、まずxcode-select -pの出力を記録し、次にxcodebuild -versionで表示されるXcodeのバージョンを照合します。これらの確認は、Xcodeのインストール先を眺めるだけでは分からない「今どの環境を使っているか」を判定する材料になります。Appleのコマンドラインツールの説明とコマンドラインからのビルドに関する技術資料を参照してください。
| 確認対象 | 期待する証拠 | 違っていた場合の対応 |
|---|---|---|
| 活動中のツールチェーン | xcode-select -pが示す開発者ディレクトリと、xcodebuild -versionの結果 |
Appleの手順でXcode 27を選択し、両方の出力を再確認します |
| 書き出し処理 | Appleの説明に沿ったxcrun agent skills exportの実行結果 |
Xcode 27が活動中かを再点検し、現行リリースノートの構文と保存先を確認します |
| 生成ファイル | 指定したCodex用ディレクトリにAgent Skillsのファイルがあること | 出力先、実行ユーザー、ホームディレクトリを照合します |
| Codexでの利用 | 指示対象のSwiftタスクで該当スキルの内容が反映されること | 現行Codexの読み込み条件を調べ、対象ディレクトリと起動環境を切り分けます |
SECTION 02 Xcode 27が選択されているかを先に確かめる
コマンドが見つからない、または想定と異なる結果になるときは、Xcode 27の存在ではなく、コマンドラインが参照している開発者ディレクトリを調べます。ターミナルで次のコマンドを実行し、結果を作業記録に残してください。
xcode-select -p
xcodebuild -version
xcode-select -pは選択中の開発者ディレクトリを示し、xcodebuild -versionはコマンドラインから見えるXcodeのバージョン確認に使えます。Xcodeアプリを複数インストールしている場合、GUIで開いているXcodeと、ターミナルで選ばれているツールチェーンは別々に確認する必要があります。AppleのXcodeシステム要件も参照し、使用環境が対象バージョンの条件に合っているか確認してください。
選択先がXcode 27でない場合は、Appleの案内に従って選択を切り替えます。切り替え後、同じコマンドをもう一度実行し、出力が変わったことを確認してから書き出しへ進みます。シェルの設定変更や別のXcodeへの切り替えが必要な作業では、どのユーザーで実行したかも記録してください。
SECTION 03 書き出し先とCodexの読み込みを別々に調べる
Appleのリリースノートが案内するのは、Xcode 27を選択してからAgent SkillsをCodex向けに書き出す対処です。xcrun agent skills exportのオプションや出力先は、利用中のXcode 27のリリースノートで確認し、未確認のフラグを付け足さないでください。AppleのWWDC 2026でのAgent Skillsの説明も、機能の位置付けや書き出しの確認に使えます。
ファイルを確認するときは、次の状態を混同しないことが重要です。
- 書き出しコマンドがエラーなく終了した。
- 指定したディレクトリにスキルのファイルが生成された。
- Codexがそのファイルを発見し、作業時に内容を利用した。
最初の状態から最後の状態を推定することはできません。Codexのスキル仕様では、個人用の場所とリポジトリ内の場所が区別されています。たとえば、OpenAIのスキル説明にある~/.agents/skillsやプロジェクト内の.agents/skillsを確認し、Appleの書き出し先とCodex側の読み込み条件が一致するか照合してください。Codexのバージョンや起動方法による挙動は、現在の公式説明と実環境での確認を優先します。
| 選択肢 | 向いている管理方法 | 判断前に見る点 |
|---|---|---|
| 個人用スキルディレクトリ | 自分のCodex環境だけで指示を使う場合 | 書き出しを実行したユーザーとCodexの実行ユーザーが一致しているか |
| リポジトリ内のスキルディレクトリ | チームで指示を共有し、変更をレビューしたい場合 | Appleの書き出し先が共有領域か、既存ファイルを上書きしないか |
| 既存ファイルを残して保留 | 保存先やCodexの読み込みを確認できていない場合 | 差分とバックアップを取るまで再書き出しを避けられるか |
書き出しオプションに既存ファイルを置き換える動作がある場合は、実行前にAppleの現行資料で作用範囲を確認してください。バックアップを取れない、または対象ファイルを特定できない場合は、追加の書き出しを止めて先に保存先を調べます。
リモートMacでは、SSHで接続したユーザーのホームディレクトリと、Codexを起動するユーザーのホームディレクトリが同じとは限りません。pwdやecho "$HOME"で実行環境を記録し、書き出し先が意図したアカウント配下か照合してください。個人用とチーム共有のどちらに置くか決めてから、プロジェクトへ追加するファイルを選びます。リモート接続や利用環境の確認が必要なら、VPSNIXのヘルプセンターで接続に関する案内を確認できます。
SECTION 04 Swiftの作業で修正結果を受け入れ確認する
書き出しファイルが存在することだけを合格条件にせず、スキルの対象範囲に合う実際のタスクで確認します。次の順に進めると、環境の記録と原因の切り分けを同時に行えます。
xcode-select -pとxcodebuild -versionを実行し、活動中のツールチェーンを記録します。- Codexを起動するユーザーと、作業対象のリポジトリを確定します。
- AppleのXcode 27リリースノートに記載された手順で、Codex向けにAgent Skillsを書き出します。
- 書き出し先のディレクトリ階層と生成ファイルを確認し、個人用か共有用かを記録します。
- 対象スキルに適した小さなSwift、SwiftUI、またはUIKitの作業をCodexに依頼します。
- 作業結果がスキルの指示に沿ったかを確認し、沿わない場合はツールチェーン、保存先、Codexの読み込みを順に調べます。
検証の題材には、対象スキルが扱う範囲に合った小さな変更を選びます。たとえばSwiftUIのビュー修正を依頼する場合は、生成されたコードだけでなく、Agent Skillsの指示に沿った構成や判断が応答に反映されているか確認します。バージョン、活動中のツールチェーン、書き出し先、依頼内容、結果を一組の記録として残してください。
よくある確認事項
コマンドが見つからない場合は、Xcode 27が選択中かを先に調べます。ファイルがあるのにCodexが使わない場合は、Codexが実際に読む場所と、起動ユーザーのホームディレクトリを照合します。どちらも違う問題なので、同じ操作を繰り返すより、各段階の証拠を一つずつ確認する方が安全です。
遠隔環境で再現しない場合は、エラー全文とコマンド出力を保存し、確認できていない挙動を「Codexが読み込んだ」と扱わないでください。AppleのリリースノートやOpenAIのスキル説明が更新されたときは、構文と読み込み条件を改めて確認します。Xcode 27の要件はAppleのシステム要件を参照してください。
最終更新：2026年10月10日。確認資料：AppleのXcode 27リリースノート、Xcodeシステム要件、WWDC 2026の説明、およびOpenAIのスキル仕様。Codexによる読み込みとリモートMac上の動作は、使用環境ごとに実測して確認してください。
SECTION 05 次に使う環境を選ぶ
原因が分からないままローカルの設定を繰り返し変更すると、複数のXcode間で選択状態がずれたり、共有領域のファイルを意図せず置き換えたりするおそれがあります。手元にXcode 27を使えるMacがない場合は、まずリモートMacの利用案内で接続方法を確認し、必要な期間だけ検証環境を用意する方法も比較してください。
LinuxやWindowsの開発環境だけでは、Xcodeのツールチェーンを用いたAppleプラットフォーム向けの検証を代替できません。一方、常時稼働する重い処理や物理接続が必要な作業では、専用機を自分で管理する方が適する場合があります。今回のようにXcode 27とCodexの連携確認を一時的に行う目的なら、Macを購入して環境を保守し続ける負担と、遠隔利用の期間・接続条件を比べたうえで、VPSNIXの料金案内を確認して選ぶとよいでしょう。
SECTION 06 よくある質問 FAQ
Xcode 27のAgent SkillsがCodexに出てこない場合、何を先に確認すればよいですか？
まずターミナルで選択中の開発者ディレクトリを確認し、それがXcode 27を指しているか確かめます。次にAppleのリリースノートにある手順でCodex向けに書き出し、出力先にスキルのファイルがあるかを調べます。ファイルの存在だけではCodexが認識した証拠にならないため、最後に実際の作業で応答を検証してください。
xcrunが現在使っているXcode 27のツールチェーンはどう確認できますか？
ターミナルでxcode-select -pを実行し、返された開発者ディレクトリを確認します。続けてxcodebuild -versionの出力も記録し、選択先とバージョン表示を照合してください。複数のXcodeが入っている環境では、アプリケーションフォルダにXcode 27があるだけでは、コマンドラインがその環境を使っているとは限りません。
AppleのAgent SkillsをCodexのスキル用ディレクトリへ書き出すには？
先にXcode 27を活動中のツールチェーンとして選び、AppleのXcode 27リリースノートに記載されたxcrun agent skills exportの実行方法とCodex向けの保存先を確認します。オプションの表記や書き出し先を推測で補わず、現行の公式手順に従ってください。その後、指定先に生成されたファイルがあるかを確認します。
リモートMacで書き出しに成功してもCodexがスキルを使わないときは？
書き出し元のMacとCodexを起動したユーザーが同じか、保存先がそのユーザーのCodex用ディレクトリかを確かめます。さらに、プロジェクト内の設定と個人用ディレクトリを取り違えていないか確認してください。Codexの現行バージョンがその場所を読み込むかは、公式のスキル説明と実際のSwiftタスクで検証し、確認できるまでは既存ファイルの上書きを繰り返さないでください。