手把手搭建 Python AI 开发环境：Anaconda + PyCharm + Claude Code 安装全攻略（Windows / macOS）

Anaconda + PyCharm + Claude Code 完整安装教程（Windows / macOS）

本文涵盖 Anaconda、PyCharm Community Edition、Claude Code CLI 以及 PyCharm Claude Code 插件的完整安装与配置流程，同时收录注册报错、地区限制、环境变量等常见问题解决方案，适合 Windows 和 macOS 用户从零开始配置 Python 开发环境。

文章目录

• Anaconda + PyCharm + Claude Code 完整安装教程（Windows / macOS）
• 一、Windows 安装
• • 1. 安装 Anaconda（Windows）
  • 2. 安装 PyCharm Community Edition（Windows）
  • 3. 配置 PyCharm 使用 Conda 环境（Windows）
• 二、macOS 安装
• • 1. 安装 Anaconda（macOS）
  • 2. 安装 PyCharm Community Edition（macOS）
  • 3. 配置 PyCharm 使用 Conda 环境（macOS）
• 三、创建项目虚拟环境
• 四、安装 Claude Code（免费版）
• • Windows 安装 Claude Code
  • macOS 安装 Claude Code
  • Claude Code 常用操作
  • Claude Code Token 管理
  • 环境变量配置
• 五、PyCharm 安装并使用 Claude Code 插件
• • 安装插件
  • 首次使用配置
  • 打开 Claude Code 面板
  • 核心功能使用
  • 常用操作汇总
• 六、常见问题排查
• • Anaconda 常见问题
  • PyCharm 常见问题
  • Claude Code 常见问题

一、Windows 安装

1. 安装 Anaconda（Windows）

下载

访问 Anaconda 官网：https://www.anaconda.com/download

页面会自动识别操作系统，点击 Download 按钮下载 Windows 版安装包（.exe 文件，约 900MB）。

安装步骤

验证安装

在开始菜单中搜索并打开 Anaconda Prompt，输入：

conda –version

输出类似 conda 24.x.x 即表示安装成功。

在 PowerShell 中启用 conda（重要）

安装时未勾选添加 PATH，因此普通 PowerShell 默认无法使用 conda 命令，需执行一次初始化：

conda init powershell

Set-ExecutionPolicy –Scope CurrentUser –ExecutionPolicy RemoteSigned

此后在任意 PowerShell 窗口中均可直接使用 conda activate <环境名>。

2. 安装 PyCharm Community Edition（Windows）

下载

访问 JetBrains 官网：https://www.jetbrains.com/pycharm/download/

选择 Community Edition（免费版），点击 Download 下载 .exe 安装包。

安装步骤

3. 配置 PyCharm 使用 Conda 环境（Windows）

C:\\Users\\<用户名>\\anaconda3\\Scripts\\conda.exe

二、macOS 安装

1. 安装 Anaconda（macOS）

下载

访问 Anaconda 官网：https://www.anaconda.com/download

根据 Mac 芯片选择版本：

• Apple Silicon（M1/M2/M3/M4）：选择 Apple Silicon 版本（.pkg 文件）
• Intel 芯片：选择 Intel 版本（.pkg 文件）

安装步骤

初始化 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)

安装步骤

3. 配置 PyCharm 使用 Conda 环境（macOS）

# Intel Mac
/Users/<用户名>/anaconda3/bin/conda

# Apple Silicon Mac
/opt/anaconda3/bin/conda

三、创建项目虚拟环境

建议为项目单独创建 conda 虚拟环境，避免依赖冲突。

方式一：通过命令行创建

# 创建名为 python_demo 的环境，指定 Python 3.10
conda create -n python_demo python=3.10

# 激活环境
conda activate python_demo

# 安装项目依赖
pip install requests jsonpath-ng

方式二：通过 PyCharm 创建

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 —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 免费账户

注册时遇到 Failed to execute 'insertBefore' on 'Node' 报错

这是注册页面与浏览器扩展插件的兼容性冲突，按以下顺序尝试：

注册时提示"仅在部分地区可用（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 命令找不到：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

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）：

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

验证安装：

claude –version

第三步：注册 claude.ai 免费账户

注册时遇到 Failed to execute 'insertBefore' on 'Node' 报错

注册时提示"仅在部分地区可用（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.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

# 编辑 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 运行。

安装插件

首次使用配置

若插件未自动找到 CLI 路径，进入 Settings → Tools → Claude Code，手动填写路径：

打开 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 并确认安装成功

常用操作汇总

注意事项：

• 插件复用 CLI 登录状态，无需单独登录。若提示未登录，先在终端执行 claude /login
• 免费版插件用量与终端共享同一每日额度
• 面板空白或报错时，执行 Tools → Claude Code → Restart Claude Code

六、常见问题排查

Anaconda 常见问题

Q1：PowerShell / CMD 中输入 conda，提示"不是内部或外部命令"

原因：安装时未勾选加入 PATH，且未执行 conda init。

解决：

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 路径识别失败

手动填写路径：

Q6：PyCharm 内置 Terminal 中 conda 命令不可用

原因：Terminal 使用的 Shell 未经过 conda init 初始化。

解决：

Q7：运行脚本提示 ModuleNotFoundError: No module named 'xxx'

原因：当前解释器不是项目使用的 conda 环境。

解决：

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 后浏览器没有自动打开授权页面

解决：

Q10：登录时报 OAuth callback failed 或授权后终端无响应

原因：本地回调端口被占用或防火墙拦截。

解决：

Q11：使用过程中报 Connection error 或请求超时

原因：网络无法直连 claude.ai（常见于公司/校园网络）。

解决：配置代理环境变量（参考第四章"环境变量配置"），或开启系统全局代理后再使用。

Q12：提示 Your account does not have access to Claude Code

原因：当前免费账户未开通 Claude Code 权限（部分地区限制）。

解决：

Q13：点击注册验证邮件链接后，提示"仅在部分地区可用"

原因：claude.ai 限制中国大陆 IP，注册验证链接点击时 IP 被判断为受限地区。

解决：注册全程（打开网页、填写邮箱、点击验证链接、完成设置）均需开启代理魔法，选择美国或欧洲节点。

操作步骤：

常见失误：