Windows 装 Claude Code：我踩过的坑和实用操作心得

最近写 Python 接口文档，总觉得重复代码敲着烦，想着试试 Claude Code 帮着生成代码片段。结果一开始搜 “Windows 装 Claude Code”，满屏都在说 “没客户端”，折腾半天才搞明白 —— 原来不是 “安装软件”，是要跟开发工具搭起来用。作为踩了好几个环境坑的后端，把过程整理出来，希望能帮到同样想省时间的同行。

一、先掰扯清楚：Claude Code 根本不是 “装软件”

我最开始犯的错就是搜 “Claude Code Windows 安装包”，找了半天啥也没有，后来问了公司老大哥才知道：Anthropic 压根没出独立的 “Claude Code 客户端”！咱们说的 “装”，其实就是把它的编码功能嵌到平时用的工具里 —— 要么是 VS Code 这种编辑器，要么是写脚本调用它的 API。

我当时需求很明确：一是用 VS Code 写代码时，能右键就让它帮我补代码、找 bug；二是偶尔要批量处理旧代码优化，得用脚本调 API 自动弄。所以下面就分这两种情况说，都是我实际试过能跑通的。

二、准备工作：这两步没做好，后面全白搭

不管用哪种方式，这两件事必须先搞定，我当初漏了一步，卡了快一小时。

1. 先搞到 API 密钥（没这个啥也干不了！）

Claude 所有功能都要靠密钥授权，我当时拿密钥的过程还挺曲折：

• 先去 Anthropic 官网，用公司邮箱注册的 —— 毕竟后面可能要处理工作代码，个人邮箱怕不安全。
• 登录后点 “API Keys”，再点 “Create Key”，给密钥起了个名 “Windows-VSCode 专用”，生成后我随手关了页面，结果再想找的时候懵了 —— 页面关了就看不着了！只能又生成一个，这次赶紧存到微信收藏里，还备注了 “别删！”。
• 提醒一句：新账号有 5 美元免费额度，我测了下，生成几十段代码没问题，但要是批量处理，记得提前充点钱，我之前调 API 突然失败，还以为配置错了，查了半天才发现额度用完了。

2. 检查你电脑的环境（别等装一半才发现少东西）

• 用 VS Code 的话：我一开始用的 VS Code 是 1.78 版本，装完插件点不开，查了插件文档才知道要 1.80 以上。后来在 “帮助 - 关于” 里看了版本，又点扩展面板右上角的 “更新” 按钮升了级，才搞定。
• 用 Python SDK 的话：得装 Python 3.8 以上，我之前电脑里是 3.7，跑脚本的时候直接报错 “依赖包不兼容”。后来卸了装 3.10，记得勾上 “Add Python to PATH”—— 我第一次没勾，后面输 “python --version” 都没反应，又手动配环境变量，折腾半天。

三、方案一：VS Code 装插件（新手优先，我现在主力用这个）

这个方式最省事，不用写代码，配好就能直接在编辑器里用，适合像我这样想快速提效的。

1. 装插件：网络不好真的会急死人

打开 VS Code，按Ctrl+Shift+X调出扩展面板，搜 “Claude AI”—— 我选的是那个蓝色机器人图标的 “Claude by Anthropic”，官方合作的应该靠谱。点 “安装” 的时候，我家 WiFi 信号不好，进度条卡了三次，后来切了手机热点才装上，前后花了快 20 秒。

2. 配 API 密钥：我因为一个空格卡了 10 分钟

• 装完插件，点右上角的齿轮图标，选 “Extension Settings”，找到 “Anthropic: Api Key”。
• 粘贴密钥的时候，我直接从微信复制过去，点了保存就以为完事了。结果右键调用功能的时候，一直提示 “密钥无效”。我反复检查密钥，最后发现复制的时候多带了个空格！删掉空格再保存，立马就好了 —— 这细节真的能气人。

3. 测试用：生成快排代码那下我惊了

• 新建了个test.py，写了句注释 “# 生成快速排序函数”，右键点 “Claude: Generate Code”。
• 等了大概 3 秒，直接出来完整的快排代码，还带注释！不过我项目里不让用递归，又在右侧对话框输 “改成非递归版本”，不到 2 秒就优化好了，比我自己查资料改快多了。
• 还有个好用的功能：上次我写循环的时候把 “i < len (list)” 写成 “i <= len (list)”，报了索引错。选中那段代码右键点 “Claude: Debug Code”，它直接指出 “边界条件错了，应该是小于不是小于等于”，连修改后的代码都给出来了，省得我自己找半天。

四、方案二：Python SDK 调 API（适合要自定义脚本的场景）

我后来要批量优化旧项目里的 SQL 查询代码，光靠 VS Code 插件不够用，就研究了用 SDK 写脚本，虽然麻烦点，但灵活度高。

