Python AI 开发环境搭建指南：Anaconda、PyCharm 与 Claude Code 配置

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 官网，根据 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）

下载 访问 JetBrains 官网，选择 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 官网，点击 LTS（长期支持版） 下载 .msi 安装包。
2. 双击安装，一路点击 Next（默认选项即可）。
3. 打开 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 免费账户

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

mkdir ~/.npm-global
chmod -R u+w ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

验证安装：

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：

$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 运行。

安装插件

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) 出现即可正常使用。
3. 以管理员身份打开 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 路径识别失败 手动填写路径：

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 环境。
3. 重新安装依赖：

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

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. 在代理开启状态下完成注册，并点击验证邮件中的链接。

常见失误：