乐于分享
好东西不私藏

国内网络跑通AI Agent(下):装好Claude Code、Codex和OpenClaw,接国内模型

国内网络跑通AI Agent(下):装好Claude Code、Codex和OpenClaw,接国内模型

国内网络跑通AI Agent(下):装好Claude Code、Codex和OpenClaw,接国内模型

上一篇我们把地基打好了——Node.js、Git、GitHub、VS Code、Python全部就位。

今天进入正题:安装AI Agent框架,配置国内模型,让它们真正跑起来。


一、Claude Code——公认最强的AI Agent

安装

三系统统一命令:

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

配置国内模型(关键步骤)

Claude Code默认用Anthropic的API,国内直接调不通。解决方案:接国内大模型厂商的API

第1步:创建配置文件

系统 操作
Windows 进入 C:/Users/你的用户名,新建 .claude.json 文件
Mac 终端执行 cd ~ && touch .claude.json
Linux 终端执行 touch ~/.claude.json

Windows用户注意:需要先在文件夹选项里勾选”显示隐藏文件”和”显示文件扩展名”,否则看不到也不改不了。

第2步:编辑配置文件

用记事本/文本编辑器打开 .claude.json,粘贴以下内容:

{
"env": {
"ANTHROPIC_API_KEY": "你的API Key",
"ANTHROPIC_BASE_URL": "模型厂商的Base URL"
}
}

需要修改两个地方:

获取API Key:

  1. 登录国内大模型厂商网站(如阿里云百炼、DeepSeek开放平台等)
  2. 右上角点击控制台
  3. 点击新建API Key
  4. 随便填个名字,点新建
  5. 复制生成的Key,填到配置文件里

获取Base URL:

  1. 在同一网站右上角点击文档
  2. 找到”在第三方中使用”
  3. 在文档里找到Base URL,复制填到配置文件里

第3步:启动验证

claude
  • Windows选择”信任当前文件夹”
  • Mac/Linux弹出授权窗口点”允许”
  • 打个招呼,收到回复就成功了!

实战:让Claude Code写个坦克大战并上传GitHub

  1. 新建文件夹,右键在终端打开
  2. 输入 claude 启动
  3. 输入提示词:创建一个html的坦克大战,并且上传到Github上面变成一个仓库
  4. AI执行过程中申请权限,选yes
  5. AI让你创建GitHub仓库时,访问 https://github.com/new,填仓库名创建
  6. 复制仓库地址粘贴给Claude Code
  7. 弹出登录窗口,选”使用浏览器登录”,点授权
  8. 代码自动上传到GitHub,完成!

二、Codex——OpenAI出品的AI Agent新贵

Codex是OpenAI近期推出的Agent工具,额度高,对中国用户比较友好。

前提:需要ChatGPT Plus订阅

Codex至少需要Plus套餐才能使用。

获取Plus订阅步骤(安卓手机):

  1. 访问 https://chatgpt.com/,免费注册ChatGPT账户
  2. 安卓手机下载Google Play商店,登录
  3. 将Google账号国家/地区改为美国(需美国上网环境)
  4. 如改地区失败,访问 https://payments.google.com/,添加美国地址
  5. 在Play商店绑定国内银行卡(支持)
  6. Play商店搜索ChatGPT,下载手机APP
  7. 打开APP → 顶部点击”获取Plus” → 订阅方式选Google Play
  8. 订阅完成

获取Claude官方订阅同理,但必须用Gmail邮箱的谷歌账号登录,这样不会触发手机验证码。

安装Codex

npm install -g @openai/codex

启动

codex

浏览器弹出登录页面,登录ChatGPT账户,打个招呼收到回复即可。


三、Hermes Agent——自我进化的AI智能体

Hermes Agent的特点是内置学习闭环,用得越多越懂你。但它不支持Windows原生,需要通过WSL运行。

Windows用户:先装WSL

开启Windows功能:

  1. 搜索”功能” → 选择”启用或关闭Windows功能”
  2. 勾选:
  3. ✅ 适用于Linux的Windows子系统
  4. ✅ 虚拟机平台
  5. 点确定,重启电脑

安装WSL:

wsl --install

等待下载完成,填写用户名密码。

验证:

wsl -l -v

显示Ubuntu即安装成功。

进入WSL: 终端顶部点加号,下拉选Ubuntu。

安装Hermes Agent

在WSL(Windows)或终端(Mac/Linux)中执行一键安装命令:

# Hermes Agent官方安装命令(网络不好多试几次)
curl -fsSL https://hermesagent.ai/install.sh | bash

安装过程约20分钟,选择模型提供商(推荐OpenRouter),根据提示创建API Key,粘贴进去,选模型,启动聊天打个招呼即可。

WSL与Windows文件互通

方向 方法
Windows看Linux 我的电脑 → 左下角Linux图标 → Ubuntu文件夹
Linux看Windows 终端输入 cd /mnt/c 进入C盘

四、OpenClaw(龙虾)——GitHub星标第一的AI Agent

安装方式最简单,一条命令搞定:

npm install -g openclaw@latest
openclaw onboard --install-daemon

验证:

openclaw --version
openclaw doctor
openclaw gateway status

OpenClaw的详细使用教程,可以参考本公众号的5天系列文章,从认识到安装到自动化全覆盖。


五、命令速查表

Claude Code

# 安装
npm install -g @anthropic-ai/claude-code

# 启动
claude

# 配置文件位置
# Windows: C:/Users/你的用户名/.claude.json
# Mac/Linux: ~/.claude.json

Codex

# 安装
npm install -g @openai/codex

# 启动
codex

OpenClaw

# 安装
npm install -g openclaw@latest
openclaw onboard --install-daemon

# 验证
openclaw doctor

WSL(仅Windows)

# 安装
wsl --install

# 查看版本
wsl -l -v

Python虚拟环境

# Windows
python -m venv .venv
.venv\Scripts\activate

# Mac / Linux
python -m venv .venv
source .venv/bin/activate

⚠️ 五大避坑提醒

症状 解决
.claude.json找不到 Windows隐藏文件默认不显示 文件夹选项勾选”显示隐藏文件”
Claude Code连不上 API Key或Base URL填错 仔细检查两处配置是否完整复制
Codex提示无权限 没有Plus订阅 安卓手机通过Google Play订阅
Hermes Agent装不了 Windows原生不支持 通过WSL安装运行
pip install报错 Mac HomeBrew禁止全局安装 先创建虚拟环境再装

总结:从零到跑通,你需要做的事

步骤 做什么 时间
1 安装Node.js + Git + VS Code + Python 20分钟
2 安装Watt Toolkit加速GitHub 5分钟
3 注册GitHub账号 5分钟
4 安装Claude Code + 配置国内模型 15分钟
5 安装Codex(需Plus订阅) 10分钟
6 安装OpenClaw 5分钟
7 (可选)安装WSL + Hermes Agent 30分钟

总计约1.5小时,你的电脑就能跑通所有主流AI Agent框架。

以后再也不用求人搭环境了。


关键网站汇总:

  • Node.js:https://nodejs.org/zh-cn
  • Git:https://git-scm.com/
  • VS Code:https://code.visualstudio.com/
  • GitHub:https://github.com/
  • Watt Toolkit:Microsoft Store搜索或官网下载
  • Python:https://www.python.org/downloads/
  • HomeBrew:https://brew.sh/
  • ChatGPT:https://chatgpt.com/

参考来源:技术爬爬虾《从零开始用国内网络,跑通Claude Code等一切Agent》