创建日期2026-03-13 目标在服务器/局域网环境下配置代理安装 Node.js并配置 Claude Code目录局域网代理配置Node.js 安装Claude Code 配置常见问题1. 局域网代理配置当你在服务器或局域网环境下需要访问外网资源时可以通过以下方式配置代理。1.1 单次命令使用代理curl/wget在执行curl命令时通过-x参数指定代理# 使用 curl 时指定代理curl-xhttp://172.17.0.1:7897 https://example.com# 或者使用 --proxy 参数curl--proxyhttp://172.17.0.1:7897 https://example.com示意图┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ 服务器 │ ───────▶│ 代理机器 │ ───────▶│ 外网资源 │ │172.18.0.x │ │172.18.0.1 │ │ (GitHub等) │ └─────────────┘ │ :7897 │ └─────────────┘ └─────────────┘1.2 当前终端会话设置代理在当前终端会话中设置环境变量所有 HTTP/HTTPS 请求都会通过代理# 设置 HTTP 代理exporthttp_proxyhttp://172.17.0.1:7897# 设置 HTTPS 代理exporthttps_proxyhttp://172.17.0.1:7897# 同时设置推荐exporthttp_proxyhttp://172.17.0.1:7897exporthttps_proxyhttp://172.17.0.1:7897验证代理是否生效# 测试代理是否工作curl-Ihttps://www.google.com# 或者查看环境变量echo$http_proxyecho$https_proxy1.3 取消代理设置# 取消当前会话的代理unsethttp_proxyunsethttps_proxy# 或者设置为空exporthttp_proxyexporthttps_proxy1.4 永久配置代理写入配置文件如果你希望每次打开终端都自动设置代理可以添加到 shell 配置文件# 编辑 ~/.bashrc 或 ~/.zshrcechoexport http_proxyhttp://172.17.0.1:7897~/.bashrcechoexport https_proxyhttp://172.17.0.1:7897~/.bashrc# 使配置生效source~/.bashrc1.5 Git 配置代理如果需要通过 Git 克隆仓库# 配置 Git 使用代理gitconfig--globalhttp.proxy http://172.17.0.1:7897gitconfig--globalhttps.proxy http://172.17.0.1:7897# 取消 Git 代理gitconfig--global--unsethttp.proxygitconfig--global--unsethttps.proxy1.6 npm 配置代理# 配置 npm 代理npmconfigsetproxy http://172.17.0.1:7897npmconfigsethttps-proxy http://172.17.0.1:7897# 取消 npm 代理npmconfig delete proxynpmconfig delete https-proxy2. Node.js 安装Claude Code 需要Node.js 18 或更新版本。2.1 官方下载页面访问 Node.js 官方下载页面https://nodejs.org/en/download/2.2 Linux 服务器安装方式方式一使用 nvm推荐nvm(Node Version Manager) 是最推荐的 Node.js 版本管理工具方便切换不同版本。# 1. 安装 nvm如果网络不通先设置代理curl-o--xhttp://172.17.0.1:7897 https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh|bash# 2. 使 nvm 生效source~/.bashrc# 3. 安装最新 LTS 版本的 Node.jsnvminstall--lts# 4. 设置默认版本nvm use--ltsnvmaliasdefaultnode# 5. 验证安装node--versionnpm--version方式二使用包管理器Ubuntu/Debian:# 使用 NodeSource 仓库curl-fsSL-xhttp://172.17.0.1:7897 https://deb.nodesource.com/setup_lts.x|sudo-Ebash-sudoapt-getinstall-ynodejs# 验证node--versionnpm--versionCentOS/RHEL/Fedora:# 使用 NodeSource 仓库curl-fsSL-xhttp://172.17.0.1:7897 https://rpm.nodesource.com/setup_lts.x|sudobash-sudoyuminstall-ynodejs# 验证node--versionnpm--version方式三使用二进制包# 1. 下载二进制包以 Linux x64 为例curl-O-xhttp://172.17.0.1:7897 https://nodejs.org/dist/v22.12.0/node-v22.12.0-linux-x64.tar.xz# 2. 解压tar-xfnode-v22.12.0-linux-x64.tar.xz# 3. 移动到 /usr/localsudomvnode-v22.12.0-linux-x64 /usr/local/nodejs# 4. 创建软链接sudoln-s/usr/local/nodejs/bin/node /usr/local/bin/nodesudoln-s/usr/local/nodejs/bin/npm /usr/local/bin/npm# 5. 验证node--versionnpm--version2.3 验证 Node.js 安装# 查看版本需要 18node--version# 查看 npm 版本npm--version预期输出示例v22.12.0 10.9.03. Claude Code 配置Claude Code 是一个智能编码工具可以在终端中运行通过自然语言命令交互帮助开发者快速完成代码生成、调试、重构等任务。搭配GLM Coding PlanClaude Code 的能力能进一步增强 —— 以更低价格获得3 倍用量。3.1 步骤一安装 Claude Code前提条件✅ 已安装 Node.js 18 或更新版本✅ Windows 用户已安装 Git for Windows安装命令# 全局安装 Claude Codenpminstall-ganthropic-ai/claude-code# 验证安装claude--version3.2 步骤二获取智谱 API Key访问 智谱开放平台点击右上角「注册/登录」进入 API Keys 页面创建新的 API Key 并保存⚠️注意请妥善保管 API Key不要泄露或硬编码在代码中。3.3 步骤三配置 GLM Coding Plan方式一自动化助手推荐Coding Tool Helper 可以自动完成配置# 运行自动化助手npx z_ai/coding-helper按照界面提示操作即可自动完成工具安装套餐配置MCP 服务器管理方式二自动化脚本MacOS Linux# 下载并运行配置脚本curl-Ohttps://cdn.bigmodel.cn/install/claude_code_env.shbash./claude_code_env.sh脚本会自动配置~/.claude/settings.json- 环境变量配置~/.claude.json- 引导完成标记方式三手动配置MacOS Linux:编辑~/.claude/settings.json{env:{ANTHROPIC_AUTH_TOKEN:your_zhipu_api_key,ANTHROPIC_BASE_URL:https://open.bigmodel.cn/api/anthropic,API_TIMEOUT_MS:3000000,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1}}编辑~/.claude.json{hasCompletedOnboarding:true}Windows:编辑用户目录/.claude/settings.json和用户目录/.claude.json同上3.4 模型配置说明Claude Code 内部模型环境变量与 GLM 模型对应关系默认配置环境变量默认 GLM 模型ANTHROPIC_DEFAULT_OPUS_MODELGLM-4.7ANTHROPIC_DEFAULT_SONNET_MODELGLM-4.7ANTHROPIC_DEFAULT_HAIKU_MODELGLM-4.5-Air如需使用 GLM-5在~/.claude/settings.json中添加{env:{ANTHROPIC_AUTH_TOKEN:your_zhipu_api_key,ANTHROPIC_BASE_URL:https://open.bigmodel.cn/api/anthropic,API_TIMEOUT_MS:3000000,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1,ANTHROPIC_DEFAULT_HAIKU_MODEL:glm-4.5-air,ANTHROPIC_DEFAULT_SONNET_MODEL:glm-4.7,ANTHROPIC_DEFAULT_OPUS_MODEL:glm-5}}提示GLM-5 参数量更大对标 Claude Opus 模型调用时用量按高峰期 3 倍非高峰期 2 倍计算。建议复杂任务用 GLM-5普通任务用 GLM-4.7。3.5 步骤四开始使用 Claude Code# 1. 配置完成后重新打开终端窗口# 2. 进入你的代码工作目录cd/path/to/your/project# 3. 启动 Claude Codeclaude# 4. 首次启动会询问# - Do you want to use this API key? → 选择 Yes# - 信任 Claude Code 访问文件夹 → 选择 Yes完成现在可以正常使用 Claude Code 进行开发了。4. 常见问题4.1 如何切换使用模型修改~/.claude/settings.json中的环境变量{env:{ANTHROPIC_AUTH_TOKEN:your_zhipu_api_key,ANTHROPIC_BASE_URL:https://open.bigmodel.cn/api/anthropic,ANTHROPIC_DEFAULT_HAIKU_MODEL:glm-4.5-air,ANTHROPIC_DEFAULT_SONNET_MODEL:glm-4.7,ANTHROPIC_DEFAULT_OPUS_MODEL:glm-5}}4.2 Claude Code v2.1.69 版本 BUG如果遇到问题设置环境变量exportENABLE_TOOL_SEARCH0exportCLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS14.3 MacOS 权限问题如果安装过程中遇到权限问题请使用 nvm 方式安装 Node.js。4.4 手工修改配置不生效确保JSON 文件格式正确注意逗号重新打开终端窗口API Key 正确无误快速参考卡代理设置速查# 当前会话设置代理exporthttp_proxyhttp://172.17.0.1:7897exporthttps_proxyhttp://172.17.0.1:7897# 单次 curl 使用代理curl-xhttp://172.17.0.1:7897 https://example.com# 取消代理unsethttp_proxy https_proxyNode.js 安装速查# 使用 nvm 安装推荐curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh|bashsource~/.bashrc nvminstall--ltsnvm use--ltsClaude Code 配置速查# 安装npminstall-ganthropic-ai/claude-code# 自动配置npx z_ai/coding-helper# 启动claude相关链接Node.js 官方下载Claude Code 配置文档智谱开放平台GLM Coding Plan文档说明本文档整理自 Node.js 官方文档和智谱 AI 开放文档用于指导在服务器/局域网环境下配置代理、安装 Node.js 和配置 Claude Code。