1  环境搭建

本章介绍如何安装 Claude Code 的核心环境：Git、VS Code 和 Claude Code 插件。完成这三步即可开始使用，适用于 Windows、macOS 和 Linux。

注释

本章以 VS Code 插件方式为主，这是大多数用户的推荐路径。第6步安装的 Miniconda 将在后续章节中用于安装 R、Pandoc 等工具。如需在终端中使用 Claude Code，请参阅 章节 8.5。

1.1 第1步：安装 Git

Git 是版本控制工具，Claude Code 在协作过程中会频繁使用。

从 git-scm.com 下载安装包。安装时注意：

  • 勾选 “Add Git to PATH”
  • 默认编辑器可选择 VS Code
  • 其余保持默认即可

通过 Homebrew 安装（推荐）。首先安装 Homebrew（如果已安装可跳过）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

然后安装 Git：

brew install git
sudo apt update && sudo apt install -y git

安装完成后，打开终端验证：

git --version
如果 git –version 提示”无法识别的命令”（Windows）

这通常是因为 Git 已安装但系统找不到它的位置。

打开 PowerShell，粘贴以下命令并回车：

$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
  1. 按 Win + S 搜索”编辑系统环境变量”，打开”系统属性”→“高级”→“环境变量”
  2. 在”系统变量”中找到 Path，双击打开
  3. 点击”新建”，输入 C:\Program Files\Git\cmd
  4. 点击”确定”保存所有对话框
  5. 关闭并重新打开 PowerShell，再次运行 git --version
提示

Git 安装包较大，下载可能需要几分钟。可以先启动下载，同时进行下一步。

1.2 第2步：安装 VS Code

从 code.visualstudio.com 下载安装包。安装时务必勾选：

  • “添加到 PATH”
  • “添加到右键菜单”（将”通过 Code 打开”添加到文件和目录的上下文菜单）

从 code.visualstudio.com 下载 .dmg 安装，或通过 Homebrew：

brew install --cask visual-studio-code

从 code.visualstudio.com 下载 .deb / .rpm，或通过 Snap：

sudo snap install code --classic

1.3 第3步：安装 Claude Code 插件

打开 VS Code，按 Ctrl + Shift + X（macOS：Cmd + Shift + X）打开扩展面板，搜索并安装：

  1. Claude Code — Anthropic 官方插件，在 VS Code 中集成 Claude Code 面板
  2. Office Viewer — 在 VS Code 中预览 PDF、Word、Excel 等文件
提示

Office Viewer 安装后可能会弹出一个新的主题配色方案。如果你想切换回原来的主题或选择其他配色，可以按 Ctrl + Shift + P（macOS：Cmd + Shift + P）打开命令面板，搜索 “Color”，然后选择你喜欢的主题即可。

1.4 第4步：配置 AI 编程助手权限

以下是各平台的推荐安全配置模板。

配置文件路径：C:\Users\你的用户名\.claude\settings.json

{
  "permissions": {
    "allow": [
      "Bash",
      "Read",
      "Edit",
      "Write",
      "Grep",
      "Glob",
      "WebSearch",
      "WebFetch(domain:raw.githubusercontent.com)",
      "WebFetch(domain:github.com)"
    ],
    "deny": [
      "Read(~/.ssh/**)",
      "Read(~/.aws/**)",
      "Read(~/.gnupg/**)",
      "Read(~/.claude/.credentials.json)",
      "Read(**/.env)",
      "Read(**/.env.*)",
      "Edit(~/.ssh/**)",
      "Edit(~/.aws/**)",
      "Edit(~/.gnupg/**)",
      "Write(~/.ssh/**)",
      "Write(~/.aws/**)",
      "Write(~/.gnupg/**)",
      "Bash(rm -rf /*)",
      "Bash(rm -rf ~*)",
      "Bash(rm -rf /home*)",
      "Bash(sudo rm*)"
    ],
    "defaultMode": "acceptEdits"
  }
}

