国内网络跑通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:
- 登录国内大模型厂商网站(如阿里云百炼、DeepSeek开放平台等)
- 右上角点击控制台
- 点击新建API Key
- 随便填个名字,点新建
- 复制生成的Key,填到配置文件里
获取Base URL:
- 在同一网站右上角点击文档
- 找到”在第三方中使用”
- 在文档里找到Base URL,复制填到配置文件里
第3步:启动验证
claude
- Windows选择”信任当前文件夹”
- Mac/Linux弹出授权窗口点”允许”
- 打个招呼,收到回复就成功了!
实战:让Claude Code写个坦克大战并上传GitHub
- 新建文件夹,右键在终端打开
- 输入
claude启动 - 输入提示词:
创建一个html的坦克大战,并且上传到Github上面变成一个仓库 - AI执行过程中申请权限,选yes
- AI让你创建GitHub仓库时,访问
https://github.com/new,填仓库名创建 - 复制仓库地址粘贴给Claude Code
- 弹出登录窗口,选”使用浏览器登录”,点授权
- 代码自动上传到GitHub,完成!
二、Codex——OpenAI出品的AI Agent新贵
Codex是OpenAI近期推出的Agent工具,额度高,对中国用户比较友好。
前提:需要ChatGPT Plus订阅
Codex至少需要Plus套餐才能使用。
获取Plus订阅步骤(安卓手机):
- 访问
https://chatgpt.com/,免费注册ChatGPT账户 - 安卓手机下载Google Play商店,登录
- 将Google账号国家/地区改为美国(需美国上网环境)
- 如改地区失败,访问
https://payments.google.com/,添加美国地址 - 在Play商店绑定国内银行卡(支持)
- Play商店搜索ChatGPT,下载手机APP
- 打开APP → 顶部点击”获取Plus” → 订阅方式选Google Play
- 订阅完成
获取Claude官方订阅同理,但必须用Gmail邮箱的谷歌账号登录,这样不会触发手机验证码。
安装Codex
npm install -g @openai/codex
启动
codex
浏览器弹出登录页面,登录ChatGPT账户,打个招呼收到回复即可。
三、Hermes Agent——自我进化的AI智能体
Hermes Agent的特点是内置学习闭环,用得越多越懂你。但它不支持Windows原生,需要通过WSL运行。
Windows用户:先装WSL
开启Windows功能:
- 搜索”功能” → 选择”启用或关闭Windows功能”
- 勾选:
- ✅ 适用于Linux的Windows子系统
- ✅ 虚拟机平台
- 点确定,重启电脑
安装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》
夜雨聆风