46 · 开发环境配置指南
终端、Shell、开发容器、网络代理和项目初始化等环境配置,帮你减少命令执行差异、让 Claude 在稳定环境里工作。
Claude Code 运行在「你的开发环境」里,环境稳不稳,直接影响它干得顺不顺。这一篇讲怎么把环境配稳。
「终端」:选一个稳定的终端,确保 Claude Code 的命令能正常执行。终端环境的差异,会导致「同样一条命令,结果不一样」。
「Shell」:搞清楚你用的是哪个 shell,以及它的配置。很多环境问题,根子在 shell 配置上。
「开发容器」:用 Docker 之类的容器,把开发环境「固定」下来。这样 Claude 在一个稳定、可复现的环境里工作,减少「我这能跑、你那不能跑」的问题。
「网络代理」:国内用户尤其关心。配置好代理,Claude 才能正常联网、访问它需要的服务。
「项目初始化」:项目的依赖、构建工具、环境变量,先配好,Claude 才能跑得动你的项目。
「减少命令执行差异」是核心目标:让「Claude 执行命令的环境」和「你手动执行的环境」尽量一致,它就不会跑出你意想不到的结果。
一个实用的做法:把开发环境「固化」下来——用容器、用固定的配置、用明确的文档。环境越确定,Claude 越可靠。
常见误区:很多新手会把这一篇讲的「基本规则」当成「教条」——什么都严格遵守。其实这些规则的核心是「降低风险、提高效率」,理解了动机,规则就自然内化了,不用死记硬背。
动手试一下:你可以花 5 分钟做一个最小验证——找一个真实的代码任务,让 Codex 跑一遍,看它的行为是不是和这一篇描述的一致。理论与实践对照,才知道「懂」和「会用」是两件事。
延伸阅读:学完这一篇,你可以看本组里的下一篇,把相邻的概念连起来读;也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的,多跳几篇会理解更深。
判断决策树:用三个问题判断该不该用——① 这件事值不值得用 Codex 做?② 用的话该用哪个入口?③ 风险高不高需不需要审批?三个问题的答案一出来,怎么做就清楚了。