Claude Code安装使用教程

Claude Code 完整安装与使用教程

重要前置说明

身份澄清：Claude Code 是 Anthropic 官方推出的 Agentic 编程工具，分为两条独立产品线：
网络与权限关键提醒
本文仅介绍官方标准操作流程，不提供任何网络代理、第三方中转、非合规访问方案。

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

系统要求

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

1. 安装扩展

打开 VS Code，快捷键
扩展市场搜索：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 -v

1. 全局安装 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-code

2. 验证安装

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、豆包编程助手等），无需特殊网络，符合国内数据合规要求。