ai agent 开发自学(2026/9/16)
- [1.前置准备(ai agent 独立的环境配置)](#1.前置准备(ai agent 独立的环境配置))
- [2.下载到文件的软件 环境变量配置](#2.下载到文件的软件 环境变量配置)
- 3.环境搭建
1.前置准备(ai agent 独立的环境配置)
除c盘以外的任意盘创建项目文件夹(避免所有东西安装c盘导致运行卡顿)
文件夹英文名任意(pro)
pro子文件夹
1.node
2.git
3.APIKey(创建任意txt文件存储key、地址、模型名称)
4.notepad
5.python
6.uv
账号三要素:key、地址、模型名称 (创建引入平台DeepSeek 智谱等)
申请大模型key:官网查询平台入口(登陆后控制台开发文档APIKey 创建key)
地址:平台开发文档,接入工具选择工具手动配置复制地址
模型名称:开发文档,模型概览选择模型,(练手免费)
2.下载到文件的软件 环境变量配置
复制文件路径node、git、uv、python(均需要单独配置环境变量,执行以下操作)
电脑设置--->高级系统设置---->环境变量设置----->系统变量path双击---->新建--->逐个粘贴进去(uv上移到顶)保存
每次配置完环境变量后,需关闭 cmd 窗口并重新打开,再执行验证命令,确保新配置生效。
3.环境搭建
- 下载安装git:
git下载界面 安装至pro/git文件
或电脑自带应用商城下载git(zip解压在pro/git文件当中)
配置环境变量
cmd 验证有版本号安装正确,出现git不是"内部"或外部命令也不是可运行程序时,重新复制git地址,重新配置环境变量
bash
git -v
- 下载安装notepad--
下载地址:代码地址
bash
git clone https://gitee.com/cxasm/notepad--.git
或电脑自带应用商城下载notepad-- (exe安装)安装地址设置pro/notepad
验证任意创建文本,打开方式能用notepad代开就行
- 下载python
下载地址:点击跳转
安装至pro/python下
配置环境变量
cmd验证,出现版本号安装成功否则重新检查环境变量
bash
python --version
- 安装uv
下载地址:点击跳转 根据自己电脑配置如 uv-x86_64-pc-windows.msvc.zip包
解压至pro/uv下
配置环境变量
cmd验证,出现版本号安装成功否则重新检查环境变量
bash
uv --version
- 安装node
下载地址点击跳转选择版本
安装至pro/node下
配置环境变量
cmd验证,出现版本号安装成功否则重新检查环境变量
版本要求node版本>18 npm版本>8.19.4
bash
node -v
npm -v
版本无误后node所在文件手动添加两个文件夹与node_modules同级
node_global // 下载的工具
node_cache // 下载时候的缓存
cmd验证读取与修改(默认get读取到的文件在c盘,修改至创建的文件当中):
读取默认下载工具地址node_global
bash
npm config get prefix
输出 xxx/AppData/Raming/npm, 需要修改
bash
npm config set prefix "复制粘贴node_global文件地址"
重新执行get设置到目标文件则正确
读取默认下载工具地址node_cache
bash
npm config get cache
输出 xxx/AppData/Raming/npm, 需要修改
bash
npm config set cache "复制粘贴node_global文件地址"
重新执行get设置到目标文件则正确
另配置npm下载网址提升npm下载速度,默认国外,设置为国内淘宝网址
bash
npm config set registry https://registry.npmmirror.com
node_global和node_cache分别配置环境变量到用户变量path,删除原有 xxx/AppData/Raming/npm,将目标文件替换,global上移置顶
6.安装claudecode
cmd node指令安装
bash
npm install -g @anthropic/ai-claude-code
如果报错试试管理员权限打开cmd重新执行
验证,有版本号安装成功
bash
claude --version
查看claude配置c盘/用户/xxx(用户名)/ glaude.json 用notepad打开就可以查看默认配置
有许多json键值对,下面键值对添加进配置(跳过新手提示,其他配置不认识,暂时还没学到,像startTime 这些就是时间,还有一些版本和id有点像日志的感觉,核心配置在setting.json文件,这个暂时不关注)
bash
hasCompletedOnboarding: true
在json文件同级.claude文件夹中创建setting,json配置文件
bash
{
"env": {
"ANTHROPIC_BASE_URL": "大模型接入地址",
"ANTHROPIC_AUTH_TOKEN": "大模型key",
"API_TIMEOUT_MS": "超时时间",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIVC": "1", //是否禁用非必要网络流量 1为禁用 (检查更新、遥测数据、匿名使用统计)
"ANTHROPIC_MODEL": "模型名称 [1m]", // [1m]指
"ANTHROPIC_DEFAULT_SONNET_MODEL": "模型名称 [1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "模型名称 [1m]",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "模型名称 [1m]",
"CLAUDE_CODE_EFFORT_LEVEL": "max" //不惜一切代价追求最高输出
},
"theme": "dark"
}