返回文档中心

Agent 编程环境搭建:终端、Git、运行时与密钥

Agent 工具想稳定工作,基础环境必须清晰,本页把 OpenClaw、Claude Code、Codex、Hermes 这类工具常用的本地准备工作整理成一条路线

环境搭建 约 7 分钟阅读 Agent 工具基础

一、先准备一个干净的项目空间

建议把所有测试项目放在固定目录,例如 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 大改代码,而是让它解释项目结构和可执行命令