第一章:从零到起飞,10分钟让AI为你写代码

第一章:从零到起飞,10分钟让AI为你写代码 第一章从零到起飞10分钟让AI为你写代码目录1. 前言2. 快速上手第一次使用Claude Code2.1 环境准备必须先完成2.1.1 安装 Git必需2.1.2 安装 Node.js必需2.1.3 获取 API 密钥2.2 安装 Claude Code2.2.1 方案一官方推荐安装推荐2.2.2 方案二一键智能安装 ZCF推荐新手2.2.3 方案三IDE 扩展安装VS Code / Cursor / IDEA2.3 首次启动与配置2.3.1 启动参数速查2.3.2 常见报错Unable to connect to Anthropic services2.3.3 推荐使用 cc-switch 配置和多 API 源快速切换2.3.4 配置文件结构3. 核心命令速查表3.1 高频命令建议收藏3.2 快捷操作4. 总结参考资料下一步学习1. 前言Claude Code 是 Anthropic 推出的革命性 AI 编程助手它不是简单的代码补全工具而是一个能够理解你的需求、主动思考、执行操作的编程伙伴。与传统 AI 工具不同Claude Code 直接在终端运行可以读写文件、执行命令、分析代码真正做到说人话干实事。本文将通过实际场景带你快速掌握 Claude Code 的核心用法。适用人群前端/后端开发者、技术写作者、代码审查者、任何想提升编程效率的人2. 快速上手第一次使用Claude Code2.1 环境准备必须先完成在安装 Claude Code 之前你需要确保系统满足以下条件2.1.1 安装 Git必需下载地址git-scm.com按默认步骤安装。关键配置设置环境变量CLAUDE_CODE_GIT_BASH_PATHD:\Program Files\Git\bin\bash.exe根据你的 Git 安装路径调整验证安装git --version2.1.2 安装 Node.js必需下载地址nodejs.org安装 Node.js 18 及以上版本。验证安装node -v npm -v2.1.3 获取 API 密钥Claude Code 需要 官方账号登录 或者 API 密钥才能运行你有两种选择。API Key 是一串以sk-ant-开头的密钥字符串格式类似sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx方式一官方渠道访问 Anthropic Console注册账户三种方式任选Google 账号登录推荐最快邮箱 密码注册GitHub 账号登录在API Keys页面创建新密钥复制并妥善保存只显示一次手机验证提示注册时可能需要手机验证支持中国大陆号码86成功率约 80%。如果多次收不到验证码可尝试语音验证或使用 Google Voice 等虚拟号码。方式二国内中转站推荐国内用户 官方 API 需要海外信用卡且价格较高国内用户可以选择以下中转站价格更优惠、支付更方便仅个人使用也可以通过监控平台 RelayPulse - 实时监测API中转服务可用性矩阵 选择使用中转站用多少充多少~平台注册链接AnyRouter公益https://anyrouter.top/register?affxzkVgemai 哈基米https://api.gemai.cc/register?affOdrbLinkapihttps://linkapi.ai/register?aff1rM2Ikunhttps://api.ikuncode.cc/register?affl978ClaudeCNhttps://claudecn.top/register?affp0mtDuckCodinghttps://duckcoding.com/register?affHMtz福利提示通过上方链接注册你我都能获得额外额度2.2 安装 Claude Code2.2.1 方案一官方推荐安装推荐第一步安装 Claude Code 参考官方Quickstart - Claude Code Docs选择适合你的系统的安装脚本系统安装命令macOS、Linux、WSLcurl -fsSL https://claude.ai/install.shWindows PowerShellirm https://claude.ai/install.ps1Windows CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd install.cmd del install.cmd官方安装会自动更新保持最新版本。第二步登录账户启动 Claude Code 并登录claude # 首次使用会提示登录 /login # 按照提示完成账户登录支持的账户类型✅ Claude Pro、Max、Teams、Enterprise推荐✅ Claude ConsoleAPI 访问需要预付费额度✅ Amazon Bedrock、Google Vertex AI、Microsoft Foundry企业云服务登录后凭证会自动保存无需重复登录。需要切换账户时使用/login命令。2.2.2 方案二一键智能安装 ZCF推荐新手什么是 ZCFZero-Config Code Flow一个为 Claude Code 设计的零配置工具。它会自动为你 安装 Claude Code 配置 API 和认证 导入主流工作流模板 安装 主流MCP 服务 支持中文界面一键启动npx zcf按照交互菜单提示选择语言 → 选择完整初始化 → 自动配置完成参考图片教程参考资源ZCF 官方文档ZCF 博客园教程ZCF 知乎专栏2.2.3 方案三IDE 扩展安装VS Code / Cursor / IDEA除了终端命令启动你也可以在编辑器内通过扩展/插件使用 Claude Code获得可视化界面和深度集成体验。VS Code官方扩展按Ctrl/Cmd Shift X打开扩展市场搜索Claude Code找到 Anthropic 官方发布的扩展点击 Install安装后左侧活动栏出现 ⚡ 火花图标点击即可打开 Claude Code 面板扩展相比终端 CLI 的额外能力功能说明侧边栏面板代码和对话分离互不干扰内联差异显示修改内容实时高亮Checkpoint 回滚按 Esc 两次可回退到上一个检查点提及智能引用文件和函数参考文档https://code.claude.com/docs/en/vs-codeCursorVSIX 手动安装Cursor 基于 VS Code但 Claude Code 扩展无法自动检测 Cursor需要手动安装从 VS Code Marketplace 下载 Claude Code 扩展的 VSIX 文件在 Cursor 中安装cursor --install-extension /path/to/claude-code.vsix或直接将 VSIX 文件拖拽到 Cursor 的扩展面板重启 Cursor左侧出现 Claude Code 图标即成功详细教程https://www.cursor-ide.com/blog/claude-code-cursor-extension-guideIntelliJ IDEAClaude Code GUI 插件Claude Code GUI 是一款 JetBrains 市场 4.8 高评分的可视化界面插件将 Claude Code 和 OpenAI Codex 双重 AI 工具直接整合到 IntelliJ IDEA 中。按Ctrl/Cmd ,打开设置 → Plugins → Marketplace搜索Claude Code GUI点击 Install重启 IDEA工具窗口中出现 Claude Code 面板即成功2.3 首次启动与配置# 进入你的项目目录 cd ~/my-project # 启动 Claude Code claude❌ 配置对应环境变量 - 默认一次性配置 或者 系统级别配置建议采用 cc-switch 工具进行管理下文介绍环境设置临时环境变量的命令生效范围Linux/macOS 终端export 变量名值当前终端会话Windows CMDset 变量名值当前 CMD 窗口Windows PowerShell$env:变量名值当前 PowerShell 会话export ANTHROPIC_BASE_URLhttp:xxx.xx export ANTHROPIC_AUTH_TOKENAPI_Key2.3.1 启动参数速查除了直接输入claude启动还可以通过参数控制启动行为参数作用适用场景claude默认启动会询问权限日常使用claude --dangerously-skip-permissions跳过权限询问直接执行信任的个人项目快速开发claude -p 你的问题直接提问模式回答后退出快速查询不需要对话claude --headless无界面模式脚本自动化**关于 **--dangerously-skip-permissions这个参数会让 Claude Code 跳过所有权限确认直接执行读写文件、运行命令等操作。Anthropic 官方称之为“Safe YOLO mode”。名字里带 “dangerously” 是因为 AI 可能误修改代码、删除文件或执行非预期命令跳过确认意味着你来不及阻止。场景是否推荐自己的学习/个人项目代码已提交 Git✅ 可以用只读操作查询、分析✅ 可以用公司项目、开源项目❌ 不要用第一次使用 Claude Code❌ 不要用包含敏感数据的项目❌ 不要用新手建议前 1 个月不要加这个参数。让 AI 每次操作都问你既能学到它在做什么又能避免误操作。等你熟悉了 Claude Code 的行为模式后在个人项目中再考虑使用但务必先把代码提交到 Git确保随时可回滚。2.3.2 常见报错Unable to connect to Anthropic services国内第一次用 Claude Code大概率会遇到这个报错Unable 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 对象中加入以下字段注意给上一行末尾加逗号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 安装包。Windowshttps://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 服务提供商。以下列出主要选择服务商特点价格模式适用场景官方渠道Anthropic Console最稳定、功能完整、更新及时付费生产环境、企业应用LongCat AI美团旗下免费额度、界面简洁、支持基础功能免费 付费初学者试用、轻量应用国内中转站多家功能兼容、定价灵活、快速响应多为付费特定需求、成本优化推荐做法优先使用官方渠道或 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章详解3. 核心命令速查表3.1 高频命令建议收藏命令功能使用场景/init初始化项目文档第一次使用时让AI理解项目结构/clear清空对话历史切换任务时释放上下文节省token/compact压缩对话历史会话过长时保留摘要继续对话/add-dir添加工作目录需要同时操作多个项目时/export导出对话记录保存重要的对话内容/model切换AI模型切换到 Opus 或其他模型/memory编辑记忆文件自定义AI的长期记忆/resume恢复上次对话继续之前的工作3.2 快捷操作操作快捷键/语法说明引用文件文件名让AI关注特定文件粘贴图片Ctrl V发送截图让AI分析换行输入Shift Alt Enter多行输入执行Bash!ls -l直接执行系统命令历史命令↑ / ↓快速切换历史输入中断执行Esc停止AI当前操作4. 总结Claude Code 的核心优势在于自然语言交互不需要记复杂的命令说人话就行主动执行能力不只是建议而是直接帮你改代码、创建文件上下文理解理解项目结构给出符合项目规范的代码多模态支持可以处理图片、分析截图记住这句话Claude Code 最大的优势是理解自然语言所以直接说出你的需求做好指挥官让它为你工作参考资料官方文档与教程最适合新手的 Claude Code、MCP、Skills 全套教程‬‬⁠⁠⁠‌⁠‍‬‌‬‬‍⁠‌⁠‌⁠‬⁠‍Claude code 专区 - 飞书云文档下一步学习章节主题你将学到第02章30命令与快捷键编程效率直接翻倍Slash 命令全解析、快捷键速查、Token 管理技巧第03章告别重复提示词自定义Commands自定义命令编写、复杂工作流设计、命令分享第04章让Claude连上一切——MCP与Hooks实战MCP 协议原理、主流服务接入、自动化钩子欢迎在评论区分享你的使用技巧如果觉得有用请点赞收藏 作者简介一名正在实习的Java开发工程师热爱技术分享专注于性能优化和系统架构设计。觉得有用的话可以点点赞 (/ω)支持一下。如果愿意的话关注一下。会对你有更多的帮助。每周都会不定时更新哦 人 。版权声明本文为原创技术文章转载请注明出处。