【跟我学 AI 编程】1AI 编程概述5Claude Code 快速指南【跟我学 AI 编程】5 Claude Code 快速指南1. Claude Code 概述1.1 什么是 Claude Code1.2 安装方式2. 安装 Claude Code2.1 一键安装2.2 安装 Node.js 和 Git2.3 手动安装 Claude Code2.4 国内用户区域校验2.5 Claude Code 登录3. 接入第三方模型4. Claude Code 基础知识4.1 核心架构4.2 交互模式4.3 基本命令5. 小结1. Claude Code 概述1.1 什么是 Claude CodeClaude Code 是一个代理编码工具可以读取你的代码库、编辑文件、运行命令并与你的开发工具集成完成代码编写、调试、重构等任务。可在终端、IDE、桌面应用和浏览器中使用。Claude Code 是一个由 AI 驱动的编码助手可帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库可以跨多个文件和工具工作以完成任务。Claude Code 定位不是聊天而是在本地代码仓库中执行高权限、可上下文感知的工程任务。与 ChatGPT 在聊天窗口里写几段代码不同Claude Code 直接在终端运行能够读取整个项目的代码理解文件之间的关系直接修改代码文件运行测试并根据反馈修改代码。对于编程新手Claude Code 可以极大地降低学习门槛提升开发效率。对于团队Claude Code 可以通过 Skills 统一团队规范、自动检查代码质量。Claude Code 的主要特征上下文感知不仅理解单个文件而是理解整个项目结构。工程化导向关注可维护性、规范、测试而不是一次性代码。可定制行为通过 Skills技能包让 AI 遵守你的规则。Claude Code 的核心能力代码理解与解释多文件上下文分析工程级代码修改通过 Skills(技能包)扩展能力相关资源官方文档https://code.claude.com/docs/en/overview中文文档https://code.claude.com/docs/zh-CN/overviewGithub 开源https://github.com/anthropics/claude-codeClaude Code 中文站https://claude-zh.cn/guide/getting-started.htmlClaude Code 菜鸟教程https://www.runoob.com/claude-code/claude-code-install.html1.2 安装方式Claude Code 提供多种安装和运行方式命令行方式CLI基本运行方式功能完整集成度高适用于终端工作流、脚本编写、远程服务器提供完整功能集支持 Agent SDK、计算机使用在 macOS 上Pro 和 Max、第三方提供商需要熟悉命令行操作适合有一定基础的开发者Web 方式无需安装打开浏览器即可使用适合新手体验支持 Anthropic 托管云、断开连接后继续运行需要复制粘贴代码到对话框进行交互IDE 集成方式适合程序开发在 VS Code、JetBrains 等 IDE 内工作无需切换到终端支持 Diff 查看器、选择共享、终端会话、文件上下文等功能Desktop 方式适合视觉审查、并行会话、托管设置支持 Diff 查看器、应用预览、Pro 和 Max 上的计算机使用和 Dispatch2. 安装 Claude CodeClaude Code CLI 方式功能完整、使用稳定最能体现 Claude Code 的设计初衷也便于接入第三方 AI 模型。2.1 一键安装本小节只供参考官方提供了一键安装脚本但在安装之前需要准备Claude 账号 。一键安装脚本会自动检测并安装 Node.js如未安装安装 Claude Code配置 ~/.claude/settings.json跳过引导 禁用非必要流量 禁用 co-authored-by引导配置 API 密钥但由于 Anthropic 官网启用了严格的 Cloudflare 盾反爬虫保护以及国内特殊网络条件和环境配置国内用户使用一键安装脚本可能会报错“Invoke-RestMethod : 远程服务器返回错误: (403) 已禁止 或抛出包含大量乱码的 WebException。”一键安装脚本的执行命令如下只供参考并不推荐使用。# Windows PowerShellirm https://claude.ai/install.ps1|iex# Windows CMDcurl-fsSLhttps://claude.ai/install.cmd-oinstall.cmdinstall.cmddel install.cmd# macOS、Linux、WSLcurl-fsSLhttps://claude.ai/install.sh|bash2.2 安装 Node.js 和 Git手动安装 Claude Code 则需要先安装 Node.js 和 Git。2.2.1 安装 Node.js下载 Node.js 安装包。访问 Node.js 官网https://nodejs.org根据系统下载安装包如 Windows 系统选择 Windows Installer.msi下载。安装 Node.js。双击下载的 Node.js 安装包按照安装向导完成安装。在 “选择组件” 页面要确保勾选以下选项Node.js runtime核心运行组件npm package managernpm包管理器Add to PATH自动添加环境变量Automatically install the necessary tools自动安装必要工具npm 是 Node.js 的包管理器其代码直接集成在 Node.js 的安装包中。安装 Node.js 时npm 会作为依赖项自动安装到系统中。Node.js 安装测试以管理员身份打开 PowerShell执行node -v验证安装是否成功。如果返回当前安装的 Node.js 版本号如 “v24.14.1”说明已成功安装。执行npm -v验证安装是否成功。如果显示 “在此系统上禁止运行脚本”这是 Windows PowerShell 执行策略限制 导致的问题。在 PowerShell 中执行如下命令解除限制。# 放开脚本执行限制Set-ExecutionPolicy RemoteSigned-ScopeCurrentUser2.2.2 安装 Git For Windows在 Windows 上原生安装 Claude Code 需要通过 Git Bash。下载 Git 安装包。访问 Git 官网https://git-scm.com点击选择与系统匹配的安装程序例如Git for Windows/x64 Setup下载安装包。安装 Git。双击下载的 Git 安装包按照安装向导完成安装。除安装路径外其它都可以选择默认选项。验证 Git 环境。安装完成后需验证 PATH 环境变量中是否已包含 Git 的可执行路径。打开 PowerShell 执行git -v验证安装是否成功。如果会返回当前安装的 Git 版本号如 “git version 2.53.0.windows.1”说明安装成功。配置 Git 用户设置。在开始菜单找到并打开 Git Bash弹出 Git 命令行窗口。1输入如下命令可以设置用户信息。2如果使用代理需要为 Git 配置代理。2.3 手动安装 Claude Code安装 Claude Code打开 PowerShell 执行如下安装命令。# 设置国内镜像源淘宝镜像npmconfigsetregistry https://registry.npmmirror.com# 安装稳定版本2.1.138npmmirror 可用的最新版npminstall-ganthropic-ai/claude-code2.1.138# 切回官方源重要避免 Claude Code 自动更新时拉到不完整的平台包npmconfigsetregistry https://registry.npmjs.org说明1查看 npmmirror 上的最新版npm view anthropic-ai/claude-code version。2安装测试执行claude --version验证安装是否成功。如果返回 Claude Code 版本号如 “2.1.138 (Claude Code)”说明已成功安装。更新 Claude Code执行claude install或claude update命令更新 Claude Code。Claude Code 在启动和运行时会自动检查更新后台下载完成后下次启动即生效。如果不需要自动更新可以在 settings.json 的 env 中禁用{env:{DISABLE_AUTOUPDATER:1// 设为1禁用自动更新0或删除该行则恢复自动更新}}卸载 Claude Codenpm uninstall -g anthropic-ai/claude-code以上命令只卸载了可执行程序配置文件和历史记录不会自动删除。如果你希望完全清除所有数据包括设置、授权工具、MCP 服务器配置和会话历史需要额外执行以下命令# 删除全局用户设置和状态Remove-Item-Path$env:USERPROFILE\.claude-Recurse-ForceRemove-Item-Path$env:USERPROFILE\.claude.json-Force# 删除当前项目的本地设置在项目目录中执行Remove-Item-Path.claude-Recurse-ForceRemove-Item-Path.mcp.json-Force2.4 国内用户区域校验在项目目录中输入claude命令启动 Claude Code。首次启动时Claude Code 会引导你完成登录。claude. 区域校验处理Claude Code 默认请求官方 API 域名并在启动时做区域校验。由于 Anthropic 未在中国大陆开放服务国内用户启动 Claude Code 时可能出现报错【Claude Code might not be available in your country】方案 1修改配置跳过首次地区校验部分环境。编辑配置文件 “~/.claude.json” 加入属性 “hasCompletedOnboarding”: true保存后重新运行 claude可以跳过初次引导里的地区检查。但这并不等于“绕过官方区域策略”若后续请求仍直连官方且 IP/账号受限仍然会失败。方案 2通过代理或 HTTPS_PROXY 出口到支持地区。在 Claude Code 配置或环境变量里设置代理端口。1 测试本机环境可用的代理端口。我的代理端口为 “7890”用户可以根据自己的设备和软件修改。netstat-ano|findstrLISTENING|findstr:7890如果代理端口正确将会输出包含 “LISTENING” 的信息。2设置 HTTPS_PROXY 环境变量永久生效。[Environment]::SetEnvironmentVariable(HTTP_PROXY,http://127.0.0.1:7890,User)[Environment]::SetEnvironmentVariable(HTTPS_PROXY,http://127.0.0.1:7890,User)以上永久设置命令在当前 PowerShell 窗口不会立即生效必须关闭当前窗口并重新打开一个新的 PowerShell 窗口才能读取到新设置。3验证 HTTPS_PROXY 环境变量永久生效。$env:HTTP_PROXY$env:HTTPS_PROXY如果设置生效将会输出已设置的代理地址如“http://127.0.0.1:7890”。4验证代理连通性确保代理正常工作curl.exe-xhttp://127.0.0.1:7890 https://api.anthropic.com-Icurl.exe-xhttp://127.0.0.1:7890 https://ifconfig.me第一条命令应输出类似 HTTP/2 200 或 HTTP/2 302 的状态码非超时报错第二条命令应返回非中国 IP 地址表明代理已生效。5检测 Claude Code 安装。重新运行 claude 命令验证是否可连接。方案3修改 ANTHROPIC_BASE_URL 指向可用接入点。把 ANTHROPIC_BASE_URL 改成国内可直连的接入点也成为第三方 API 中转服务。它把 Claude 等国外 AI 模型的能力封装成国内开发者能更方便访问和支付的 API。这种方式使用简单方便但并非官方提供使用时也存在一些风险例如假冒模型、停止服务。exportANTHROPIC_BASE_URLhttps://接入点域名exportANTHROPIC_API_KEYsk-xxxx2.5 Claude Code 登录首次登录流程在项目目录中启动 Claude Codeclaude首次启动时Claude Code 会进入交互式配置按提示完成即可。也可以在进入 Claude Code 界面后手动输入登录命令/login按照终端中的提示完成登录授权即可。登录后凭据会保存在本地下次启动无需重复登录。如果需要切换账号重新执行 /login 即可。支持的账号类型Claude 支持使用以下任意一种账号类型登录1Claude 订阅账号推荐Claude Pro个人专业版Claude Max最高级别订阅Claude Teams团队版Claude Enterprise企业版2Claude Console 账号API 访问通过 API 访问使用预付费积分计费适合开发者和需要程序化访问的场景同一个邮箱可以同时拥有订阅账号和 Console 账号两种类型自动创建工作区Console 账号首次使用 Claude Console 账号认证 Claude Code 时系统会自动在你的 Console 中创建一个名为 “Claude Code” 的工作区用于集中跟踪所有 Claude Code 的 API 使用成本便于管理组织内多人的 Claude Code 使用情况。3. 接入第三方模型Claude 需要开通订阅账号才能登录而国内用户并不能订阅 Claude 账号。Claude Code 原生支持通过 OpenAI 兼容接口接入第三方模型豆包 / 通义 / DeepSeek 等核心是用环境变量把请求转发到第三方模型 API从而将模型替换为第三方模型权限与状态管理保持不变实现无缝接入。Claude Code 会读取三个关键环境变量ANTHROPIC_BASE_URL替换成第三方模型的 OpenAI 兼容地址如豆包 https://ark.cn-beijing.volces.com/api/v3ANTHROPIC_API_KEY填第三方模型 API API Key用户在豆包 API 申请的 KeyANTHROPIC_MODEL指第三方模型 API包模型名如 doubao-pro-32k将第三方模型豆包 / 通义 / DeepSeek 等接入 Claude Code 的操作步骤如下获取 第三方模型的 API Key。以 豆包火山引擎大模型为例登录 火山引擎进入「火山方舟」控制台。在左侧菜单中选择「开通管理」选择豆包模型并开通在左侧菜单中选择「API Key 管理」选择创建 Key 并复制保存生成的API key格式示例sk-******。注意1DeepSeek API 采用 按需付费模式以“百万 tokens”为单位计费2API Key 是一组加密字符串仅在创建时可见并可复制系统不会再次显示。3API Key 属于重要的数字资产请勿公开或泄露以免造成安全风险或资金损失。把 第三方模型 API 配置到环境变量中。在 WindowsPowerShell永久配置 API 的命令如下。使用时请根据自己选择的模型、用户 Key修改配置中的相关参数。接入地址可以从申请 API Key 的网站说明中查找。# [Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, 接入地址, User)[Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL,https://ark.cn-beijing.volces.com/api/v3/chat/completions,User)# [Environment]::SetEnvironmentVariable(ANTHROPIC_API_KEY, 你的 API Key, User)[Environment]::SetEnvironmentVariable(ANTHROPIC_API_KEY,ark-******,User)# [Environment]::SetEnvironmentVariable(ANTHROPIC_MODEL, 模型名称, User)[Environment]::SetEnvironmentVariable(ANTHROPIC_MODEL,doubao-seed-2-0-lite-260215,User)以上永久设置命令需要重启终端生效。重启终端输入如下命令检查 API Key 设置是否生效。$env:ANTHROPIC_BASE_URL$env:ANTHROPIC_API_KEY$env:ANTHROPIC_MODEL说明在 macOS/Linuxzsh配置 API 可以参考如下的命令。echoexport ANTHROPIC_BASE_URL接入地址~/.zshrcechoexport ANTHROPIC_API_KEY你的 API Key~/.zshrcechoexport ANTHROPIC_MODEL模型名称~/.zshrcsource~/.zshrc再次输入 “claude” 启动 Claude Code。在启动页面可以看到接入的第三方模型名称“doubao-seed-2-0-lite-260215”。输入 “/status”查看状态。/status 是 Claude Code 内置状态查看命令可实时展示当前会话版本、会话 ID、工作目录、认证方式、API 接口地址、代理、当前挂载的第三方模型及配置来源等核心运行与接入信息。4. Claude Code 基础知识4.1 核心架构Claude Code 是一个面向软件工程任务的分层 Agent 运行时核心是由查询引擎驱动的模型 - 工具循环并通过权限、上下文管理与扩展机制实现安全、可控、可扩展的终端 AI 编程助手。Claude Code 整体架构入口层CLI Entry多启动入口交互 / 非交互 / IDE负责环境初始化、配置加载与会话管理。终端 UI 层基于 InkReact 的流式渲染引擎支撑 REPL 交互、状态展示与实时输出。核心引擎层QueryEngine系统大脑以while (tool_call)循环驱动 “模型调用→工具执行→结果回传” 的迭代流程处理流式消息、预算控制、重试与成本管理。工具系统层内置 30 工具Bash/Read/Edit/Grep 等支持 MCP 协议扩展外部工具工具执行器负责权限校验与流式执行。服务层提供 API 客户端支持第三方模型、权限系统7 种模式 ML 分类器、上下文压缩5 层流水线、记忆管理与认证服务。状态管理层会话持久化JSONl 追加写入、应用状态存储与多会话隔离。核心组件与关键机制Agent 循环queryLoop()异步生成器实现模型自主决策工具调用无复杂编排遵循 “Less scaffolding, more model” 设计哲学。权限安全默认拒绝 7 种权限模式 ML 自动分类器细粒度控制工具与文件访问支持危险模式仅沙箱。上下文管理200K 令牌窗口五级压缩预算削减→剪枝→微压缩→折叠→自动压缩避免长会话熵增。扩展能力MCP外部服务 / 工具深度集成如豆包 API。插件功能封装与分发ZIP / 目录加载。技能Skills领域专用指令如代码审查。Hooks后台事件拦截不占上下文。多智能体Task 工具生成隔离子 Agent仅返回摘要并行处理子任务。4.2 交互模式Claude Code 提供的不同会话运行形态用来适配日常聊天、一次性执行、接续旧会话、IDE 联动、极简纯净运行 等不同使用场景。交互式 REPL 模式默认模式启动直接输入 “claude”启动一个持续的对话式编程会话。全程交互式聊天适用于日常编码、项目重构、多轮需求沟通、调试排障。# 进入交互模式claude# 在指定目录启动claude--cwd/path/to/project# 携带初始提示启动claude解释一下这个项目的架构一次性输出模式Print Mode启动输入 “claude -p 提示词”。自动跳过工作区信任弹窗执行完毕后直接退出。适合命令行流水线、批处理调用第三方模型脚本调用和自动化运行。# -p 或 --print 标志claude-p列出所有 TODO 注释# 管道传入代码进行审查catmain.py|claude-p审查这段代码# 输出为 JSON 格式适合自动化解析claude-p分析代码质量--output-format json# 流式输出 JSONclaude-p分析依赖关系--output-format stream-json会话接续 / 恢复模式启动claude -c 继续当前目录最近一次会话claude -r 交互式选择历史会话恢复claude -r 会话ID 指定 ID 恢复会话复用历史上下文、完整对话记忆可分叉会话–fork-session。适用于接续未完成任务、多分支会话隔离。# 继续上次对话claude--continue# 在会话内用斜杠命令恢复/resume# 通过 Session ID 恢复远程会话claude--teleportsession-id自动执行模式Auto Mode启动会话权限模式设为 auto默认常规会话即自动启用。智能自主判断任务风险低风险操作自动放行执行无需逐次人工确认。适用于日常简单代码编写、小范围 Bug 修复、常规文件编辑、轻量工程操作、无需人工审批的常规开发场景。# 跳过权限提示仅用于可信容器环境claude --dangerously-skip-permissions# 结合一次性模式使用CI/CD 场景claude-p运行测试并修复失败--dangerously-skip-permissions⚠️ 安全警告“–dangerously-skip-permissions” 仅应在隔离的容器环境中使用切勿在本地开发机器上无监督使用IDE 联动集成模式启动claude --ide可以自动发现本地 VS Code 等 IDE可以读取工程文件、直接在 IDE 内改代码、同步工程上下文。适用于IDE 内无缝编码脱离纯终端操作。4.3 基本命令基础命令命令说明claude启动交互式 REPL 会话claude “提示词”携带初始提示启动会话claude -p “提示词”一次性执行并退出Print Modeclaude --continue继续上次对话claude --version显示版本号claude --help显示帮助信息claude auth login登录 Anthropic 账号claude auth logout退出登录claude auth status查看认证状态claude agents列出所有已配置的代理claude remote-control启动远程控制模式供 IDE/CI 调用会话控制标志说明-p / --print一次性执行模式执行后退出–continue继续上次对话–resume通过 Session ID 恢复特定会话–teleport从远程Web拉取会话到本地继续–cwd指定工作目录–no-auto-commit禁止自动提交 Git 更改模型与模式控制标志说明–model指定使用的模型sonnet / opus / haiku–plan以计划模式启动不立即执行–thinking启用扩展思考模式–fast使用 Haiku 模型快速执行探索性任务输出控制标志说明–output-format text默认文本格式输出–output-format jsonJSON 格式输出适合脚本–output-format stream-json流式 JSON 输出–verbose显示详细输出含完整对话–no-verbose精简输出–max-turns限制最大对话轮次自动化场景权限控制标志说明–allowedTools “Read,Write”仅允许指定工具–disallowedTools “Bash”禁止使用指定工具–dangerously-skip-permissions跳过所有权限提示仅限可信环境项目管理命令说明/init初始化项目生成 CLAUDE.md 配置文件每个新仓库都应执行/compact压缩对话上下文保留核心信息释放空间/clear清空当前对话上下文重新开始/resume恢复上次中断的对话/export [文件名]导出当前对话到文件或剪贴板/rewind撤回到上一个操作状态代码时间旅行功能管理命令说明/permissions查看和更新工具权限设置/config打开配置界面模型、隐私等设置/privacy-settings管理数据共享和存储设置/output-style配置响应格式样式/hooks通过交互菜单配置 Hooks推荐方式快捷键快捷键说明Enter提交当前输入Escape停止 Claude 当前执行不是退出CtrlC完全退出 Claude CodeEscape × 2显示历史消息列表可跳转到任意位置↑ / ↓浏览历史输入CtrlL清屏保留上下文5. 小结本文带大家完成Claude Code的零基础上手明确其终端AI编程助手的核心定位详解了多场景安装方法及国内用户适配、登录要点确保顺利部署。针对国内用户最关注的适配问题重点讲解第三方模型豆包接入方法与技巧通过环境变量配置实现无缝切换让Claude Code 真正落地可用。下一篇我们将实战教学如何在VS Code、PyCharm中对接Claude Code实现IDE与AI编程的无缝联动提升开发效率。版权声明转发必须注明原文链接【跟我学 AI 编程】5 Claude Code 快速指南 (https://youcans.blog.csdn.net/article/details/160967115)Copyright by youcansqq.com 2026Crated2026-05推荐参考Claude Code 中文站https://claude-zh.cn/guide/getting-started.htmlClaude Code 菜鸟教程https://www.runoob.com/claude-code/claude-code-install.html