大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



• 1. 前言
• 2. 快速上手：第一次使用Claude Code
  • 2.1 环境准备（必须先完成）
    • 2.1.1 安装 Git（必需）
    • 2.1.2 安装 Node.js（必需）
    • 2.1.3 获取 API 密钥
  • 2.2 安装 Claude Code
    • 2.2.1 方案一：官方推荐安装（推荐）
    • 2.2.2 方案二：一键智能安装 ZCF（推荐新手）
    • 2.2.3 方案三：IDE 扩展安装（VS Code / Cursor / IDEA）
  • 2.3 首次启动与配置
    • 2.3.1 启动参数速查
    • 2.3.2 常见报错：Unable to connect to Anthropic services
    • 2.3.3 推荐使用 cc-switch 配置和多 API 源快速切换
    • 2.3.4 配置文件结构
• 3. 核心命令速查表
  • 3.1 高频命令（建议收藏）
  • 3.2 快捷操作
• 4. 总结
• 参考资料
• 下一步学习

Claude Code 是 Anthropic 推出的革命性 AI 编程助手，它不是简单的代码补全工具，而是一个能够理解你的需求、主动思考、执行操作的"编程伙伴"。

与传统 AI 工具不同，Claude Code 直接在终端运行，可以读写文件、执行命令、分析代码，真正做到"说人话，干实事"。

本文将通过实际场景，带你快速掌握 Claude Code 的核心用法。

适用人群：前端/后端开发者、技术写作者、代码审查者、任何想提升编程效率的人

在安装 Claude Code 之前，你需要确保系统满足以下条件：

2.1.1 安装 Git（必需）

下载地址：git-scm.com，按默认步骤安装。

关键配置：设置环境变量 CLAUDE_CODE_GIT_BASH_PATH

D:Program FilesGitbinbash.exe 

（根据你的 Git 安装路径调整）

验证安装：

GPT plus 代充 只需 145git --version 

2.1.2 安装 Node.js（必需）

下载地址：nodejs.org，安装 Node.js 18 及以上版本。推荐24.14.0

验证安装：

node -v npm -v 

2.1.3 获取 API 密钥

Claude Code 需要 官方账号登录 或者 API 密钥才能运行，你有两种选择。

API Key 是一串以 sk-ant- 开头的密钥字符串，格式类似：

GPT plus 代充 只需 145sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

方式一：官方渠道

1. 访问 Anthropic Console
2. 注册账户（三种方式任选）：
   • Google 账号登录（推荐，最快）
   • 邮箱 + 密码注册
   • GitHub 账号登录
3. 在 API Keys 页面创建新密钥
4. 复制并妥善保存（只显示一次！）

手机验证提示：注册时可能需要手机验证，支持中国大陆号码（+86），成功率约 80%。如果多次收不到验证码，可尝试语音验证或使用 Google Voice 等虚拟号码。

方式二：国内中转站（推荐国内用户）

💡 官方 API 需要海外信用卡且价格较高，国内用户可以选择以下中转站，价格更优惠、支付更方便（仅个人使用）：

也可以通过监控平台 RelayPulse - 实时监测API中转服务可用性矩阵 选择使用中转站，用多少充多少~

🎁 福利提示：通过上方链接注册，你我都能获得额外额度！

2.2.1 方案一：官方推荐安装（推荐）

第一步：安装 Claude Code 参考官方：Quickstart - Claude Code Docs

选择适合你的系统的安装脚本：

官方安装会自动更新，保持最新版本。

第二步：登录账户

启动 Claude Code 并登录：

claude # 首次使用会提示登录 /login # 按照提示完成账户登录 

支持的账户类型：

• ✅ Claude Pro、Max、Teams、Enterprise（推荐）
• ✅ Claude Console（API 访问，需要预付费额度）
• ✅ Amazon Bedrock、Google Vertex AI、Microsoft Foundry（企业云服务）

登录后凭证会自动保存，无需重复登录。需要切换账户时使用 /login 命令。

2.2.2 方案二：一键智能安装 ZCF（推荐新手）

什么是 ZCF？ Zero-Config Code Flow，一个为 Claude Code 设计的零配置工具。它会自动为你：

• 📦 安装 Claude Code
• 🔧 配置 API 和认证
• 📋 导入主流工作流模板
• 🔌 安装 主流MCP 服务
• 🌍 支持中文界面

一键启动：

GPT plus 代充 只需 145npx zcf 

按照交互菜单提示，选择语言 → 选择"完整初始化" → 自动配置完成！

参考图片：

教程参考资源：

• ZCF 官方文档
• ZCF 博客园教程
• ZCF 知乎专栏

2.2.3 方案三：IDE 扩展安装（VS Code / Cursor / IDEA）

除了终端命令启动，你也可以在编辑器内通过扩展/插件使用 Claude Code，获得可视化界面和深度集成体验。

VS Code（官方扩展）

1. 按 Ctrl/Cmd + Shift + X 打开扩展市场
2. 搜索 Claude Code，找到 Anthropic 官方发布的扩展，点击 Install
3. 安装后左侧活动栏出现 ⚡ 火花图标，点击即可打开 Claude Code 面板

扩展相比终端 CLI 的额外能力：

参考文档：https://code.claude.com/docs/en/vs-code

Cursor（VSIX 手动安装）

Cursor 基于 VS Code，但 Claude Code 扩展无法自动检测 Cursor，需要手动安装：

1. 从 VS Code Marketplace 下载 Claude Code 扩展的 VSIX 文件
2. 在 Cursor 中安装：

   cursor --install-extension /path/to/claude-code.vsix 

   或直接将 VSIX 文件拖拽到 Cursor 的扩展面板
3. 重启 Cursor，左侧出现 Claude Code 图标即成功

