夜雨聆风Claude Code 完整安装与使用教程
重要前置说明
- 身份澄清：Claude Code 是 Anthropic 官方推出的 Agentic 编程工具，分为两条独立产品线：
- VS Code 官方扩展：图形界面，IDE 内交互（推荐普通开发者）
- CLI 终端工具：命令行全局工具，深度自动化
- 网络与权限关键提醒
Anthropic 官方服务暂未在中国大陆提供合规直连访问，直接注册 / 使用 claude.ai、官方插件登录、调用官方 API 均存在网络、账号合规性风险； 官方 Anthropic API Key 需要海外合规身份、海外支付渠道申请，国内直接使用存在政策与网络问题。 本文仅介绍官方标准操作流程，不提供任何网络代理、第三方中转、非合规访问方案。
方案一：VS Code 官方 Claude Code 扩展（图形界面）
系统要求
VS Code 版本 ≥ 1.98.0 网络可正常访问 VS Code Marketplace 及 Anthropic 登录服务
1. 安装扩展
打开 VS Code，快捷键 Windows/Linux： Ctrl+Shift+XmacOS： Cmd+Shift+X扩展市场搜索： Claude Code，认准发布者 Anthropic 官方插件点击「Install」，安装完成后执行重载窗口： 快捷键 Ctrl+Shift+P/Cmd+Shift+P→ 输入Developer: Reload Window
命令行快速安装（终端执行）
bash运行
code --install-extension anthropic.claude-code
2. 登录配置（官方渠道）
重载后，侧边栏 / 右上角会出现 Claude Code 星火图标，点击打开面板 选择「Sign in with Anthropic」跳转官方登录页面 使用海外合规邮箱完成账号注册 / 登录，授权 VS Code 访问权限
3. 基础使用操作
- @ 文件引用
：输入 @选择项目内文件 / 文件夹，限定 Claude 读取上下文 - 代码修改预览
：AI 生成改动会以 inline diff 展示，可逐行接受 / 拒绝变更 - 权限控制
：首次执行文件写入、终端命令会弹出权限确认，按需授予 常用指令示例：
@main.py 优化这段代码，补充异常捕获并添加注释
@src/ 梳理整个项目结构，输出架构说明文档方案二：Claude Code CLI 终端工具（命令行）
前置依赖
需要 Node.js 18.0.0 及以上 LTS 版本
bash运行
# 检查版本
node -v
npm -v1. 全局安装 CLI
bash运行
# npm
npm install -g @anthropic-ai/claude-code
# pnpm
pnpm add -g @anthropic-ai/claude-code
# yarn
yarn global add @anthropic-ai/claude-code2. 验证安装
bash运行
claude --version输出版本号即安装成功。
3. 初始化配置
bash运行
claude login按照终端指引跳转 Anthropic 登录，绑定账号；或手动配置环境变量存储 API Key（官方方案）：
bash运行
# macOS / Linux
export ANTHROPIC_API_KEY="你的key"
# Windows PowerShell
$env:ANTHROPIC_API_KEY="你的key"4. CLI 基础使用示例
bash运行
# 直接提问，读取当前目录上下文
claude 帮我修复index.js中的报错
# 指定文件
claude @app.py 重构接口逻辑
# 进入交互式会话
claude chat常见问题与限制
1. 无法登录 / 加载插件
根源：大陆网络无法直连 Anthropic 服务。无合规官方解决方案。
2. API Key 获取障碍
Anthropic API 仅对海外企业 / 个人开放，国内开发者无合规官方申请通道，各类第三方中转服务存在数据安全、合规风险，不建议使用。
3. Windows CLI 兼容性
CLI 原生支持 PowerShell、Git Bash；部分复杂文件操作建议使用 WSL2 环境。
4. 功能安全提示
Claude Code 拥有读写本地文件、执行终端命令能力，谨慎授予全盘 / 高权限，不要在敏感项目随意允许自动执行命令。
替代建议（国内合规可用）
若你在国内环境、无法访问 Anthropic 官方服务，可以选择国内合规大模型 IDE 插件（通义灵码、CodeGeeX、豆包编程助手等），无需特殊网络，符合国内数据合规要求。
