跳到主要内容
Python AI 开发环境搭建指南:Anaconda、PyCharm 与 Claude Code 配置 | 极客日志
Python Node.js AI
Python AI 开发环境搭建指南:Anaconda、PyCharm 与 Claude Code 配置 综述由AI生成 配置 Python AI 开发环境涉及 Anaconda 包管理、PyCharm IDE 集成以及 Claude Code 工具链的部署。本文详述了 Windows 与 macOS 双平台下的安装步骤,涵盖环境变量设置、虚拟环境创建及插件配置。重点解决网络区域限制、权限错误及路径识别等常见问题,帮助开发者快速建立本地 AI 辅助编程工作流,实现终端与 IDE 的高效协同。
Kubernet 发布于 2026/4/11 更新于 2026/5/23 12 浏览Anaconda + PyCharm + Claude Code 完整安装教程(Windows / macOS)
本指南涵盖 Anaconda、PyCharm Community Edition、Claude Code CLI 以及 PyCharm Claude Code 插件的完整安装与配置流程。内容包含注册报错、地区限制、环境变量等常见问题的解决方案,适合 Windows 和 macOS 用户从零开始配置 Python 开发环境。
一、Windows 安装
1. 安装 Anaconda(Windows)
下载
访问 Anaconda 官网,页面会自动识别操作系统,点击 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 <环境名>。
下载
访问 JetBrains 官网,选择 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
二、macOS 安装
1. 安装 Anaconda(macOS) 下载
访问 Anaconda 官网,根据 Mac 芯片选择版本:
Apple Silicon(M1/M2/M3/M4):选择 Apple Silicon 版本(.pkg 文件)。
Intel 芯片:选择 Intel 版本(.pkg 文件)。
双击 .pkg 文件,启动安装向导。
依次点击 Continue → Continue → Agree 。
安装位置保持默认(仅当前用户),点击 Continue → Install 。
输入系统密码,等待安装完成,点击 Close 。
初始化 Shell(重要)
安装完成后打开 终端(Terminal) ,根据 Shell 类型执行初始化:
conda init zsh
conda init bash
关闭终端,重新打开,提示符前出现 (base) 表示 conda 激活成功。
conda --version
python --version
下载
访问 JetBrains 官网,选择 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 若未自动识别,手动填写:
/Users/<用户名>/anaconda3/bin/conda
/opt/anaconda3/bin/conda
三、创建项目虚拟环境 建议为项目单独创建 conda 虚拟环境,避免依赖冲突。
conda create -n python_demo python=3.10
conda activate python_demo
pip install requests jsonpath-ng
进入 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 授权登录。
Windows 安装 Claude Code
访问 Node.js 官网,点击 LTS(长期支持版) 下载 .msi 安装包。
双击安装,一路点击 Next (默认选项即可)。
打开 PowerShell 验证:
node --version
npm --version
第二步:安装 Claude Code
以管理员身份打开 PowerShell,执行:
npm install -g @anthropic-ai/claude-code
若提示'无法运行脚本'(执行策略错误) ,以管理员身份运行 PowerShell 后执行:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
然后重新执行安装命令。
打开浏览器(推荐 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 中执行:
首次运行选择 Login with Claude.ai ,浏览器自动打开授权页面,点击 Authorize 完成授权。
# 进入项目目录后启动
cd C:\path\to\your\project
claude
# 查看帮助
claude --help
macOS 安装 Claude Code 第一步:安装 Node.js
推荐使用 Homebrew 安装:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) "
Apple Silicon 特别注意 :安装 Homebrew 后需手动初始化 PATH,否则 brew 命令找不到:
Intel Mac 无需此步骤。
node --version
npm --version
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
打开浏览器(推荐 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 均为可用地区。
首次运行选择 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
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"
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxx"
$env:ANTHROPIC_API_KEY = "sk-ant-xxxxxxxxxxxxxxxx"
五、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/claudemacOS(npm 默认) /usr/local/bin/claudeWindows 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 帮我分析这个文件有哪些可以优化的地方
查看当前项目目录结构
帮我运行 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 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 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
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.exemacOS(Intel) /Users/<用户名>/anaconda3/bin/condamacOS(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。
重启 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 config get prefix
echo 'export PATH=/usr/local/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
# 查看 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\ 目录
Q11:使用过程中报 Connection error 或请求超时
原因:网络无法直连 claude.ai(常见于公司/校园网络)。
解决:配置代理环境变量(参考第四章'环境变量配置'),或开启系统全局代理后再使用。
Q12:提示 Your account does not have access to Claude Code
原因:当前免费账户未开通 Claude Code 权限(部分地区限制)。
解决:
Q13:点击注册验证邮件链接后,提示'仅在部分地区可用'
原因:claude.ai 限制中国大陆 IP,注册验证链接点击时 IP 被判断为受限地区。
解决:注册全程 (打开网页、填写邮箱、点击验证链接、完成设置)均需开启代理魔法,选择美国或欧洲节点。
操作步骤:
失误场景 说明 手机邮件客户端点击链接 手机未走代理,需改为在电脑浏览器中打开链接 代理未开启全局模式 在代理工具中开启'系统代理'或'全局模式' 选择了香港/台湾节点 部分 HK/TW 节点受限,换美国或欧洲节点 代理中途断开 点击链接前确认代理连接状态
相关免费在线工具 RSA密钥对生成器 生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
Mermaid 预览与可视化编辑 基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
随机西班牙地址生成器 随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online
curl 转代码 解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online