通俗版 Claude Code 文档

结构照原 docs，内容改成真能照着做的人话版。
查看原始文档 目录顺序与官方保持一致

Setup and access

管理员设置

管理员设置 这一页讲的，就是 管理员设置 这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

管理员设置

页面性质

第三方中文解释页

使用建议

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

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

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

这一页先讲明白

管理员设置页主要给团队管理员看，不是普通个人用户的第一站。

它讲的是怎么立规则、配权限、管入口。

像村里管仓库钥匙的人，先得定清楚谁能进、谁能改、谁只能看。

管理员层面的配置决定团队用起来是乱还是稳。

先把账户、权限、默认规则和安全边界定下来，再让团队大规模开用。

越早把管理员规则讲清楚，后面越少补锅。

预留广告位

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

Documentation Index

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

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

System requirements

这一块主要是在说"System requirements"真到手上该怎么用，哪里最容易踩坑。

Additional dependencies

这一段主要是在把"Additional dependencies"讲实，不是只摆个标题给你看。

Install Claude Code

这段就是手把手操作，照顺序来最稳。

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

终端里敲

Install Claude Code 1

先别急着往下翻，下面这条命令跑完，心里才有底。

curl -fsSL https://claude.ai/install.sh | bash
终端里敲

Install Claude Code 2

先别急着往下翻，下面这条命令跑完，心里才有底。

irm https://claude.ai/install.ps1 | iex
终端里敲

Install Claude Code 3

先别急着往下翻，下面这条命令跑完，心里才有底。

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
终端里敲

Install Claude Code 4

先别急着往下翻，下面这条命令跑完，心里才有底。

brew install --cask claude-code
终端里敲

Install Claude Code 5

先别急着往下翻，下面这条命令跑完，心里才有底。

winget install Anthropic.ClaudeCode

Set up on Windows

看到这里，就当是在做开工前那套准备。

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

改配置

Set up on Windows

想把这条规矩固定住，就把下面这块老老实实写进去。

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Alpine Linux and musl-based distributions

这段看着像个标题，其实是在说"Alpine Linux and musl-based distributions"管到哪儿。

如果你看到环境变量或 settings.json，意思通常都是：这不是会话里临时喊一声就行，而是要把开关真正写进环境或配置。

终端里敲

Alpine Linux and musl-based distributions 1

先别急着往下翻，下面这条命令跑完，心里才有底。

apk add libgcc libstdc++ ripgrep
改配置

Alpine Linux and musl-based distributions 2

这会儿轮到改配置了，字段名和关键字别自己乱换。

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

Verify your installation

这里不只是看看热闹，是要确认它真活了。

终端里敲

Verify your installation 1

真到动手的时候了，下面这条直接敲一遍，看它回什么。

claude --version
终端里敲

Verify your installation 2

真到动手的时候了，下面这条直接敲一遍，看它回什么。

claude doctor

Authenticate

看到这里，就把"Authenticate"当成一件真要上手的活来看。

Update Claude Code

看到这儿别跳步，按它给的顺序往下走。

Auto-updates

这一段主要是在把"Auto-updates"讲实，不是只摆个标题给你看。

如果你看到环境变量或 settings.json，意思通常都是：这不是会话里临时喊一声就行，而是要把开关真正写进环境或配置。

Configure release channel

看到这类标题，就当是在调一个具体开关。

如果你看到环境变量或 settings.json，意思通常都是：这不是会话里临时喊一声就行，而是要把开关真正写进环境或配置。

改配置

Configure release channel

这会儿轮到改配置了，字段名和关键字别自己乱换。

{
  "autoUpdatesChannel": "stable"
}

Pin a minimum version

这里主要是在交代"Pin a minimum version"这一块会碰到哪些事。

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

改配置

Pin a minimum version

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

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

Disable auto-updates

看到这类标题，就当是在调一个具体开关。

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

改配置

Disable auto-updates

这会儿轮到改配置了，字段名和关键字别自己乱换。

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Update manually

这里属于实操步骤，重点是照着顺序做，不要自己脑补省略中间步骤。

终端里敲

Update manually

真到动手的时候了，下面这条直接敲一遍，看它回什么。

claude update

Advanced installation options

这一段主要是在把"Advanced installation options"讲实，不是只摆个标题给你看。

Install a specific version

看到这儿别跳步，按它给的顺序往下走。

终端里敲

Install a specific version 1

先别急着往下翻，下面这条命令跑完，心里才有底。

curl -fsSL https://claude.ai/install.sh | bash
终端里敲

Install a specific version 2

先别急着往下翻，下面这条命令跑完，心里才有底。

irm https://claude.ai/install.ps1 | iex
终端里敲

Install a specific version 3

先别急着往下翻，下面这条命令跑完，心里才有底。

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
终端里敲

Install a specific version 4

先别急着往下翻，下面这条命令跑完，心里才有底。

