通俗版 Claude Code 文档

结构照原 docs,内容改成真能照着做的人话版。

查看原始文档 目录顺序与官方保持一致

部署

开发容器

开发容器 这一页讲的,就是 开发容器 这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

开发容器

页面性质

第三方中文解释页

使用建议

先看人话解释,再对照原页命令和代码

这页不是官方原文,而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留,解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异,最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

开发容器页讲的是怎样在容器化开发环境里跑 Claude Code。

目标是让每个人的环境更一致。

“在我机器上能跑”最烦人。容器化就是把环境也打包,谁来都尽量一个样。

Claude Code 跑在这种环境里,排错会少很多。

适合多人协作、环境依赖复杂、上手门槛高的项目。

要先把容器里需要的命令、工具链和权限准备好,不然 Claude 进去也施展不开。

预留广告位

正文中段响应式广告 等你后面真接 AdSense,这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Add Claude Code to your dev container

这里不是让你背"Add Claude Code to your dev container"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

改配置

Add Claude Code to your dev container

光知道意思还不够,这里得把规矩落进配置里,下面这块照着填。

{
  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
  "features": {
    "ghcr.io/anthropics/devcontainer-features/claude-code:1.0": {}
  }
}

Persist authentication and settings across rebuilds

看到这里,就把"Persist authentication and settings across rebuilds"当成一件真要上手的活来看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

关键片段

Persist authentication and settings across rebuilds

先看下面这块原始片段,等会儿再回头看解释会顺得多。

"mounts": [
  "source=claude-code-config,target=/home/node/.claude,type=volume"
]

Enforce organization policy

看到这里,就把"Enforce organization policy"当成一件真要上手的活来看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

改配置

Enforce organization policy 1

这一段说完,最后还得写到配置里才算真的生效。

RUN mkdir -p /etc/claude-code
COPY managed-settings.json /etc/claude-code/managed-settings.json
关键片段

Enforce organization policy 2

先看下面这块原始片段,等会儿再回头看解释会顺得多。

"containerEnv": {
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
  "DISABLE_AUTOUPDATER": "1"
}

Restrict network egress

看到这里,就把"Restrict network egress"当成一件真要上手的活来看。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Run without permission prompts

看到这里,就把"Run without permission prompts"当成一件真要上手的活来看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Try the reference container

这一段就是给你查规矩的,像看说明书那样一项项对着来。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Next steps

这里不是让你背"Next steps"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

照着做一遍

这页属于“开发容器”这类活,最稳的办法还是一小步一小步来。

下面这三步不一定华丽,但通常最不容易绕晕。

第 1 步:先起步

适合多人协作、环境依赖复杂、上手门槛高的项目。

第 2 步:边做边看

要先把容器里需要的命令、工具链和权限准备好,不然 Claude 进去也施展不开。

一眼看懂这一页

这页的作用,就是把原本偏专业的话题,拆成能直接照着走的明白话。

开发容器
   |
   v
开发容器 这一页讲的,就是 开发容器 这件事在 Claude Code 里到底怎么用。
   |
   v
照着步骤去做

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成,原站加页、删页、改页时,这里会跟着更新。

人话解释会尽量顺着原页往下讲,但命令、参数名、配置名这些硬东西还是保留原样,免得你抄过去跑不起来。