Python AI 开发环境搭建：Anaconda + PyCharm + Claude Code 安装指南

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

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

安装步骤

1. 双击 .exe 文件，启动安装向导
2. 点击 Next，选择安装路径（建议保持默认），点击 Next
3. 安装选项（按需勾选）：
   • ✅ Create Desktop Shortcut（创建桌面快捷方式）
   • ✅ Add 'Open Folder as Project'（右键菜单添加'以项目打开'）
   • ✅ .py（关联 .py 文件，可选）
4. 点击 Next → Install
5. 等待安装完成，点击 Finish

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

1. 打开 PyCharm，打开或创建项目
2. 进入 File → Settings → Project: <项目名> → Python Interpreter
3. 点击右上角齿轮图标 → Add Interpreter → Add Local Interpreter
4. 左侧选择 Conda Environment
5. 选择 Use existing environment 或 Create new environment（新建时填写名称，选择 Python 3.10+）
6. Conda executable 路径若未自动识别，手动填写：

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

7. 点击 OK 完成配置

二、macOS 安装

1. 安装 Anaconda（macOS）

下载

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

根据 Mac 芯片选择版本：

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

安装步骤

1. 双击 .pkg 文件，启动安装向导
2. 依次点击 Continue → Continue → Agree
3. 安装位置保持默认（仅当前用户），点击 Continue → Install
4. 输入系统密码，等待安装完成，点击 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)

安装步骤

1. 双击 .dmg 文件，打开磁盘映像
2. 将 PyCharm CE 图标拖拽到 Applications（应用程序） 文件夹
3. 在启动台找到 PyCharm，双击打开
4. 首次打开若提示'来自互联网的应用'，点击 打开

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

1. 打开 PyCharm，打开或创建项目
2. 进入 PyCharm → Settings → Project: <项目名> → Python Interpreter
3. 点击 Add Interpreter → Add Local Interpreter
4. 左侧选择 Conda Environment
5. Conda executable 若未自动识别，手动填写：

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

6. 选择已有环境或新建环境，点击 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 创建

1. 进入 Settings → Python Interpreter → Add Interpreter → Add Local Interpreter
2. 选择 Conda Environment → Create new environment
3. 填写环境名称 python_demo，Python 版本选 3.10
4. 点击 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

1. 访问 Node.js 官网：https://nodejs.org
2. 点击 LTS（长期支持版） 下载 .msi 安装包
3. 双击安装，一路点击 Next（默认选项即可）
4. 打开 PowerShell 验证：

node --version
npm --version 

显示版本号（如 v20.x.x）即表示安装成功。

第二步：安装 Claude Code

以管理员身份打开 PowerShell，执行：

npm install -g @anthropic-ai/claude-code 

安装完成后验证：

claude --version 

若提示'无法运行脚本'（执行策略错误），以管理员身份运行 PowerShell 后执行：

然后重新执行安装命令。

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

1. 打开浏览器（推荐 Chrome 或 Edge），访问：https://claude.ai
2. 点击 Sign Up，选择注册方式：
   • Continue with Google：使用 Google 账号一键注册（推荐）
   • Continue with Apple：使用 Apple ID 注册
   • 邮箱注册：输入邮箱 → 设置密码 → 查收验证邮件 → 点击验证链接
3. 填写用户名，选择用途，点击 Continue
4. 完成注册后保持登录状态

注册时遇到 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 免费账户

1. 打开浏览器（推荐 Chrome 或 Safari），访问：https://claude.ai
2. 点击 Sign Up，选择注册方式：
   • Continue with Google：使用 Google 账号一键注册（推荐）
   • Continue with Apple：使用 Apple ID 注册
   • 邮箱注册：输入邮箱 → 设置密码 → 查收验证邮件 → 点击验证链接
3. 填写用户名，选择用途，点击 Continue
4. 完成注册后保持浏览器登录状态

注册时遇到 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.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：

API Key 在 https://console.anthropic.com → API Keys 页面生成。免费版用户使用 claude.ai 登录即可，无需 API Key。

五、PyCharm 安装并使用 Claude Code 插件

前提：已完成上文 Claude Code CLI 的安装与登录。插件是 CLI 的 IDE 界面封装，依赖 CLI 运行。

安装插件

1. 打开 PyCharm，进入 File → Settings（macOS：PyCharm → Settings）
2. 左侧选择 Plugins → 切换到 Marketplace 标签
3. 搜索框输入 Claude Code
4. 找到 Claude Code（发布者 Anthropic），点击 Install
5. 安装完成后点击 Restart IDE

首次使用配置

若插件未自动找到 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。

解决：

1. 打开 Anaconda Prompt，执行 conda init powershell（或 conda init cmd.exe）
2. 重新打开 PowerShell，(base) 出现即可正常使用

以管理员身份打开 PowerShell，执行：

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

解决：

1. 进入 File → Settings → Tools → Terminal
2. Shell path 改为：
   • Windows：powershell.exe（已完成 conda init 的那个）
   • macOS：/bin/zsh
3. 重启 PyCharm Terminal，应出现 (base) 提示符

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

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

解决：

1. 检查 PyCharm 右下角解释器名称是否为项目环境（如 python_demo）
2. 若不是，点击右下角 → 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 config get prefix
# 控制面板 → 系统 → 高级系统设置 → 环境变量 → Path → 新建 → 填入上面的路径

Q9：首次运行 claude 后浏览器没有自动打开授权页面

解决：

1. 终端会打印一个授权 URL，手动复制到浏览器打开
2. 确保浏览器中已登录 claude.ai 账户
3. 点击授权页面的 Authorize 按钮

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

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

解决：

1. 临时关闭安全软件后重试
2. 重新执行 claude /login
3. 若仍失败，删除本地 Token 后重试：
   • macOS：rm -rf ~/.claude/
   • Windows：删除 %USERPROFILE%\.claude\ 目录

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

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

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

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

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

解决：

1. 登录 https://claude.ai，检查账户是否显示 Claude Code 入口
2. 考虑订阅 Claude Pro（每月 $20）以获取完整权限
3. 或改用 API Key 方式（需在 https://console.anthropic.com 充值）

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

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

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

操作步骤：

1. 开启代理，选择美国或欧洲节点
2. 访问 https://www.whatismyip.com 确认 IP 归属为美国/欧洲
3. 在代理开启状态下完成注册，并点击验证邮件中的链接

常见失误：