摘要：本文基于三台新装系统的电脑（Windows、macOS、Ubuntu），全程使用国内家庭宽带，从零开始配置Node.js、Git、Python、Claude Code、Codex、WSL等AI Agent运行环境。所有操作均经过录屏验证，覆盖三大操作系统，附国内网络加速和API配置方案。

目录

1. 准备工作与核心工具清单
2. Windows系统环境搭建
3. macOS系统环境搭建
4. Linux（Ubuntu）系统环境搭建
5. 国内网络访问GitHub解决方案
6. 获取API Key与模型配置
7. 参考资源

1. 准备工作与核心工具清单

工具	用途	安装方式
Node.js	AI Agent运行环境（OpenClaw等依赖）	官网下载 / nvm
Git	版本控制	官网下载 / 系统包管理器
Python	Agent附属脚本运行	官网 / Homebrew / apt
VS Code	代码编辑器	官网下载
Claude Code	AI编程Agent	npm安装
Codex	OpenAI官方Agent	npm安装
Watt Toolkit	GitHub网络加速	微软商店 / 官网

2. Windows系统环境搭建

2.1 安装Node.js

Node.js是运行AI Agent软件的基础环境，大量Agent（如OpenClaw）依赖Node.js才能运行。

1. 访问Node.js官网，下载Windows系统安装程序
2. 运行安装程序，一路点击下一步完成安装
3. 以管理员身份打开PowerShell，执行命令允许运行脚本：

   Set-ExecutionPolicy RemoteSigned
   

4. 验证安装：

   node -v
   npm -v
   

2.2 安装Git

Git是全世界最流行的版本控制软件，使用Git进行版本控制可以让AI随时回退到某个历史节点重新工作。

1. 访问Git官网，下载Windows系统安装包（根据CPU架构选择x86-64位）
2. 运行安装程序，一路点击下一步完成安装
3. 验证安装：

   git --version
   

2.3 安装与配置Claude Code

1. 在终端中执行安装命令：

   npm install -g @anthropic-ai/claude-code
   

2. 创建配置文件 .claude.json，存放于用户主目录（C:\Users\你的用户名\）
3. 配置文件核心字段：
   • token：填入API Key
   • baseUrl：填入模型厂商的API地址
4. 启动验证：

   claude
   

2.4 安装VS Code

VS Code是使用Agent进行代码编写的必备软件。访问VS Code官网下载Windows安装程序，一路点击下一步完成安装。

2.5 安装Python

1. 访问Python官网，下载Install Manager
2. 运行安装器完成安装
3. 验证安装：

   python --version
   pip --version
   

4. 推荐使用虚拟环境管理项目依赖：

   # 安装指定版本
   pyenv install 3.13
   # 创建虚拟环境
   python -m venv .venv
   # 激活虚拟环境
   .venv\Scripts\activate
   

很多AI不喜欢用虚拟环境，可以在提示词中注明要求AI必须使用虚拟环境。

2.6 安装WSL（Windows Subsystem for Linux）

WSL让Windows电脑拥有Linux子系统，可以运行原本Windows上不支持的Agent软件。

1. 在搜索栏搜索功能，选择启用或关闭Windows功能
2. 勾选适用于Linux的Windows子系统和虚拟机平台
3. 点击确定，根据提示重启电脑
4. 重启后在终端执行：

   wsl --install --web-download
   

5. 填写用户名和密码完成安装

WSL文件系统与Windows互通，可以在Windows中访问Linux文件，也可以从Linux访问Windows的C盘。

WSL上安装Hermes Agent示例：

# 在WSL2终端中执行一键安装命令
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后选择模型提供商（如OpenRouter），创建API Key并粘贴，选择模型后即可启动聊天功能。

3. macOS系统环境搭建

3.1 替换默认浏览器

macOS自带的Safari浏览器兼容性有限，建议替换为Chrome。

1. 使用Safari访问Chrome官网下载安装包
2. 双击安装包，将Chrome拖拽进Applications文件夹
3. 将Chrome加入程序坞，移除Safari

3.2 安装命令行开发工具

在终端中执行：