curl -fsSL https://claude.ai/install.sh | bash -s stable
关键片段

Install a specific version 5

这一段要真抓重点，通常就抓下面这块原文。

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
终端里敲

Install a specific version 6

先别急着往下翻，下面这条命令跑完，心里才有底。

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd

Install with Linux package managers

这段就是手把手操作，照顺序来最稳。

终端里敲

Install with Linux package managers 1

看到这里，别光点头，下面这条命令先跑起来再说。

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code
终端里敲

Install with Linux package managers 2

看到这里，别光点头，下面这条命令先跑起来再说。

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code
终端里敲

Install with Linux package managers 3

看到这里，别光点头，下面这条命令先跑起来再说。

wget -O /etc/apk/keys/claude-code.rsa.pub \
  https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

Install with npm

看到这儿别跳步，按它给的顺序往下走。

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

终端里敲

Install with npm

真到动手的时候了，下面这条直接敲一遍，看它回什么。

npm install -g @anthropic-ai/claude-code

Binary integrity and code signing

这一块主要是在说"Binary integrity and code signing"真到手上该怎么用，哪里最容易踩坑。

终端里敲

Binary integrity and code signing 1

看到这里，别光点头，下面这条命令先跑起来再说。

curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import
改配置

Binary integrity and code signing 2

想把这条规矩固定住，就把下面这块老老实实写进去。

REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"
改配置

Binary integrity and code signing 3

想把这条规矩固定住，就把下面这块老老实实写进去。

gpg --verify manifest.json.sig manifest.json
终端里敲

Binary integrity and code signing 4

看到这里，别光点头，下面这条命令先跑起来再说。

sha256sum claude

Uninstall Claude Code

这里属于实操步骤，重点是照着顺序做，不要自己脑补省略中间步骤。

Native installation

这一块主要是在说"Native installation"真到手上该怎么用，哪里最容易踩坑。

终端里敲

Native installation 1

看到这里，别光点头，下面这条命令先跑起来再说。

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
终端里敲

Native installation 2

看到这里，别光点头，下面这条命令先跑起来再说。

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Homebrew installation

看到这里，就把"Homebrew installation"当成一件真要上手的活来看。

终端里敲

Homebrew installation 1

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

brew uninstall --cask claude-code
终端里敲

Homebrew installation 2

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

brew uninstall --cask claude-code@latest

WinGet installation

这一段主要是在把"WinGet installation"讲实，不是只摆个标题给你看。

终端里敲

WinGet installation

先别急着往下翻，下面这条命令跑完，心里才有底。

winget uninstall Anthropic.ClaudeCode

apt / dnf / apk

看到这里，就把"apt / dnf / apk"当成一件真要上手的活来看。

终端里敲

apt / dnf / apk 1

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc
终端里敲

apt / dnf / apk 2

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo
终端里敲

apt / dnf / apk 3

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub

npm

看到这里，就把"npm"当成一件真要上手的活来看。

终端里敲

npm

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

npm uninstall -g @anthropic-ai/claude-code

Remove configuration files

这一块主要是在说"Remove configuration files"真到手上该怎么用，哪里最容易踩坑。

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

改配置

Remove configuration files 1

想把这条规矩固定住，就把下面这块老老实实写进去。

# Remove user settings and state
rm -rf ~/.claude
rm ~/.claude.json

# Remove project-specific settings (run from your project directory)
rm -rf .claude
rm -f .mcp.json
改配置

Remove configuration files 2

想把这条规矩固定住，就把下面这块老老实实写进去。

# Remove user settings and state
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# Remove project-specific settings (run from your project directory)
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force

照着做一遍

如果你现在的目标只是把 Claude Code 安装跑通，不必先钻管理员规则。

最实用的路线就是：安装 -> 验证 -> 登录 -> 再决定要不要碰更细设置。

终端里敲

第 1 步：先安装

按你的系统挑一条安装命令。能简单装通，就别先绕远路。

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
终端里敲

第 2 步：先验版本和体检

先别猜安装好了没有，直接让它自己报版本、跑体检。

claude --version
claude doctor
终端里敲

第 3 步：再启动登录

只有认完主，后面很多命令和会话能力才真正能用。

claude
改配置

第 4 步：有特殊环境再补配置

像 Windows Git Bash、Alpine、自动更新通道这些，都属于后补项，不要一开始就把自己绕晕。

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

一眼看懂这一页

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

管理员设置
   |
   v
管理员设置 这一页讲的，就是 管理员设置 这件事在 Claude Code 里到底怎么用。
   |
   v
照着步骤去做

文末提醒

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

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

顺手再看

第一天上手清单

适合刚装好还不知道先做哪三步的人。

安装对照版

把 Windows、macOS、Linux 的常见差别放到一页里看。

常见报错排查清单

装完跑不起来时，先按这页的顺序排。

预留广告位

文末横幅广告 适合放在文章读完以后，不抢首屏注意力。