AI agent软件安装
安装顺序 VSCode→ Git → Docker Desktop → uv → ccswitch全程 Windows 10/11 64 位每装完一个建议重启一次终端Docker 安装前重点检查 CPU 虚拟化无需单独下载python客户端安装UV之后统一用uv安装python解释器方便后续管理通用原则软件路径不要中文、不要空格一、第一步安装 VS Code1. 下载https://code.visualstudio.com/Download 下载 Windows User Installer64 位2. 安装【必勾选项】许可协议 → 下一步自定义安装路径建议放 D 盘 来到「选择附加任务」页面全部勾选 ✅ 添加到 PATH重启 shell 生效 ✅ 注册为受支持文件编辑器 ✅ 添加 “通过 Code 打开” 右键菜单 ✅ 创建桌面快捷方式下一步 → 安装。3. VS Code 安装必备扩展打开 VSCode 扩展面板CtrlShiftXPythonMicrosoft 官方【必装】 Python 语言支持、代码补全、调试、解释器选择Ruff【强烈推荐uv 配套】 极速代码格式化 静态检查替代 flake8/isortPylance随 Python 扩展自动附带可选Python Debug Console、indent-rainbow二、第二步安装 Git最先装VSCode 依赖 Git1. 下载官网https://git-scm.com/download/win 下载64-bit Git for Windows Setup2. 安装关键勾选一路下一步重点看这里1. 运行安装包Git‑xxx‑64‑bit.exe点击Next进入下一步2. Select Destination Location安装路径默认C:\Program Files\Git想改到 D 盘就点 Browse路径不要中文、不要空格选好后 → Next3. Select Components组件勾选✅ 保持默认勾选即可Git Bash HereGit GUI HereGit LFSAssociate .git* configuration files ...不要额外乱加勾选直接 Next4. Choosing the default editor used by Git选择编辑器下拉选择Use Visual Studio Code as Gits default editor绑定 VS Code提交写注释更方便 → Next5. Adjusting your PATH environment关键页面必选这个选择Git from the command line and also from 3rd‑party software含义把 Git 加入系统环境变量PowerShell、CMD、VSCode 终端都能识别git命令 → Next6. Choosing the SSH executable默认Use bundled OpenSSH自带 SSH不用系统 OpenSSH 保持不动 → Next7. Choosing HTTPS transport backend默认Use the native Windows Secure Channel library保持默认 → Next8. Configuring the line ending conversions换行符设置开发必配选择Checkout Windows‑style, commit Unix‑style line endingsWindows 检出 CRLF提交给 Git 仓库用 LF跨平台兼容 WSL / Docker / Linux 项目 → Next9. Configuring the terminal emulator to use with Git Bash选择Use MinTTY (the default terminal of MSYS2)→ Next10. Choose the default behavior ofgit pull默认Fast‑forward or merge保持不变 → Next11. Choose a credential helper凭证管理器✅Git Credential Manager自动保存 Github 账号密码 / 令牌强烈保留 → Next12. Configuring extra options额外功能全部保持默认勾选Enable file system cachingEnable symbolic links → Next13. Experimental options实验性功能两个复选框全部不要勾选直接点Install14. 安装结束取消掉View Release Notes不需要看更新日志 ✅ 勾选Launch Git Bash可选 点击 Finish3. 验证 基础配置打开PowerShell / Git Bashgit --version出现版本号即成功。配置全局用户名邮箱和你的 GitHub 账号一致git config --global user.name 你的用户名 git config --global user.email 你的github注册邮箱4. 可选生成 SSH 密钥方便拉取 Github不用每次输账号密码ssh-keygen -t ed25519 -C 你的github邮箱连续三次回车不设置密钥密码 查看公钥cat ~/.ssh/id_ed25519.pub复制密钥ssh开头邮箱结尾去 GitHub 设置 → SSH and GPG keys 粘贴添加。三、第三步安装 Docker Desktop ⚠️前置条件非常重要前置检查必须完成否则 Docker 启动失败1.CtrlShiftEsc 打开任务管理器 → 性能 → CPU查看虚拟化已启用如果显示禁用重启电脑进 BIOS 开启Intel VT-x / AMD-V2.以管理员身份打开 PowerShell一键启用 WSL2wsl --install这一步是在C盘安装子系统WLS,执行完成后重启电脑3.重启开机后操作重启完成直接打开 PowerShell不用管理员会自动弹出 Ubuntu 设置窗口(如果重启后没有自动弹出 Ubuntu 配置, 在 PowerShell 手动启动 Ubuntuubuntu设置Linux 用户名、密码自定义记住密码后续 Docker 会用到用户名不要带中文、空格验证 WSL 是否正常,打开 PowerShell 执行wsl -l -v正常输出示例NAME STATE VERSION * Ubuntu Running 2确保VERSION 2Docker Desktop 强制要求 WSL24.安装 Docker Desktop 前置须知WSL 启动完毕后再安装 Docker DesktopDocker 安装时勾选Use WSL2 instead of Hyper-V默认勾选Docker 第一次启动会自动关联 Ubuntu WSL 环境5.下载 Docker Desktophttps://www.docker.com/products/docker-desktop/6. 安装设置双击安装包 ✅Use WSL 2 instead of Hyper-V必勾选 ✅ Add shortcut to desktop 点击 OK 开始安装完成后重启电脑。7. 首次启动配置打开 Docker Desktop接受协议设置齿轮→ General保持【Use the WSL 2 based engine】开启Resources → WSL Integration启用对应子系统【国内优化】Settings → Docker Engine添加镜像加速器解决拉镜像慢{ builder: { gc: { defaultKeepStorage: 20GB } }, experimental: false, registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://hub-mirror.c.163.com ] }4. 验证新开终端运行docker --version docker compose version四、第四步安装 uvPython 包管理推荐方式PowerShell 管理员执行一键安装powershell -ExecutionPolicy Bypass -c irm https://astral.sh/uv/install.ps1 | iex安装程序自动写入环境变量。验证必须新开 PowerShell 窗口uv --version输出版本号代表成功。安装python全局基础解释器uv和全局python全局基础解释器放在 C 盘用户目录,后续项目文件的虚拟环境放在D盘uv python install 3.12五、第五步安装 CC Switch模型 API 切换工具1. 下载地址前往 Github Releaseshttps://github.com/zuoliangyu/cc-switch/releases 下载CC-Switch-vxxx-Windows.msi安装版推荐2. 安装要点双击 msi如 Windows 拦截更多信息 → 仍要运行自定义路径路径不能有中文、空格✅勾选添加到系统 PATH、桌面快捷方式完成启动 CC Switch3. 迁移配置如果你旧电脑导出过供应商配置打开 CC Switch → 导入配置文件直接恢复 API 密钥与模型设置。整套安装完成后新电脑标准开发上线流程Git Bash 测试 SSH 连通 Githubssh -T gitgithub.com新建项目文件夹git clone xxx.git拉取代码手动拷贝旧电脑备份的 .env、私有配置文件.gitignore 内文件项目目录执行uv venv uv sync重建 Python 环境启动 Docker Desktop执行docker compose up -d启动容器VS Code 打开项目选择 uv 创建的.venv内 Python 解释器⚠️高频踩坑清单安装完工具不重启终端命令找不到PATH 未加载Docker 没开启虚拟化、未安装 WSL2启动报错uv/ccswitch 安装路径带中文程序异常尝试复制.venv、Docker 镜像文件夹跨电脑迁移出现路径报错Github 拉代码忘记拷贝.env 密钥本地运行缺少参数
)