详细教程：https://www.cursor-ide.com/blog/claude-code-cursor-extension-guide

IntelliJ IDEA（Claude Code GUI 插件）

Claude Code GUI 是一款 JetBrains 市场 4.8 高评分的可视化界面插件，将 Claude Code 和 OpenAI Codex 双重 AI 工具直接整合到 IntelliJ IDEA 中。

1. 按 Ctrl/Cmd + , 打开设置 → Plugins → Marketplace
2. 搜索 Claude Code GUI，点击 Install
3. 重启 IDEA，工具窗口中出现 Claude Code 面板即成功

GPT plus 代充 只需 145# 进入你的项目目录 cd ~/my-project # 启动 Claude Code claude 

❌ 配置对应环境变量 - 默认一次性配置 或者 系统级别配置（建议采用 cc-switch 工具进行管理，下文介绍）

export ANTHROPIC_BASE_URL=http:xxx.xx export ANTHROPIC_AUTH_TOKEN=API_Key 

2.3.1 启动参数速查

除了直接输入 claude 启动，还可以通过参数控制启动行为：

关于 --dangerously-skip-permissions

这个参数会让 Claude Code 跳过所有权限确认，直接执行读写文件、运行命令等操作。Anthropic 官方称之为 "Safe YOLO mode"。

名字里带 "dangerously" 是因为 AI 可能误修改代码、删除文件或执行非预期命令，跳过确认意味着你来不及阻止。

新手建议：前 1 个月不要加这个参数。让 AI 每次操作都问你，既能学到它在做什么，又能避免误操作。等你熟悉了 Claude Code 的行为模式后，在个人项目中再考虑使用，但务必先把代码提交到 Git，确保随时可回滚。

2.3.2 常见报错：Unable to connect to Anthropic services

国内第一次用 Claude Code，大概率会遇到这个报错：

GPT plus 代充 只需 145Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST Please check your internet connection and network settings. 

原因：Claude Code 默认检测地区，国内 IP 会被拦截。

解决方法（一分钟搞定）：

找到用户主目录下的 .claude.json 文件：

C:Users你的用户名.claude.json 

用任意文本编辑器打开，在 JSON 对象中加入以下字段（注意给上一行末尾加逗号）：

GPT plus 代充 只需 145"hasCompletedOnboarding": true 

保存后重启 Claude Code，报错消失，正常启动。

---

2.3.3 使用 cc-switch 配置和多 API 源快速切换

我们可以配置需要的大模型供应商，国内比较推荐的模型是 GLM-4.7、Kimi-K2.5，国外无脑上 Claude 4.6、GPT 5.2 即可。

如果你想在多个 API 提供商（官方、国内中转站、本地模型等）之间快速切换，推荐使用 cc-switch：

安装：访问 GitHub Release 下载对应系统版本，Windows 推荐下载 msi 安装包。

Windows：https://github.com/farion1231/cc-switch/releases/download/v3.11.0/CC-Switch-v3.11.0-Windows.msi

无脑下一步即可~

功能：

• 🔄 在不同 API 源之间快速切换，无需重启
• 🔌 支持多个供应商配置管理
• 📋 支持 MCP 配置同步
• 🖥️ 支持 WSL 环境穿透配置

使用：安装后在应用主界面或系统托盘选择所需的站点资源即可切换。CLI 使用需重启 Claude Code，插件版可即时生效。

教程参考资源：

• cc-switch 官方文档
• cc-switch 知乎教程
• cc-switch 掘金深度指南

API 密钥配置关键信息

在配置 API 时，最重要的两个参数是：

• API Key（认证凭证）
• 请求地址（API 端点）

国内 API 服务对比

除官方渠道外，也可选择国内 API 服务提供商。以下列出主要选择：

推荐做法：优先使用官方渠道或 cc-switch 工具进行配置管理，确保安全性和稳定性。如需尝试国内服务，可先用免费额度体验。

2.3.4 配置文件结构

Claude Code 的配置分为全局和项目两级，理解这个结构对后续章节（CLAUDE.md、Commands、Hooks 等）很重要：

~/.claude/ ← 全局配置目录（所有项目共享） ├── config.json ← 全局配置文件 ├── auth-token.json ← 认证令牌 ├── trusted-directories.json ← 信任的目录列表 ├── cache/ ← 缓存目录 └── logs/ ← 日志目录 项目目录/.claude/ ← 项目级配置（仅当前项目生效） ├── config.json ← 项目配置（覆盖全局同名配置） ├── commands/ ← 自定义命令（第03章详解） ├── skills/ ← 自定义技能（第06章详解） └── hooks/ ← 自定义钩子（第05章详解） 

Claude Code 的核心优势在于：

1. 自然语言交互：不需要记复杂的命令，说人话就行
2. 主动执行能力：不只是建议，而是直接帮你改代码、创建文件
3. 上下文理解：理解项目结构，给出符合项目规范的代码
4. 多模态支持：可以处理图片、分析截图

记住这句话：Claude Code 最大的优势是理解自然语言，所以直接说出你的需求，做好指挥官，让它为你工作！

---

官方文档与教程

• 最适合新手的 Claude Code、MCP、Skills 全套教程
• ‬‬⁠⁠⁠‌⁠‍‬‌‬‬‍⁠‌⁠‌⁠‬⁠‍Claude code 专区 - 飞书云文档

---

欢迎在评论区分享你的使用技巧！

作者简介：一名正在实习的Java开发工程师，热爱技术分享，专注于性能优化和系统架构设计。

觉得有用的话可以点点赞 (/ω＼)，支持一下。

如果愿意的话关注一下。会对你有更多的帮助。

每周都会不定时更新哦 >人< 。

版权声明：本文为原创技术文章，转载请注明出处。