Claude Code 安装指南环境信息- 系统: Linux- VS Code: 1.110.1- 最后更新: 2026-03-16一、前置条件检查1. 检查 nvm 是否已安装nvm --version如果已安装会显示版本号如 0.40.4。2. 检查当前 Node.js 版本node --version npm --versionClaude Code 需要较新的 Node.js 版本推荐 18 或 LTS 版本。二、安装 Node.js使用 nvm方法一直接安装 LTS 版本nvm install --lts方法二如果遇到网络问题使用国内镜像# 设置中科大镜像源 export NVM_NODEJS_ORG_MIRRORhttps://mirrors.ustc.edu.cn/node/ # 然后安装 LTS 版本 nvm install --lts验证 Node.js 安装node -v # 应该显示较新版本如 v18.x.x 或 v20.x.x三、安装 Claude CLI 工具# 使用 npm 全局安装 Claude CLI npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com验证安装claude --version四、安装 VS Code Claude 扩展# 安装 Claude for VS Code 扩展 code --install-extension saoudrizwan.claude-dev # 验证扩展安装 code --list-extensions | grep -i claude # 应显示: saoudrizwan.claude-dev # 如果需要重新安装扩展 code --uninstall-extension saoudrizwan.claude-dev code --install-extension saoudrizwan.claude-dev五、配置 Claude### 方法一首次运行引导 claude 首次运行时会引导你登录/配置 API 密钥。 ### 方法二手动配置推荐用于自定义 API 配置文件位于 ~/.claude.json可以手动编辑配置自定义 API 端点。 vim ~/.claude.json 配置示例 json { env: { ANTHROPIC_DEFAULT_HAIKU_MODEL: DeepSeek-R1, ANTHROPIC_DEFAULT_SONNET_MODEL: GLM-5, ANTHROPIC_DEFAULT_OPUS_MODEL: GLM-5, ANTHROPIC_AUTH_TOKEN: your-api-key, ANTHROPIC_BASE_URL: https://your-api-endpoint.com, API_TIMEOUT_MS: 3000000, claudeCode.disableLoginPrompt: true, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1 } } ### 配置项说明 | 配置项 | 说明 | |--------|------| | ANTHROPIC_AUTH_TOKEN | API 密钥 | | ANTHROPIC_BASE_URL | 自定义 API 端点用于非官方 API | | ANTHROPIC_DEFAULT_HAIKU_MODEL | 默认 Haiku 模型名称 | | ANTHROPIC_DEFAULT_SONNET_MODEL | 默认 Sonnet 模型名称 | | ANTHROPIC_DEFAULT_OPUS_MODEL | 默认 Opus 模型名称 | | API_TIMEOUT_MS | API 请求超时时间毫秒 | | claudeCode.disableLoginPrompt | 禁用登录提示 | | CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 禁用非必要网络请求 | ### VS Code 中配置 1. 打开 VS Code 2. 按 CtrlShiftP 打开命令面板 3. 搜索 Claude 相关命令进行配置六、常见问题1. nvm 安装 Node.js 网络超时**原因**: 国内访问 nodejs.org 较慢**解决方案**: 使用国内镜像bashexport NVM_NODEJS_ORG_MIRRORhttps://mirrors.ustc.edu.cn/node/nvm install --lts2. Node.js 版本过低**症状**: Claude 无法启动或报错**解决方案**:bash# 安装并切换到新版本nvm install --ltsnvm use 新版本号nvm alias default 新版本号 # 设置为默认版本3. VS Code 扩展问题bash# 查看已安装的扩展code --list-extensions | grep -i claude# 重新安装code --uninstall-extension saoudrizwan.claude-devcode --install-extension saoudrizwan.claude-dev## 七、快速安装脚本将以下内容保存为 install_claude.sh 并执行bash #!/bin/bash echo Claude Code 安装脚本 # 检查 nvm if ! command -v nvm /dev/null; then echo 错误: 请先安装 nvm echo 参考: https://github.com/nvm-sh/nvm exit 1 fi # 设置镜像源国内用户 export NVM_NODEJS_ORG_MIRRORhttps://mirrors.ustc.edu.cn/node/ # 安装 Node.js LTS echo 正在安装 Node.js LTS... nvm install --lts # 验证 Node.js echo Node.js 版本: $(node -v) echo npm 版本: $(npm -v) # 安装 Claude CLI echo 正在安装 Claude CLI... npm install -g anthropic-ai/claude-code # 安装 VS Code 扩展 echo 正在安装 VS Code Claude 扩展... code --install-extension saoudrizwan.claude-dev echo 安装完成 echo 请运行 claude 开始使用 参考链接- [Claude Code 官方文档](https://docs.anthropic.com/claude-code)- [nvm GitHub](https://github.com/nvm-sh/nvm)- [Node.js 官网](https://nodejs.org/)