1. 装 SDK：旧版本坑死人

打开 CMD（我后来发现用管理员模式不容易报错），输 “pip install anthropic --upgrade”。一开始我没加 “--upgrade”，装的是旧版本，写脚本的时候用 “messages.create” 调用，直接报 “AttributeError”。查了 Anthropic 的官方文档才知道，旧版本用的是 “completions.create”，新版本接口改了 —— 所以一定要加 “--upgrade” 更到最新版。

还有个小插曲：我第一次输 “pip” 的时候，CMD 提示 “不是内部命令”，我才想起装 Python 的时候没勾 “Add to PATH”。后来右键 “此电脑”→属性→高级系统设置→环境变量，在系统变量的 PATH 里加了 “C:\Python310” 和 “C:\Python310\Scripts”，重启 CMD 才好用，当时差点直接重装 Python。

2. 写测试脚本：被同事骂了才知道要藏密钥

新建了个 claude_code_test.py，一开始图省事，直接把密钥硬编码在脚本里，结果被旁边同事看到，劈头盖脸骂了一顿：“你这密钥传 GitHub 上，账号被人盗了哭都来不及！”

后来才改成用环境变量存：

import osfrom anthropic import Anthropic# 先在Windows环境变量里加了ANTHROPIC_API_KEY，这里读出来api_key = os.getenv("ANTHROPIC_API_KEY")# 怕自己忘了设环境变量，加了个兜底（测试用，正式项目绝对不能这么写）if not api_key:    api_key = "我临时用的密钥"client = Anthropic(api_key=api_key)# 让它写个读Excel算平均值的函数，还要处理空值——这是我当时实际要用到的功能response = client.messages.create(    model="claude-3-sonnet-20240229",  # 老大哥说这个模型又快又准，我一直用这个    max_tokens=1000,    messages=[        {            "role": "user",            "content": "用Python写个读Excel算某列平均值的函数，空值和格式错都要处理"        }    ])print("生成的代码：")print(response.content[0].text)

3. 跑脚本：网络波动坑了我一次

在 CMD 里切到脚本目录，输 “python claude_code_test.py”。第一次跑的时候，家里 WiFi 突然断了一下，脚本直接卡住，后来重启脚本还报错。我查了下，加了个重试机制 —— 用 tenacity 库，失败了自动重试 3 次，后面就没出过问题：

from tenacity import retry, stop_after_attempt, wait_exponential# 失败了等2-10秒重试，最多3次@retry(stop=stop_after_attempt(3), wait=wait_exponential(multiplier=1, min=2, max=10))def call_claude(content):    response = client.messages.create(...)    return response

而且生成的代码特别贴心，不仅有函数，还提醒我要装 pandas 和 openpyxl，连 “pip install pandas openpyxl” 都写好了，复制过去就能用，省得我自己查依赖。

五、我总结的实用技巧：全是踩坑踩出来的

1. 密钥千万别硬编码！

我同事之前把密钥硬编码在项目里，不小心推到 GitHub，不到半天账号就被人调用了，扣了几百美元。现在我要么用环境变量，要么用.env 文件（装 python-dotenv 库读），测试完还会赶紧删掉临时密钥。

1. 选对模型能省不少钱

一开始我觉得 Opus 模型效果好，就一直用，结果 5 美元免费额度 3 天就没了。后来换成 Sonnet，发现写普通代码够用了，速度还快，现在免费额度用了快两周还没花完。Haiku 虽然最便宜，但复杂点的代码会漏细节，简单生成个循环还行。

1. 网络不好就换网线！

我在家用 WiFi 调 API，十次有三次超时，后来把笔记本接了网线，基本上一次就通。要是没网线，关了代理试试 —— 有时候代理反而会干扰连接。

1. 没客户端也能高效用

我之前一直找 “Claude Code 客户端”，后来发现 VS Code 插件加个快捷键就够了：我把 “Claude: Generate Code” 设成了Ctrl+Alt+C，写代码的时候想生成片段，按个快捷键就出来，比找客户端方便多了。偶尔想测试 API，直接上 Anthropic 官网的 Playground，不用写脚本也能试。

六、最后说两句

折腾下来，我觉得 Windows 上用 Claude Code 真没那么复杂 —— 要么用 VS Code 插件（5 分钟搞定），要么用 SDK 写脚本（适合自定义需求）。关键是别踩我之前踩过的那些坑：密钥别漏存、环境版本别太低、别硬编码密钥。

之后要是 Anthropic 出了 Windows 客户端，我肯定第一时间试试，到时候再跟大家分享新的用法。你们要是有其他好用的配置技巧，也欢迎在评论区跟我聊聊～