Agent 编程环境搭建:终端、Git、运行时与密钥
Agent 工具想稳定工作,基础环境必须清晰,本页把 OpenClaw、Claude Code、Codex、Hermes 这类工具常用的本地准备工作整理成一条路线
一、先准备一个干净的项目空间
建议把所有测试项目放在固定目录,例如 D:\Code、D:\Work 或 ~/Code,避免桌面、下载目录和临时文件夹混在一起
- 每个项目单独建文件夹,名称用英文或拼音
- 项目根目录保留 README、配置文件和任务说明
- 不要把密钥、账号截图、客户数据随意放入项目
二、终端与 Git 是 Agent 的入口
多数代码 Agent 都需要读取文件、执行命令、查看 Git 差异,因此终端和 Git 是最基础的能力
- Windows 推荐 PowerShell 7 或 Windows Terminal
- macOS 推荐系统终端或 iTerm2
- 安装 Git 后配置用户名、邮箱和默认分支名
- 习惯使用 git status、git diff、git log 查看上下文
三、运行时按项目选择
不要一次装满所有工具,先根据项目类型准备运行时
- 前端项目优先准备 Node.js LTS、npm 或 pnpm
- Python 自动化准备 Python、pip、虚拟环境或 Conda
- 文档和静态站点先保证浏览器、编辑器和本地 HTTP 服务可用
- 涉及数据库时,再补充 SQLite、PostgreSQL 或可视化管理工具
四、密钥与权限单独管理
Agent 可能会调用模型、仓库、浏览器或第三方服务,密钥管理要比普通学习项目更谨慎
- 密钥放入环境变量或本地忽略文件,不提交到 Git
- 为不同工具设置不同权限,减少误操作影响范围
- 重要项目先让 Agent 读上下文和提方案,再允许执行修改
环境搭好后,第一件事不是让 Agent 大改代码,而是让它解释项目结构和可执行命令