VS Code

1. 前置准备：环境与权限校验 在正式启用 Claude 智能编程能力前，务必完成严谨的环境校验——这一步看似琐碎，却直接决定后续所有功能是否稳定可用。尤其对国内开发者而言，网络与权限配置是高频卡点。 首先，确认 VS Code 版本 ≥ 1.85（2023年12月发布）。该版本起全面支持 Webview2 渲染引擎与 Language Server Protocol v18+，而 Claude Code 扩展依赖这两项底层能力实现低延迟交互与富文本响应。检查方式：Ctrl+Shift+P → 输入 Help: About → 查看第一行版本号。若低于 1.85，请前往 code.visualstudio.com 下载最新稳定版。 接着，获取 Anthropic API Key： 访问 Anthropic Console（需科学访问，国内用户建议配置系统级代理或使用可信企业级代理服务）； 注册/登录账户后，进入 API Keys → 点击 Create Key； 在 Key 名称中注明用途（如 vscode-claude-prod），生成后立即复制并安全保存（页面关闭后无法再次查看）； ✅ 推荐模型：claude-3-haiku-20240307（轻量、快响应，适合补全）或 claude-3-5-sonnet-20240620（强逻辑、长上下文，适合文档生成）。 验证 API 连通性（终端执行）： # 将 YOUR_API_KEY 替换为实际密钥（不带引号） export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" curl -X POST "https://api.anthropic.com/v1/messages" \ -H "x-api-key: ${ANTHROPIC_API_KEY}" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-3-haiku-20240307", "max_tokens": 50, "messages": [{"role": "user", "content": "输出 OK"}] }' ✅ 成功响应将返回 JSON，含 "content":[{"type":"text","text":"OK"}]。若报 401 Unauthorized，请检查 Key 是否过期或被撤销；若超时（curl: (7) Failed to connect），请确认代理已全局生效（VS Code 需继承系统代理，可在设置中搜索 proxy 启用 http.proxySupport: override）。 ...

一、准备工作：配置Claude Code环境与接入遗留项目 在接手一个上线8年、无文档、测试覆盖率<5%的电商订单系统时，第一步不是写代码——而是让Claude Code真正“读懂”它。我们以VS Code为首选IDE（官方插件仅正式支持VS Code，JetBrains系列暂未开放集成），确保环境干净可控。 ✅ 安装与激活（附截图指引） 打开VS Code → Extensions（Ctrl+Shift+X）→ 搜索 Claude Code（开发者：Anthropic，非“Claude Assistant”或“CodeWithClaude”等第三方） 点击 Install → 重启VS Code 首次启动后，右下角弹出配置向导 → 点击 “Configure API Key” → 粘贴从 console.anthropic.com 获取的 sk-ant-api03-... 密钥（⚠️切勿提交至Git！建议存入系统密钥链） 📁 配置文件详解（.claude-code/config.json） 在项目根目录创建 .claude-code/config.json，关键字段需显式声明： { "model": "claude-3-5-sonnet-20240620", "maxTokens": 2048, "contextWindowSize": 16384, "temperature": 0.1 } model：强制指定高精度模型（Sonnet 3.5在代码理解上显著优于Haiku） contextWindowSize：设为16384可覆盖中型模块（如含5个.py文件的Django app），避免截断关键上下文 🚫 精准排除干扰项（.claude-code/ignore.json） 遗留项目常含巨型node_modules/（20GB+）、dist/构建产物、logs/实时日志。创建忽略规则： { "patterns": [ "**/node_modules/**", "**/dist/**", "**/logs/*.log", "**/*.min.js", "**/coverage/**" ], "maxFileSizeMB": 5 } ⚠️ 安全红线： 禁用 Send clipboard content automatically（设置 → Claude Code → 取消勾选） 内网环境禁用 Auto-upload error stack traces，防止/var/log/app/路径泄露 敏感项目根目录名勿含prod-cred、bank-key等关键词（Claude可能在上下文摘要中提取） 二、读懂遗留代码：用Claude Code做结构化代码理解 面对一段无注释、变量名全为a, b, tmp的Python支付处理函数，传统方式需逐行调试2小时；Claude Code可将其转化为可执行文档。 ...

1. 前置准备：环境与权限检查 在正式接入 Claude Code（Anthropic 官方推出的代码专用智能体，区别于通用聊天接口 claude-3-opus 等模型）前，请务必完成以下环境核查。这一步看似简单，却是后续所有操作稳定运行的基石——许多“无法登录”“生成失败”问题，80% 源于前置条件未满足。 ✅ 系统与硬件要求 操作系统：macOS 12 Monterey 或更高版本（推荐 macOS 14 Sonoma）、Windows 10 22H2 / Windows 11（需启用 WSL2 支持可选）、Linux x64（Ubuntu 20.04+、Debian 11+，内核 ≥5.4） 内存：≥8GB RAM（若同时运行 VS Code + 浏览器 + 数据分析任务，建议 ≥16GB） 磁盘空间：桌面 App 占用约 350MB；VS Code 插件仅 12MB，但缓存会随使用增长 ✅ 软件依赖检查 若使用 OAuth 登录流程（推荐方式），请确保已安装最新版 Chrome（v122+）或 Firefox（v123+）。旧版浏览器可能因 OAuth 2.1 协议不兼容导致授权中断。 若选择 VS Code 插件路径，请确认已安装 VS Code 1.85+（2024 年初起强制要求支持 WebAssembly 的新版 Electron 内核）。可通过 Help → About 查看版本号。 ✅ 账户与网络准入 ...

1. 环境准备：安装Claude Code并完成首次配置 在正式开启AI结对编程前，稳定可靠的本地环境是高效协作的前提。Claude Code 官方插件目前原生支持 VS Code（v1.85+）和 JetBrains 全系 IDE（IntelliJ IDEA 2023.3+、PyCharm 2023.3+ 等），暂不支持 Vim/Neovim 原生集成或旧版编辑器。 ✅ 安装验证四步法： 打开 VS Code → Extensions（Ctrl+Shift+X）→ 搜索 Claude Code → 点击 Install（官方发布者：Anthropic）； 安装完成后，右下角状态栏出现 🦾 图标（即 Claude 状态指示器）； 按 Ctrl+Shift+P 打开命令面板，输入 Claude，可见至少 8 个以 Claude: 开头的命令（如 Claude: Start Chat, Claude: Explain Selection）； 重启 VS Code（⚠️ 必须重启！部分功能依赖初始化服务端连接）。 🔐 账号绑定关键提醒（国内用户必读）： 登录需使用 Anthropic 官方支持地区邮箱（如 .com 域名，Gmail/Outlook 推荐；国内企业邮箱或 QQ 邮箱易触发风控）； 若提示 “Region not supported”，请确认网络出口 IP 归属地（建议使用合规跨境访问服务，并确保 DNS 解析正常）； 登录入口：状态栏 🦾 图标 → Click → “Sign in with Anthropic”。 ⚙️ 两种连接模式对比与配置： ...