---
title: "安装、环境与第一条有效任务"
description: "按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 最小安装路径：

```bash
# 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 最小安装路径：

```bash
# 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 | 人类决定接受、修改或回滚 |

:::note[新人第一周不要跳过]
在真实项目里跑 3 次“读代码 → 改一个最小点 → 验证 → 看 Diff → 回滚或提交”。每次记录 Agent 猜错的地方，并把高价值规则统一写入 AGENTS.md。
:::

## 2.6 安装完成检查表

- 能运行 `claude --version`、`codex --version`，并知道如何查看 `--help`。
- 能在真实项目中完成只读概览，不出现路径或权限错误。
- 能看见并审阅文件 Diff，知道如何撤销。
- 能运行至少一条真实测试、构建或 lint 命令。
- 已确认默认权限模式，不处于无意开启的 Full Access / bypass 状态。
- 已确认密钥、客户数据、生产配置不会被自动读取或外发。