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

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

 
  
    
    
      本文涵盖 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 常见问题 
       
    
 
  
    
     
     下载 
     访问 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 
       <环境名>。 
      
      下载 
      访问 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 
       
       
        
        打开 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 
       
      
         <用户名>
           anaconda3Scriptsconda.exe 
          
        
        点击 OK 完成配置 
        
        
        下载 
        访问 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 
         
         下载 
         访问：https://www.jetbrains.com/pycharm/download/ 
         选择 Community Edition，根据芯片下载： 
          
          Apple Silicon：.dmg (Apple Silicon) 
          Intel：.dmg (Intel) 
          
         安装步骤 
          
          双击 .dmg 文件，打开磁盘映像 
          将 PyCharm CE 图标拖拽到 Applications（应用程序） 文件夹 
          在启动台找到 PyCharm，双击打开 
          首次打开若提示"来自互联网的应用"，点击 打开 
          
          
           
           打开 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 是 Anthropic 官方出品的 AI 编程助手 CLI 工具，可在终端中与 Claude 协作完成代码编写、调试、重构等任务。 
            免费版说明：注册 claude.ai 免费账户即可使用，无需付费 API Key，通过浏览器 OAuth 授权登录。 
            前置要求：Node.js 18 或以上版本。 
             
             第一步：安装 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 后执行： 
              
 
然后重新执行安装命令。 
 
 
 
 
 
 








              
             第三步：注册 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 oyourproject claude # 查看帮助 claude --help  
              
              第一步：安装 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 installnode 
              或直接从 https://nodejs.org 下载 LTS 版 .pkg 安装（无需手动配置 PATH）。 
              验证： 
              node--versionnpm--version 
              第二步：安装 Claude Code 
              npminstall-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 退出输入 /exit 或按 Ctrl+C 查看快捷命令输入 /help 清空对话输入 /clear 更新版本 npm update -g @anthropic-ai/claude-code

免费版限制：免费账户每天有一定的使用额度。如需更多用量，可升级 claude.ai 订阅计划。

登录成功后，认证信息保存在本地，无需每次重新登录：

macOS / Linux：/.claude/ 目录
Windows：%USERPROFILE%.claude（如 C:Users <用户名> .claude）

常用命令：

# 查看登录状态 claude /status # 退出登录 claude /logout # 重新登录（Token 过期或切换账号时） claude /login

代理配置（公司/校园网络环境）

macOS / Linux（写入 /.zshrc，永久生效）：

exportHTTPS_PROXY=http://127.0.0.1:7890 exportHTTP_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：

# 写入 ~/.zshrcexportANTHROPIC_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。

前提：已完成上文 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 
       <用户名>
         AppDataRoaming pmclaude.cmd

点击 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

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 zshsource ~/.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

Q5：PyCharm 里找不到 Conda 解释器 / Conda executable 路径识别失败

手动填写路径：

系统路径 Windows

C:Users 
            <用户名>
              anaconda3Scriptsconda.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
重启 PyCharm Terminal，应出现 (base) 提示符

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

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

解决：

检查 PyCharm 右下角解释器名称是否为项目环境（如 python_demo）
若不是，点击右下角 → Add New Interpreter → 选择正确的 conda 环境

重新安装依赖：

pip install requests jsonpath-ng

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 目录

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 节点受限，换美国或欧洲节点代理中途断开点击链接前确认代理连接状态

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

文章目录

相关推荐