配置文件路径：~/.claude/settings.json

{
  "permissions": {
    "allow": [
      "Bash",
      "Read",
      "Edit",
      "Write",
      "Grep",
      "Glob",
      "WebSearch",
      "WebFetch(domain:raw.githubusercontent.com)",
      "WebFetch(domain:github.com)"
    ],
    "deny": [
      "Read(~/.ssh/**)",
      "Read(~/.aws/**)",
      "Read(~/.gnupg/**)",
      "Read(~/.claude/.credentials.json)",
      "Read(**/.env)",
      "Read(**/.env.*)",
      "Edit(~/.ssh/**)",
      "Edit(~/.aws/**)",
      "Edit(~/.gnupg/**)",
      "Write(~/.ssh/**)",
      "Write(~/.aws/**)",
      "Write(~/.gnupg/**)",
      "Read(~/Library/Keychains/**)",
      "Edit(~/Library/Keychains/**)",
      "Write(~/Library/Keychains/**)",
      "Bash(rm -rf /*)",
      "Bash(rm -rf ~*)",
      "Bash(sudo rm*)"
    ],
    "defaultMode": "acceptEdits"
  }
}

与 Windows 相比，macOS 版额外保护了 ~/Library/Keychains/（系统钥匙串，存放密码和证书）。

配置文件路径：C:\Users\你的用户名\.codex\config.toml

approval_policy = "auto-edit"
sandbox_mode = "workspace-write"

配置说明：

配置项 值 说明
approval_policy auto-edit 自动应用文件编辑，运行命令前仍需确认
sandbox_mode workspace-write 仅允许读写当前工作目录

配置文件路径：~/.codex/config.toml

approval_policy = "auto-edit"
sandbox_mode = "workspace-write"

配置内容与 Windows 完全相同，路径使用 Unix 风格。

重要

Claude Code：deny 列表保护你的敏感文件不被读取或修改。建议至少保留 SSH 密钥和凭证文件的保护。

Codex：approval_policy = "auto-edit" 对应 Claude Code 的 acceptEdits——自动应用文件编辑，但运行 shell 命令前仍需确认。如需更严格的控制，可改为 "suggest"（所有操作均需确认）。

1.5 第5步：用 Claude Code 完成配置

安装好 Claude Code 后，可以直接用自然语言让它帮你完成后续配置。打开 VS Code 中的 Claude Code 面板，依次发送以下 prompt。

1.5.1 安装推荐 Skills

Skills 是 Claude Code 的能力扩展包，安装后可直接处理文档格式、编码工作流等任务。推荐的 Skills 及安装方法见 章节 4.2.1。

1.5.2 配置 Stata 环境变量

如果你使用 Stata，发送以下 prompt，Claude Code 会自动找到安装路径并写入环境变量：

帮我找到这台电脑里 Stata 安装在什么位置，然后把它添加到系统环境变量，确保终端可以自动识别到 Stata。

完成后重新打开终端，输入 stata 验证是否生效。

1.6 第6步：安装 Miniconda

Miniconda 是轻量级的 Python 和包管理工具。后续章节将使用 conda 安装 R、Pandoc、Typst、Quarto 等科研工具。

从 docs.anaconda.com/miniconda 下载 Windows 安装包，运行安装程序。安装时注意：

  • 勾选 “Add Miniconda to my PATH environment variable”
  • 安装完成后重启 PowerShell
brew install --cask miniconda
conda init zsh   # 如使用 bash 则改为 conda init bash
source ~/.zshrc
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda.sh
bash ~/miniconda.sh -b -p $HOME/miniconda
eval "$($HOME/miniconda/bin/conda shell.bash hook)"
conda init bash
source ~/.bashrc

安装完成后，验证：

conda --version
注释

后续章节将使用 conda install -c conda-forge 安装 R、Pandoc、Typst、Quarto 等工具。如需在终端中使用 Claude Code（而非 VS Code 插件），请参阅 章节 8.5。