通俗版 Claude Code 文档

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

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

部署

网络配置

网络配置 这一页讲的,就是 网络配置 这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

网络配置

页面性质

第三方中文解释页

使用建议

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

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

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

这一页先讲明白

网络配置页主要给公司内网、代理、防火墙这类环境看。

如果你在普通家用网络里很顺,一进公司就卡,多半要看这页。

很多问题不是 Claude Code 本身坏了,而是它想出门,结果被门卫拦住了。

代理、证书、白名单、出网策略,这些都属于“门卫规则”。

先找清楚你们环境是走代理、走直连,还是只能白名单出网。

网络问题别只盯客户端,很多时候要和 IT 或平台同事一起查。

预留广告位

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

Documentation Index

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

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

Proxy configuration

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

Environment variables

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

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

关键片段

Environment variables

下面这块是这一段最值钱的原文样板,先对着看一眼。

# HTTPS proxy (recommended)
export HTTPS_PROXY=https://proxy.example.com:8080

# HTTP proxy (if HTTPS not available)
export HTTP_PROXY=http://proxy.example.com:8080

# Bypass proxy for specific requests - space-separated format
export NO_PROXY="localhost 192.168.1.1 example.com .example.com"
# Bypass proxy for specific requests - comma-separated format
export NO_PROXY="localhost,192.168.1.1,example.com,.example.com"
# Bypass proxy for all requests
export NO_PROXY="*"

Basic authentication

这一段更像在讲判断条件,什么时候该上,什么时候先别急。把触发条件看清,比背标题更重要。

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

关键片段

Basic authentication

下面这块是这一段最值钱的原文样板,先对着看一眼。

export HTTPS_PROXY=http://username:password@proxy.example.com:8080

CA certificate store

这一段主要是在把"CA certificate store"讲实,不是只摆个标题给你看。

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

关键片段

CA certificate store 1

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

export CLAUDE_CODE_CERT_STORE=bundled
关键片段

CA certificate store 2

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

export CLAUDE_CODE_CERT_STORE=system

Custom CA certificates

这一段更像在讲判断条件,什么时候该上,什么时候先别急。把触发条件看清,比背标题更重要。

关键片段

Custom CA certificates

"Custom CA certificates"这一段里最要紧的原始写法在下面,先看它怎么落地。

export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

mTLS authentication

这一段主要是在把"mTLS authentication"讲实,不是只摆个标题给你看。

关键片段

mTLS authentication

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

# Client certificate for authentication
export CLAUDE_CODE_CLIENT_CERT=/path/to/client-cert.pem

# Client private key
export CLAUDE_CODE_CLIENT_KEY=/path/to/client-key.pem

# Optional: Passphrase for encrypted private key
export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"

Network access requirements

这一段主要是在把"Network access requirements"讲实,不是只摆个标题给你看。

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

Additional resources

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

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

照着做一遍

这页属于“网络配置”这类活,最稳的办法还是一小步一小步来。

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

第 1 步:先起步

先找清楚你们环境是走代理、走直连,还是只能白名单出网。

第 2 步:边做边看

网络问题别只盯客户端,很多时候要和 IT 或平台同事一起查。

一眼看懂这一页

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

网络配置
   |
   v
网络配置 这一页讲的,就是 网络配置 这件事在 Claude Code 里到底怎么用。
   |
   v
照着步骤去做

文末提醒

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

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