xcode-select --install

点击同意完成安装。该工具包内含Git等基础开发工具。

3.3 安装Node.js（使用nvm）

避免使用Node.js官网安装包，否则会出现权限问题。

在终端中依次执行：

# 创建shell配置文件
touch ~/.zshrc
# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 重新加载配置
source ~/.zshrc
# 安装Node.js 24
nvm install 24

验证安装：

node -v
npm -v

3.4 安装与配置Claude Code

1. 安装Claude Code：

   npm install -g @anthropic-ai/claude-code
   

2. 创建配置文件：

   cd ~
   touch .claude.json
   

3. 在访达中按Cmd+Shift+.显示隐藏文件，编辑.claude.json
4. 填入API Key和Base URL后保存
5. 启动验证：

   claude
   

3.5 安装Homebrew

Homebrew是macOS上最流行的命令行软件管理器。

访问Homebrew官网，复制一键安装命令，在终端中执行。

3.6 使用Homebrew安装Python

brew install python@3.12

配置Python别名，编辑~/.zshrc文件，添加：

alias python='python3.12'
alias python3='python3.12'

Homebrew安装的Python禁止全局安装依赖，必须使用虚拟环境。

创建虚拟环境：

cd 项目文件夹
python -m venv .venv
source .venv/bin/activate
pip install 包名

4. Linux（Ubuntu）系统环境搭建

4.1 更新APT索引

sudo apt update

4.2 安装必备软件

sudo apt install curl
sudo apt install git

4.3 安装Node.js（使用nvm）

依次执行四个命令：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 24

验证：

node -v

4.4 安装与配置Claude Code

npm install -g @anthropic-ai/claude-code
cd ~
touch .claude.json

在文件管理器中显示隐藏文件，编辑.claude.json填入API Key和Base URL。

启动验证：

claude

4.5 安装VS Code

访问VS Code官网下载deb格式安装包：

sudo dpkg -i 安装包名.deb

4.6 安装Chrome浏览器

访问Chrome国内官网下载deb包：

sudo dpkg -i chrome安装包名.deb

5. 国内网络访问GitHub解决方案

GitHub是国内开发者访问最频繁的代码托管平台，但常因网络问题导致超时或打不开。

推荐工具：Watt Toolkit（原名Steam++）

Watt Toolkit是一个开源跨平台的多功能工具箱，支持Windows、macOS、iOS和Android。其网络加速功能可以使GitHub等国内难以访问的网页正常访问，且永久免费。

Windows安装方式：

1. 打开Microsoft Store，搜索Watt Toolkit
2. 点击安装
3. 打开软件，找到网络加速，勾选GitHub，点击一键启动加速

macOS安装方式：

1. 访问Watt Toolkit官网下载安装包
2. 双击打开，拖拽进Applications
3. 如遇安全策略阻止，在系统设置隐私与安全性中允许打开
4. 如遇权限错误，在终端执行权限修复命令
5. 打开软件，勾选GitHub，点击一键加速

GitHub账号注册：
在右上角点击Sign up，填写用户名、邮箱、密码、地区，点击注册，从邮箱收取验证码完成验证。

6. 获取API Key与模型配置

6.1 从国内AI服务商获取

1. 登录国内大模型厂商网站（如智谱AI、DeepSeek等）
2. 进入控制台，点击新建API Key
3. 填写名称，点击创建，复制生成的API Key

6.2 获取Base URL

在厂商文档中找到API地址（Base URL），复制填入Claude Code配置文件的对应位置。

6.3 Claude Code配置文件模板

{
  "apiKey": "你的API Key",
  "baseUrl": "https://api.厂商域名.com/v1",
  "model": "模型名称"
}

7. 参考资源

• 本文基于B站视频《从零开始用国内网络跑通Claude Code等一切Agent》撰写，通过Ai好记进行视频转录、提炼核心步骤、观点及代码，如果你也想在学习相关教程时快速回顾关键命令和操作，可以用这个工具把视频转为图文笔记，方便随时查阅。亲测好用～

如有问题欢迎评论区交流。如果本文对你有帮助，点赞、收藏、转发支持～