终端机与路径：找到专案根目录

返回 Codex 教学总目录

读完能做到什么

先分清视窗、壳层与输入

终端机是容纳文字互动的视窗；PowerShell、Bash、zsh 等壳层负责解读命令；codex 启动后又进入代理的对话介面。相同视窗会有不同输入位置。看到 PS 与路径时通常是在 PowerShell；看到 Codex 的对话输入区时，文字会成为给代理的要求。不要把文章中的终端机命令、/plan 斜线指令、自然语言提示词混成一串贴入。

绝对路径从磁碟或根目录出发，例如 C:\Work\demo 或 /home/reader/demo；相对路径从目前位置计算。点号 . 是目前目录，两点 .. 是上一层。移动终端机位置不会搬动档案，也不会把另一个已开启的终端机一起移动。每次新开视窗都先检视位置，不要只凭上一个视窗的记忆执行下一步。

准备两层资料夹与文字档

用档案管理员在自己方便找到的位置建立全新的 codex-terminal-lab，里面再建立名称含空白的 lesson one。若已有同名资料夹，换一个新的名称并在后面指令使用实际路径。用纯文字编辑器在 lesson one 里建立 note.txt，内容只写下方一行，储存为 UTF-8。这个动作故意在图形介面完成，让你知道终端机读到的档案原本在哪里。

Terminal practice: this is lesson one.

目录应是下面的形状。Windows 记事本要避免 note.txt.txt，macOS 编辑器要避免 RTF；Linux 档名大小写保持一致。档名含空白并没有错，正好用来练习引号。教学中的灰色范例区只有命令与内容；不要把 PS C:\>、$ 等提示字元也加进输入。

codex-terminal-lab/
  lesson one/
    note.txt

Windows：PowerShell 的完整操作

从开始选单开启 PowerShell，或在档案总管的 codex-terminal-lab 资料夹中选择「在终端机开启」。若终端机开的是命令提示字元，改开 PowerShell；本段的 Get-Location 并非 cmd.exe 指令。先执行下一组唯读命令，确认目前位置与直下档案与资料夹。没有看到 lesson one 时先别往下读档，回档案总管核对真正所在路径。

Get-Location
Get-ChildItem -Name

需要手动移动时，先在档案总管复制 codex-terminal-lab 的完整路径，把下一行引号内的示例换成它。YOUR_NAME 是占位文字，不能原样执行；档案可能在 OneDrive 或其他磁碟，请使用实际位置。LiteralPath 会按原样解读路径，减少方括号被当成万用字元的问题。移动成功通常不印出结果，所以再查一次位置。

Set-Location -LiteralPath 'C:\Users\YOUR_NAME\Documents\codex-terminal-lab'
Get-Location
Get-ChildItem -Name

确认位于实际练习根目录后，移入含空白的子目录并读档，再退回上一层。下方整组命令没有修改档案；预期中间显示完整英文句子，最后位置回到 codex-terminal-lab。不要只看输出最后一行就判定全部成功；任一步有错误都先停下核对。

Set-Location -LiteralPath '.\lesson one'
Get-Content -LiteralPath '.\note.txt'
Set-Location -LiteralPath '..'
Get-Location

macOS 与 Linux：终端机的完整操作

macOS 从 Spotlight 开启 Terminal，Linux 从应用程式选单开启终端机；也可使用档案管理员提供的在资料夹开启终端机功能。macOS 常见 zsh、Linux 常见 Bash，本段只用两者都能理解的基本命令。先执行 pwd 与 ls -a，前者回报目前路径，后者包括隐藏档案与资料夹。不要把 macOS 的 /Users 路径当成 Linux 一定存在的 /home 路径。

pwd
ls -a

手动移动时，在 cd 后输入一个空白，再贴上用引号包住的实际资料夹绝对路径；下面只是替换示例。也可将资料夹拖入终端机，但要检查终端机是否已自动处理空白，避免再加一层错误引号。若把家目录写成 $HOME，使用双引号才会展开变数；本篇先直接使用完整路径，少混入一种语法。

cd '/absolute/path/to/codex-terminal-lab'
pwd
ls -a

看到 lesson one 后执行下一组；预期读出同一句话并回到原来根目录。若某一步失败，先修正再逐行继续，不把前一个错误带进下一步。macOS 与 Linux 的基本步骤相同，但档案名称的大小写行为可能依档案系统设定不同；养成完全匹配名称的习惯，就不用依赖宽松比对。

cd 'lesson one'
cat note.txt
cd ..
pwd

确认错误行为，再启动 Codex

在练习根目录尝试移入不存在的 missing-folder。PowerShell 用 Set-Location -LiteralPath '.\missing-folder'；macOS／Linux 用 cd 'missing-folder'。预期有找不到路径的错误，查位置时仍在原处。错误文字依语言与版本不同，不要求逐字一致。这证明失败的移动不会自动建立资料夹，也提醒你不能在 cd 失败后照常执行修改命令。

故意读错位置，再修正相对路径

先确认目前在 codex-terminal-lab 根目录，且 note.txt 只放在 lesson one 里。依自己的平台执行下面第一行，预期出现找不到 note.txt 的错误；第二行指定正确的子资料夹，应读到 Terminal practice: this is lesson one.。第一行失败不会自动进入 lesson one，也不应靠建立另一份根目录 note.txt 让错误消失。这个练习只读取资料，原档内容应保持不变。

Get-Content -LiteralPath '.\note.txt'
Get-Content -LiteralPath '.\lesson one\note.txt'

cat note.txt
cat 'lesson one/note.txt'

已安装 CLI 才在确认过的练习根目录执行 codex，并送出下方唯读要求。未安装者到 CLI 入门继续，不需要在本篇临时改权限。代理应找到 lesson one/note.txt，读到英文句子并回报工作位置；若位置不同，先检查入口是否建立了工作副本，再判断是否选错目录。

Read lesson one/note.txt and report the current working directory.
Do not modify any files. If the file is missing, report the actual error.

问题排除、结束与小练习

找不到指令先看目前壳层，Get-Content 不能直接当成 Bash 指令。路径被拆成两段先检查空白与直引号，避免从文书软体复制弯引号。显示拒绝存取时，确认你选的是自己的练习资料夹，不要立刻以管理员身分执行。终端机看不到档案但编辑器看得到，先按储存，再核对副档名、工作目录，以及是否在 WSL 的另一个家目录。

本篇没有改动原始档，结束时关闭终端机或离开练习目录即可。正在执行的程式通常可用 Ctrl+C 中断，但中断不等于还原已写入资料。再自行建立 lesson two/note.txt，写不同句子，从根目录分别读取两份内容。能分清路径与档案、正确处理空白、辨认失败后的位置，就完成练习；图中 1、2、3 是定位、读取、验证。

PowerShell 路径语义依Microsoft Set-Location 文件核对；Codex 启动依 CLI 官方文件，查证日 2026-09-14。Windows 命令另外以独立练习资料夹检查；macOS／Linux 段落为通用壳层操作说明，不冒充该平台实机截图。接著可读 Markdown与 AGENTS.md。

返回 Codex 教学总目录

阅读完整文字说明

Three numbered stages: identify the starting point, perform the exercise, and verify the result. Original illustration, not a product screenshot.

• AI 工具
• 教程
• Codex