安装、环境与第一条有效任务
按2026年9月最新基线版本安装和校验Claude Code与ChatGPT Codex环境，完成只读概览、最小代码修改、本地验证与人工审阅的首条有效AI开发任务。
本章给出 2026-09 基线下更稳妥的安装与校验路径。命令和套餐会快速变化，正式培训前必须重新执行版本校验。
2.1 平台与入口总览
| 平台 | Claude Code | ChatGPT / Codex | 建议 |
|---|---|---|---|
| macOS（Apple Silicon） | Native Install；CLI、IDE、Desktop | ChatGPT 桌面 + Codex CLI / IDE | 最完整的本地开发与 Computer Use 体验之一 |
| Linux | Native Install；CLI、IDE、Desktop | ChatGPT Linux 桌面 + Codex CLI / IDE | 桌面端为较新平台，部分 GUI 能力需核对成熟度 |
| Windows | Native Install、WinGet、PowerShell；也可 WSL | ChatGPT 桌面 + Codex CLI / IDE；可选 WSL | 已不应笼统标注“不推荐”，应按项目工具链选择原生或 WSL |
| 远程服务器 / 容器 | CLI、SSH、CI、Routines / Agent SDK | Codex CLI、Cloud、CI / SDK | 适合可复现环境、后台任务与隔离执行 |
2.2 Claude Code 安装与校验
Claude Code 最小安装路径：
# macOS / Linux / WSL（官方推荐 Native Install）
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# 安装后校验
claude --version
claude --help
claude- Native Install 会自动更新；Homebrew / WinGet 等包管理方式的更新行为以当前官方说明为准。
- 进入一个真实项目目录后，先要求只读概览，再执行一个最小可逆修改。
- 当前版本变化很快；截至本讲义基线，官方 changelog 顶部版本为 2.1.258，但培训时必须以本机
claude --version为准。
资料依据：Anthropic Claude Code Quickstart；Claude Code Changelog（2026-09-01）。
2.3 ChatGPT 桌面客户端与 Codex CLI 安装
ChatGPT 桌面客户端可从官方页面下载 macOS、Windows 或 Linux 版本。登录后可选择 ChatGPT 或 Codex；在 ChatGPT 视图中再选择 Chat 或 Work。Codex CLI 可独立安装，并与桌面、IDE 和云端工作流协同。
Codex CLI 最小安装路径：
# macOS / Linux：Codex CLI 独立安装器
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# 安装后校验
codex --version
codex
# 首次运行
# 进入项目目录，选择 Sign in with ChatGPT 或当前可用的登录方式资料依据：OpenAI ChatGPT desktop app；OpenAI Codex CLI。
2.4 开发环境的最小前置条件
| 类别 | 最低要求 | 推荐做法 |
|---|---|---|
| 版本控制 | 项目纳入 Git；开始前知道当前分支和工作区状态 | 任务前后创建 checkpoint；复杂任务使用新分支或 worktree |
| 工具链 | 项目的 dev / test / lint / typecheck / build 命令可执行 | 把唯一正确命令写进规则文件并由 CI 复核 |
| 依赖 | 包管理器和运行时版本明确 | 使用 lockfile、版本管理器与容器；禁止 Agent 随意更换包管理器 |
| 环境变量 | 有 .env.example 或文档 |
真实密钥不进入提示词、规则文件、仓库或日志 |
| 浏览器验证 | 至少有可重复的启动方式 | 优先 Playwright；GUI-only 问题再使用 Browser / Computer Use |
| 外部系统 | 账号与权限范围明确 | 机器人账号、最小 scope、测试环境、dry-run、审计日志 |
2.5 第一条有效任务：只验证最小闭环
| 步骤 | Claude Code 示例 | Codex 示例 | 成功标准 |
|---|---|---|---|
| 进入项目 | claude |
codex |
会话能读取当前目录 |
| 只读理解 | “先不要改代码，概览项目、入口与测试命令” | “Tell me about this project. Do not edit files yet.” | 能指出真实文件与命令 |
| 最小修改 | 修一处文案、类型或测试用例 | 同左 | Diff 范围可解释且可回滚 |
| 执行验证 | 运行最小测试 / lint | 同左 | 提供命令、结果和失败原因 |
| 人工审阅 | 检查 diff 和副作用 | 检查 diff / review panel | 人类决定接受、修改或回滚 |
2.6 安装完成检查表
- 能运行
claude --version、codex --version，并知道如何查看--help。 - 能在真实项目中完成只读概览，不出现路径或权限错误。
- 能看见并审阅文件 Diff，知道如何撤销。
- 能运行至少一条真实测试、构建或 lint 命令。
- 已确认默认权限模式，不处于无意开启的 Full Access / bypass 状态。
- 已确认密钥、客户数据、生产配置不会被自动读取或外发。