Claude Code 安装与配置完全指南

文章主旨：

本文是一份关于 Anthropic 推出的 AI 编程助手 Claude Code 的安装与配置教程，重点针对 Mac/Windows/Linux 不同平台及国内/国外网络环境给出详细操作步骤与最佳实践，旨在帮助开发者快速上手并在项目中高效使用该工具。

关键要点：

• Claude Code 是终端 AI 编程助手，支持代码理解、生成、Bug 修复、自动脚本、项目分析、Git 集成等核心功能，需 Node.js 18+ 和 Git 环境。
• 安装方式分国内版（npm + 淘宝镜像 + API Key）与外网版（原生安装 / npm / WinGet + OAuth 或 API Key），国内用户推荐使用 API Key 方式和 ~/.claude/settings.json 配置国产模型。
• 项目配置文件体系：CLAUDE.md 为行为准则（用户级/项目级可继承覆盖），.env 存储密钥需用 permissions.deny 保护，settings.json 分项目级（共享）和本地级（私有），优先级从高到低为 Managed 设置 > 命令行 > Local > Project > User。
• 插件体系用于扩展 Skills、Agents、Hooks 和 MCP 服务器，可在用户级或项目级 settings.json 中启用，通过 /plugin 命令管理。
• 快速上手清单：安装 Node.js/Git → 设置 npm 镜像 → 安装 Claude Code → 验证 → 获取 API Key（或登录）→ 配置 CLAUDE.md → 进入项目目录运行 claude。

内容结构：

1. 一、概述：介绍 Claude Code 定义、核心功能表（代码理解、生成、Bug 修复、自动脚本、项目分析、Git 集成）及系统要求（OS、RAM、Node.js、Git、网络）。

2. 二、安装前置软件：

   • 2.1 安装 Node.js：Windows（官网下载 .msi / winget），macOS（Homebrew / nvm），Linux（nvm / apt）。
   • 2.2 安装 Git：Windows（winget / 官网安装向导），macOS（brew / xcode-select），Linux（apt）。
   • 2.3 安装 VS Code（推荐非必须，每个平台对应命令）。

3. 三、Claude Code 安装：分国内版（npm + 淘宝镜像 / winget）和外网版（原生安装 / npm），身份验证（国内推荐 API Key 配置 settings.json，外网可用 claude login OAuth 或 API Key）。详细给出 settings.json 示例（以智谱 GLM 为例）以及跳过引导界面的 .claude.json 配置。

4. 四、项目目录与关键文件详解：

   • 目录结构列表（CLAUDE.md、.env、.gitignore、.claudeignore、.claude/ 下的 settings、skills、agents、commands，以及 .mcp.json 和全局目录 ~/.claude/）。
   • 4.1 CLAUDE.md：作用为行为准则，用户级和项目级层级覆盖，给出完整示例（语言风格、核心铁律、代码风格、禁止操作）。
   • 4.2 .env：密钥存储，需用 permissions.deny 保护。
   • 4.3 .gitignore：推荐忽略本地配置、密钥，保留共享设置。
   • 4.4 settings.json（项目级）：团队共享，定义权限、hooks、插件。
   • 4.5 settings.local.json：个人本地，不提交，覆盖项目级。
   • 4.6 用户级 settings.json：全局个人设置，优先级最低。
   • 说明设置优先级层级从高到低：Managed > 命令行参数 > Local > Project > User，并指出 permissions 数组跨作用域合并去重。

5. 五、插件与权限：插件体系涉及用户级（全局生效）和项目级（团队共享），给出在 settings.json 中启用插件的示例。

6. 六、常见问题排查：列出 claude: command not found、login failed、npm 安装慢、权限错误 EACCES、CC-Switch 环境变量冲突的解决方法。

7. 七、快速上手清单：分别给出国内版和外网版的步骤清单（已去除广告部分的 CC-Switch 和插件推荐）。

文章总结：

本文以技术文档风格，详尽覆盖了 Claude Code 的获取、安装、配置与使用要点，适合开发者按步骤部署，并针对国内网络环境给出了成熟的替代方案，强调通过 CLAUDE.md 和权限控制提升 AI 辅助效率与安全性。

自我管理型团队：企业组织力提升利器

了解更多

产品经理方法论

查看原文：Claude Code 安装与配置完全指南

文章来源：

产品经理方法论

扫码关注公众号