Anaconda + PyCharm + Claude Code 完整安装教程（Windows / macOS）
本文涵盖 Anaconda、PyCharm Community Edition、Claude Code CLI 以及 PyCharm Claude Code 插件的完整安装与配置流程，同时收录注册报错、地区限制、环境变量等常见问题解决方案，适合 Windows 和 macOS 用户从零开始配置 Python 开发环境。
一、Windows 安装
1. 安装 Anaconda（Windows）
下载
访问 Anaconda 官网：https://www.anaconda.com/download
页面会自动识别操作系统，点击 Download 按钮下载 Windows 版安装包（.exe 文件，约 900MB）。
安装步骤
- 双击
.exe安装文件，启动安装向导 - 点击 Next
- 阅读许可协议，点击 I Agree
- 安装类型选择 Just Me（推荐），点击 Next
- 选择安装路径（建议使用默认路径，路径中避免中文和空格），点击 Next
- 高级选项页面：
- 不勾选 'Add Anaconda3 to my PATH environment variable'（避免污染系统 PATH）
- 勾选 'Register Anaconda3 as my default Python'
- 点击 Install
- 等待安装完成，点击 Next → Finish
验证安装 在开始菜单中搜索并打开 Anaconda Prompt，输入：
conda --version
输出类似 conda 24.x.x 即表示安装成功。
在 PowerShell 中启用 conda（重要）
安装时未勾选添加 PATH，因此普通 PowerShell 默认无法使用 conda 命令，需执行一次初始化：
- 打开 Anaconda Prompt，执行：
conda init powershell
- 以管理员身份打开 PowerShell，执行一次（允许脚本运行）：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
- 关闭并重新打开 PowerShell，提示符前出现
(base)即表示成功 此后在任意 PowerShell 窗口中均可直接使用conda activate <环境名>。
2. 安装 PyCharm Community Edition（Windows）
下载
访问 JetBrains 官网：https://www.jetbrains.com/pycharm/download/
选择 Community Edition（免费版），点击 Download 下载 .exe 安装包。
安装步骤
- 双击
.exe文件，启动安装向导 - 点击 Next，选择安装路径（建议保持默认），点击 Next
- 安装选项（按需勾选）：
- ✅ Create Desktop Shortcut（创建桌面快捷方式）
- ✅ Add 'Open Folder as Project'（右键菜单添加"以项目打开"）
- ✅ .py（关联
.py文件，可选）
- 点击 Next → Install
- 等待安装完成，点击 Finish
3. 配置 PyCharm 使用 Conda 环境（Windows）
- 打开 PyCharm，打开或创建项目
- 进入 File → Settings → Project: <项目名> → Python Interpreter
- 点击右上角齿轮图标 → Add Interpreter → Add Local Interpreter
- 左侧选择 Conda Environment
- 选择 Use existing environment 或 Create new environment（新建时填写名称，选择 Python 3.10+）
- Conda executable 路径若未自动识别，手动填写：
C:\Users\<用户名>\anaconda3\Scripts\conda.exe
- 点击 OK 完成配置
二、macOS 安装
1. 安装 Anaconda（macOS）
下载 访问 Anaconda 官网：https://www.anaconda.com/download 根据 Mac 芯片选择版本：
- Apple Silicon（M1/M2/M3/M4）：选择 Apple Silicon 版本（
.pkg文件） - Intel 芯片：选择 Intel 版本（
.pkg文件）
安装步骤
- 双击
.pkg文件，启动安装向导 - 依次点击 Continue → Continue → Agree
- 安装位置保持默认（仅当前用户），点击 Continue → Install
- 输入系统密码，等待安装完成，点击 Close
初始化 Shell（重要） 安装完成后打开 终端（Terminal），根据 Shell 类型执行初始化：
# macOS 默认 zsh
conda init zsh
# 若使用 bash
conda init bash
关闭终端，重新打开，提示符前出现 (base) 表示 conda 激活成功。
验证安装
conda --version
python --version
2. 安装 PyCharm Community Edition（macOS）
下载 访问：https://www.jetbrains.com/pycharm/download/ 选择 Community Edition，根据芯片下载：
- Apple Silicon：
.dmg (Apple Silicon) - Intel：
.dmg (Intel)
安装步骤
- 双击
.dmg文件，打开磁盘映像 - 将 PyCharm CE 图标拖拽到 Applications（应用程序） 文件夹
- 在启动台找到 PyCharm，双击打开
- 首次打开若提示"来自互联网的应用"，点击 打开
3. 配置 PyCharm 使用 Conda 环境（macOS）
- 打开 PyCharm，打开或创建项目
- 进入 PyCharm → Settings → Project: <项目名> → Python Interpreter
- 点击 Add Interpreter → Add Local Interpreter
- 左侧选择 Conda Environment
- Conda executable 若未自动识别，手动填写：
# Intel Mac
/Users/<用户名>/anaconda3/bin/conda
# Apple Silicon Mac
/opt/anaconda3/bin/conda
- 选择已有环境或新建环境，点击 OK
三、创建项目虚拟环境
建议为项目单独创建 conda 虚拟环境，避免依赖冲突。
方式一：通过命令行创建
# 创建名为 python_demo 的环境，指定 Python 3.10
conda create -n python_demo python=3.10
# 激活环境
conda activate python_demo
# 安装项目依赖
pip install requests jsonpath-ng
方式二：通过 PyCharm 创建
- 进入 Settings → Python Interpreter → Add Interpreter → Add Local Interpreter
- 选择 Conda Environment → Create new environment
- 填写环境名称
python_demo，Python 版本选3.10 - 点击 OK，在 PyCharm 底部 Terminal 中安装依赖：
pip install requests jsonpath-ng
提示：每次在终端中运行项目前，需先激活环境：
conda activate python_demo
四、安装 Claude Code（免费版）
Claude Code 是 Anthropic 官方出品的 AI 编程助手 CLI 工具，可在终端中与 Claude 协作完成代码编写、调试、重构等任务。
免费版说明：注册 claude.ai 免费账户即可使用，无需付费 API Key，通过浏览器 OAuth 授权登录。
前置要求：Node.js 18 或以上版本。
Windows 安装 Claude Code
第一步：安装 Node.js
- 访问 Node.js 官网：https://nodejs.org
- 点击 LTS（长期支持版） 下载
.msi安装包 - 双击安装，一路点击 Next（默认选项即可）
- 打开 PowerShell 验证：
node --version
npm --version
显示版本号（如 v20.x.x）即表示安装成功。
第二步：安装 Claude Code 以管理员身份打开 PowerShell，执行：
npm install -g @anthropic-ai/claude-code
安装完成后验证：
claude --version
若提示"无法运行脚本"（执行策略错误），以管理员身份运行 PowerShell 后执行：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned然后重新执行安装命令。
第三步：注册 claude.ai 免费账户
- 打开浏览器（推荐 Chrome 或 Edge），访问：https://claude.ai
- 点击 Sign Up，选择注册方式：
- Continue with Google：使用 Google 账号一键注册（推荐）
- Continue with Apple：使用 Apple ID 注册
- 邮箱注册：输入邮箱 → 设置密码 → 查收验证邮件 → 点击验证链接
- 填写用户名，选择用途，点击 Continue
- 完成注册后保持登录状态
注册时遇到
Failed to execute 'insertBefore' on 'Node'报错这是注册页面与浏览器扩展插件的兼容性冲突，按以下顺序尝试：使用无痕模式重试：Chrome 按
Ctrl+Shift+N打开无痕窗口，重新注册；禁用浏览器扩展：进入chrome://extensions，关闭广告拦截器、密码管理器、翻译插件等；清除缓存：按Ctrl+Shift+Delete，勾选 Cookie 和缓存后清除；换浏览器：改用 Firefox 或 Edge 尝试
注册时提示"仅在部分地区可用（Not available in your region）"
claude.ai 对 IP 地理位置有限制，中国大陆 IP 无法访问。注册全程（打开网页、填写邮箱、点击验证链接、完成设置）都必须在可用地区的 IP 下进行。
解决方案：全程开启代理工具，选择美国或欧洲节点（香港节点部分受限）。确认方式：访问 https://www.whatismyip.com，确认显示美国/欧洲 IP 后再操作。
常见失误：用手机邮件客户端点击验证链接（手机未走代理）→ 改为在电脑浏览器中打开链接；代理未开启全局模式 → 在代理工具中开启"系统代理"或"全局模式"；代理中途断开 → 点击链接前检查代理状态
第四步：登录 Claude Code 在 PowerShell 中执行：
claude
首次运行选择 Login with Claude.ai，浏览器自动打开授权页面，点击 Authorize 完成授权。
第五步：基本使用
# 进入项目目录后启动
cd C:\path\to\your\project
claude
# 查看帮助
claude --help
macOS 安装 Claude Code
第一步：安装 Node.js 推荐使用 Homebrew 安装：
# 安装 Homebrew（已安装可跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Apple Silicon 特别注意：安装 Homebrew 后需手动初始化 PATH，否则
brew命令找不到：Intel Mac 无需此步骤。
# 安装 Node.js LTS
brew install node
或直接从 https://nodejs.org 下载 LTS 版 .pkg 安装（无需手动配置 PATH）。
验证：
node --version
npm --version
第二步：安装 Claude Code
npm install -g @anthropic-ai/claude-code
若出现
EACCES权限错误，修复 npm 全局目录权限（避免使用 sudo）：
验证安装：
claude --version
第三步：注册 claude.ai 免费账户
- 打开浏览器（推荐 Chrome 或 Safari），访问：https://claude.ai
- 点击 Sign Up，选择注册方式：
- Continue with Google：使用 Google 账号一键注册（推荐）
- Continue with Apple：使用 Apple ID 注册
- 邮箱注册：输入邮箱 → 设置密码 → 查收验证邮件 → 点击验证链接
- 填写用户名，选择用途，点击 Continue
- 完成注册后保持浏览器登录状态
注册时遇到
Failed to execute 'insertBefore' on 'Node'报错使用无痕模式重试：Chrome 按
Cmd+Shift+N；Safari 选 文件 → 新建隐私窗口；禁用浏览器扩展：进入chrome://extensions，关闭广告拦截器、密码管理器等；清除缓存：按Cmd+Shift+Delete清除 Cookie 和缓存；换浏览器：改用 Firefox 尝试
注册时提示"仅在部分地区可用（Not available in your region）"
同 Windows 部分，全程开启代理工具（美国或欧洲节点），确保每一步操作时 IP 均为可用地区。
第四步：登录 Claude Code
claude
首次运行选择 Login with Claude.ai，浏览器弹出授权页面，点击 Authorize 完成授权。
第五步：基本使用
cd ~/PycharmProjects/python_demo
claude
# 查看帮助
claude --help
Claude Code 常用操作
| 操作 | 命令/方式 |
|---|---|
| 启动 | 在项目目录执行 claude |
| 退出 | 输入 /exit 或按 Ctrl+C |
| 查看快捷命令 | 输入 /help |
| 清空对话 | 输入 /clear |
| 更新版本 | npm update -g @anthropic-ai/claude-code |
免费版限制：免费账户每天有一定的使用额度。如需更多用量，可升级 claude.ai 订阅计划。
Claude Code Token 管理
登录成功后，认证信息保存在本地，无需每次重新登录：
- macOS / Linux：
~/.claude/目录 - Windows：
%USERPROFILE%\.claude\（如C:\Users\<用户名>\.claude\）
常用命令：
# 查看登录状态
claude /status
# 退出登录
claude /logout
# 重新登录（Token 过期或切换账号时）
claude /login
环境变量配置
代理配置（公司/校园网络环境）
macOS / Linux（写入 ~/.zshrc，永久生效）：
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
# 端口号替换为本地代理实际端口
Windows PowerShell（写入 profile 文件，永久生效）：
$PROFILE
# 编辑 profile
notepad $PROFILE
# 在文件中添加以下内容后保存
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:HTTP_PROXY = "http://127.0.0.1:7890"
API Key 方式（备选，付费用户）
macOS / Linux：
# 写入 ~/.zshrc
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxx"
Windows PowerShell：
$env:ANTHROPIC_API_KEY = "sk-ant-xxxxxxxxxxxxxxxx"
API Key 在 https://console.anthropic.com → API Keys 页面生成。免费版用户使用 claude.ai 登录即可，无需 API Key。
五、PyCharm 安装并使用 Claude Code 插件
前提：已完成上文 Claude Code CLI 的安装与登录。插件是 CLI 的 IDE 界面封装，依赖 CLI 运行。
安装插件
- 打开 PyCharm，进入 File → Settings（macOS：PyCharm → Settings）
- 左侧选择 Plugins → 切换到 Marketplace 标签
- 搜索框输入
Claude Code - 找到 Claude Code（发布者 Anthropic），点击 Install
- 安装完成后点击 Restart IDE
首次使用配置
若插件未自动找到 CLI 路径，进入 Settings → Tools → Claude Code，手动填写路径：
| 系统 | 路径 |
|---|---|
| macOS（Homebrew） | /usr/local/bin/claude 或 ~/.npm-global/bin/claude |
| macOS（npm 默认） | /usr/local/bin/claude |
| Windows | C:\Users\<用户名>\AppData\Roaming\npm\claude.cmd |
打开 Claude Code 面板
- 点击 PyCharm 右侧边栏的 Claude Code 图标
- 或顶部菜单 Tools → Claude Code → Open Claude Code
核心功能使用
通用对话 在面板底部输入框直接提问，Claude 结合当前项目上下文回答：
帮我解释一下这个文件的整体逻辑
这个函数有什么潜在问题？
针对选中代码提问 选中代码 → 右键 → Claude Code → Ask Claude about selection，选中内容自动作为上下文附带。
解释这段代码的作用
帮我给这个函数写一个注释
让 Claude 修改代码 在面板中描述修改需求，Claude 生成 diff 后点击 Apply 写入文件：
把这个函数的错误处理改成更健壮的方式
帮我把这个循环改为列表推导式
引用特定文件
在对话框中用 @ 引用项目文件，Claude 会读取该文件内容作为上下文：
@main.py 帮我分析这个文件有哪些可以优化的地方
让 Claude 执行终端命令
查看当前项目目录结构
帮我运行 pip install requests 并确认安装成功
常用操作汇总
| 功能 | 操作方式 |
|---|---|
| 打开/关闭面板 | 右侧边栏 Claude Code 图标 |
| 针对选中代码提问 | 选中 → 右键 → Ask Claude |
| 引用文件 | 对话框输入 @文件名 |
| 应用修改 | diff 区域点击 Apply |
| 撤销修改 | Ctrl+Z（Windows）/ Cmd+Z（macOS） |
| 清空对话 | 点击 New Conversation 或输入 /clear |
注意事项：插件复用 CLI 登录状态，无需单独登录。若提示未登录，先在终端执行
claude /login；免费版插件用量与终端共享同一每日额度；面板空白或报错时，执行 Tools → Claude Code → Restart Claude Code
六、常见问题排查
Anaconda 常见问题
Q1：PowerShell / CMD 中输入 conda，提示"不是内部或外部命令"
原因：安装时未勾选加入 PATH，且未执行 conda init。
解决：
- 打开 Anaconda Prompt，执行
conda init powershell（或conda init cmd.exe） - 重新打开 PowerShell，
(base)出现即可正常使用
以管理员身份打开 PowerShell，执行：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
Q2：conda install / pip install 速度极慢或超时
原因：默认连接境外源，国内网络访问慢。
解决：换为国内镜像源：
# 配置 conda 清华源
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
conda config --set show_channel_urls yes
# 配置 pip 阿里云源（永久生效）
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
Q3：macOS 上 conda: command not found
原因：conda init 未执行，或配置文件未生效。
解决：
~/anaconda3/bin/conda init zsh
source ~/.zshrc
若仍找不到，检查路径：
ls ~/anaconda3/bin/conda # 标准路径
ls /opt/anaconda3/bin/conda # Apple Silicon 备选路径
Q4：创建虚拟环境时报 PackagesNotFoundError
原因：指定的包在默认频道找不到。
解决：添加 conda-forge 频道后重试：
conda config --add channels conda-forge
conda create -n python_demo python=3.10
PyCharm 常见问题
Q5：PyCharm 里找不到 Conda 解释器 / Conda executable 路径识别失败 手动填写路径：
| 系统 | 路径 |
|---|---|
| Windows | C:\Users\<用户名>\anaconda3\Scripts\conda.exe |
| macOS（Intel） | /Users/<用户名>/anaconda3/bin/conda |
| macOS（Apple Silicon） | /opt/anaconda3/bin/conda |
Q6：PyCharm 内置 Terminal 中 conda 命令不可用
原因：Terminal 使用的 Shell 未经过 conda init 初始化。
解决：
- 进入 File → Settings → Tools → Terminal
- Shell path 改为：
- Windows：
powershell.exe（已完成 conda init 的那个） - macOS：
/bin/zsh
- Windows：
- 重启 PyCharm Terminal，应出现
(base)提示符
Q7：运行脚本提示 ModuleNotFoundError: No module named 'xxx'
原因：当前解释器不是项目使用的 conda 环境。
解决：
- 检查 PyCharm 右下角解释器名称是否为项目环境（如
python_demo） - 若不是，点击右下角 → Add New Interpreter → 选择正确的 conda 环境
重新安装依赖：
pip install requests jsonpath-ng
Claude Code 常见问题
Q8：安装后执行 claude，提示 command not found
原因：npm 全局安装目录不在系统 PATH 中。
macOS 解决：
# 查看 npm 全局目录
npm config get prefix
# 将其加入 PATH（以 /usr/local 为例）
echo 'export PATH=/usr/local/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
Windows 解决：
# 查看 npm 全局目录
npm config get prefix
# 控制面板 → 系统 → 高级系统设置 → 环境变量 → Path → 新建 → 填入上面的路径
Q9：首次运行 claude 后浏览器没有自动打开授权页面
解决：
- 终端会打印一个授权 URL，手动复制到浏览器打开
- 确保浏览器中已登录 claude.ai 账户
- 点击授权页面的 Authorize 按钮
Q10：登录时报 OAuth callback failed 或授权后终端无响应
原因：本地回调端口被占用或防火墙拦截。
解决：
- 临时关闭安全软件后重试
- 重新执行
claude /login - 若仍失败，删除本地 Token 后重试：
- macOS：
rm -rf ~/.claude/ - Windows：删除
%USERPROFILE%\.claude\目录
- macOS：
Q11：使用过程中报 Connection error 或请求超时
原因：网络无法直连 claude.ai（常见于公司/校园网络）。
解决：配置代理环境变量（参考第四章"环境变量配置"），或开启系统全局代理后再使用。
Q12：提示 Your account does not have access to Claude Code
原因：当前免费账户未开通 Claude Code 权限（部分地区限制）。
解决：
- 登录 https://claude.ai，检查账户是否显示 Claude Code 入口
- 考虑订阅 Claude Pro（每月 $20）以获取完整权限
- 或改用 API Key 方式（需在 https://console.anthropic.com 充值）
Q13：点击注册验证邮件链接后，提示"仅在部分地区可用" 原因：claude.ai 限制中国大陆 IP，注册验证链接点击时 IP 被判断为受限地区。 解决：注册全程（打开网页、填写邮箱、点击验证链接、完成设置）均需开启代理工具，选择美国或欧洲节点。 操作步骤：
- 开启代理，选择美国或欧洲节点
- 访问 https://www.whatismyip.com 确认 IP 归属为美国/欧洲
- 在代理开启状态下完成注册，并点击验证邮件中的链接
常见失误：
| 失误场景 | 说明 |
|---|---|
| 手机邮件客户端点击链接 | 手机未走代理，需改为在电脑浏览器中打开链接 |
| 代理未开启全局模式 | 在代理工具中开启"系统代理"或"全局模式" |
| 选择了香港/台湾节点 | 部分 HK/TW 节点受限，换美国或欧洲节点 |
| 代理中途断开 | 点击链接前确认代理连接状态 |
