AI Agent 开发实战（01）：开发环境搭建与 Claude Code 安装

发布时间2026-07-14标签AI Agent实战Claude Code操作指南目标一次装完后续全系列都能用把Python 3.13 Node 22 Docker Git基础环境装好并在此之上装好Claude Code跑通一次启动登录。读完本文你输入claude就能在终端里启动一个能读代码、改文件、跑命令的 AI 工程师。模型接入DeepSeek / OpenRouter留到第 02、03 篇。环境准备软件版本要求用途Python≥ 3.11推荐 3.13Agent 逻辑、LangGraph、MCP ServerNode.js≥ 20推荐 22Claude Code、部分 MCP 工具Docker最新稳定版容器化部署 Agent后续篇Git任意新版代码管理、GitHub 开源Claude 账号—登录 Claude Codeclaude.ai 免费注册先建一个统一工作目录避免文件散落mkdir -p ~/ai-agent-lab cd ~/ai-agent-labWindows 用mkdir ai-agent-lab然后cd ai-agent-lab步骤第一部分基础环境1. 安装 Python 3.13去 python.org 下载 3.13。Windows 安装时务必勾选Add python.exe to PATH。Mac 用brew install python3.13。验证 建虚拟环境后续每篇复用避免包污染python --version # 预期Python 3.13.x python -m venv .venv # Windows 激活.venv\Scripts\activate # Mac/Linux 激活source .venv/bin/activate激活后命令行前面出现(.venv)即成功。2. 安装 Node.js 22去 nodejs.org 下载LTS 22不要选 Current。Mac 用brew install node22。node --version # 预期v22.x.x npm --version3. 安装 Docker去 docker.com 下载Docker Desktop安装启动任务栏出现小鲸鱼且状态 running。docker --version # 预期Docker version 27.x.x docker run hello-world # 预期输出 Hello from Docker!4. 安装 GitWindows 去 git-scm.com 默认选项安装Mac 一般自带。git --version # 预期git version 2.x.x5. 配置国内镜像推荐pip 换清华源pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simpleDocker 换源Docker Desktop → Settings → Docker Engine加入后Apply Restart{ registry-mirrors: [https://docker.m.daocloud.io] }第二部分安装 Claude Code注这里安装的为claude coded命令行版本6. 全局安装npm install -g anthropic-ai/claude-codeWindows 若报权限红字用管理员身份PowerShell 重跑。验证claude --version # 预期输出版本号如 1.0.287. 启动并登录cd ~/ai-agent-lab claude第一次运行会自动打开浏览器用 Claude 账号登录授权 → 授权成功后终端出现输入提示符。不想走浏览器 OAuth也可以用 API Keyconsole.anthropic.com 创建# Windows$env:ANTHROPIC_API_KEY sk-ant-xxxx # Mac/Linuxexport ANTHROPIC_API_KEYsk-ant-xxxx8. 最小冒烟测试在后输入 列出当前目录下的文件它会调用命令把目录内容打出来。能正常回应 安装 登录 运行全通。退出用/exit。验证全部跑通 环境就绪python --version node --version docker --version git --version claude --version再进 Claude Code 对话一句 你是谁能正常回应即达标。最终目录结构ai-agent-lab/ ├── .venv/ # Python 虚拟环境 └── .claude/ # Claude Code 项目配置自动生成踩坑记录1. Windows 输入python/claude提示不是内部或外部命令PATH 没生效。Python 重跑安装包勾Add to PATHclaude 则跑npm bin -g把全局目录加进 PATH重开终端。2.docker run hello-world超时拉不下来没配镜像源或网络拦截。配上第 5 步 DaoCloud 镜像再试仍不行切热点验证。3. 虚拟环境激活后pip install装到了系统 Python命令行前面没(.venv)——激活没成功。重新激活where pipWin/which pipMac路径里应含.venv。4. Node 装了 Current 版后续 MCP 工具报EBADENGINE严格用 LTS 22装错就卸掉重装。5. Claude Code 登录成功但一对话报 region / 地区不可用Anthropic 对部分区域限制。这正是第 02、03 篇要解决的——用 DeepSeek / OpenRouter 接入绕开官方区域。本篇先保证能装能登。6. 终端中文乱码用Windows Terminal替代老 cmd或执行chcp 65001切 UTF-8。下一步装好了但还跑不了国产模型。下一篇接上你最需要的→ AI Agent 开发实战02Claude Code 接入 DeepSeek用 DeepSeek 当大脑、Claude Code 当双手。