Claude Code 完整安装与使用教程

重要前置说明

1. 身份澄清：Claude Code 是 Anthropic 官方推出的 Agentic 编程工具，分为两条独立产品线：
   • VS Code 官方扩展：图形界面，IDE 内交互（推荐普通开发者）
   • CLI 终端工具：命令行全局工具，深度自动化
2. 网络与权限关键提醒
   • Anthropic 官方服务暂未在中国大陆提供合规直连访问，直接注册 / 使用 claude.ai、官方插件登录、调用官方 API 均存在网络、账号合规性风险；
   • 官方 Anthropic API Key 需要海外合规身份、海外支付渠道申请，国内直接使用存在政策与网络问题。
3. 本文仅介绍官方标准操作流程，不提供任何网络代理、第三方中转、非合规访问方案。

方案一：VS Code 官方 Claude Code 扩展（图形界面）

系统要求

• VS Code 版本 ≥ 1.98.0
• 网络可正常访问 VS Code Marketplace 及 Anthropic 登录服务

1. 安装扩展

1. 打开 VS Code，快捷键
   • Windows/Linux：Ctrl+Shift+X
   • macOS：Cmd+Shift+X
2. 扩展市场搜索：Claude Code，认准发布者 Anthropic 官方插件
3. 点击「Install」，安装完成后执行重载窗口：

1. 快捷键 Ctrl+Shift+P / Cmd+Shift+P → 输入 Developer: Reload Window

2. 登录配置（官方渠道）

1. 重载后，侧边栏 / 右上角会出现 Claude Code 星火图标，点击打开面板
2. 选择「Sign in with Anthropic」跳转官方登录页面
3. 使用海外合规邮箱完成账号注册 / 登录，授权 VS Code 访问权限

3. 基础使用操作

• @ 文件引用：输入 @ 选择项目内文件 / 文件夹，限定 Claude 读取上下文
• 代码修改预览：AI 生成改动会以 inline diff 展示，可逐行接受 / 拒绝变更
• 权限控制：首次执行文件写入、终端命令会弹出权限确认，按需授予
• 常用指令示例：

@main.py 优化这段代码，补充异常捕获并添加注释
@src/ 梳理整个项目结构，输出架构说明文档

方案二：Claude Code CLI 终端工具（命令行）

前置依赖

# 检查版本
node -v
npm -v

1. 全局安装 CLI

# npm
npm install -g @anthropic-ai/claude-code

# pnpm
pnpm add -g @anthropic-ai/claude-code

# yarn
yarn global add @anthropic-ai/claude-code

2. 验证安装

claude --version

3. 初始化配置

claude login

# macOS / Linux
export ANTHROPIC_API_KEY="你的key"

# Windows PowerShell
$env:ANTHROPIC_API_KEY="你的key"

4. CLI 基础使用示例

# 直接提问，读取当前目录上下文
claude 帮我修复index.js中的报错

# 指定文件
claude @app.py 重构接口逻辑

# 进入交互式会话
claude chat

常见问题与限制

1. 无法登录 / 加载插件

2. API Key 获取障碍

3. Windows CLI 兼容性

4. 功能安全提示

替代建议（国内合规可用）