Appearance
Claude Code国内怎么装和用?安装步骤、终端命令与Codex/Cursor选择【2026年8月】
最后更新:2026-08-12
国内 Claude 与多模型 AI 平台推荐
国内使用 Claude、长文本写作或多模型工具时,可以按任务选择以下第三方平台:
- 🔥 国内直连/全能多模型(lazyman): lazymanchat.com据平台提供信息已运营三年;平台标称支持 GPT-5.6、Claude 5.0、Gemini 3.1 Pro、Grok 4.5 与 GPT-Image-2,无需翻墙。
- 🎨 多模型/多种绘图(LuckAI): luckaichat.com平台标称支持 GPT、Claude、Gemini、DeepSeek、Grok,以及 MJ、Nano Banana 与 GPT-Image-2 绘图。
以上均为邀请链接。lazyman 与 LuckAI 均为第三方服务,不是相关模型厂商的官方网站或官方产品;所列型号与能力来自平台标称,具体功能与可用性以登录后的实际页面为准。请勿上传账号密码、API Key、合同或其他敏感资料。
安装方式、命令与选择建议均按当前官方文档重新核验。
本站为独立教程博客,并非 Anthropic、OpenAI 等模型厂商的官方网站,也不提供 AI 模型对话功能。文中涉及的安装与登录都在你自己的电脑和官方产品上完成,手机用户请打开对应官方网站或客户端使用。
先给结论:Claude Code 是 Anthropic 推出的终端智能体编程工具,通过 npm 全局安装(包名 @anthropic-ai/claude-code),装好后在项目目录里运行 claude 命令,用 Anthropic 账号登录即可开始工作。国内可以正常完成安装,但登录和实际调用依赖能连上官方服务,直连往往不稳定,需要合规网络环境。它和 Codex、Cursor 的核心差别在生态与集成方式,选择主要看你手上已有哪家订阅、团队习惯,以及要不要深度 IDE 集成。
Claude Code 是什么:终端里的智能体编程工具
Claude Code 是 Anthropic 官方的 agentic coding(智能体编程)工具。和把代码复制到网页对话框相比,它直接跑在你的终端里,能理解整个代码库、编辑文件、运行命令,并把多步骤任务串起来执行。官方产品页(claude.com/product/claude-code)把它定位为“能理解你的代码库、编辑文件、运行命令”的编程智能体。
它的特点是“在你的开发环境里干活”,而不是只回答问题:
- 读代码:可以扫描目录结构、定位相关文件,回答“这个功能在哪实现”“这段逻辑怎么串起来”。
- 改文件:直接在本地文件上做修改,改动前一般会先展示计划并请求确认。
- 跑命令:能执行构建、测试、git 等命令,把结果反馈回对话继续推进。
- 长任务:把“修 Bug、写测试、重构”拆成多步,边执行边报告。
如果你想先系统了解 Claude 在中文场景里的整体用法,可以配合阅读Claude 国内使用教程 2026:中文写作、总结、代码场景怎么用,再回到本文专注 Claude Code 这一条终端工作流。
使用前提:Anthropic 账号、付费与支持平台
安装之前,先确认几个前提,避免装好却跑不起来:
- 系统与运行环境:官方文档(code.claude.com/docs)说明支持 macOS、Linux 与 Windows。安装依赖 Node.js,建议使用 18 及以上的 LTS 版本,并确保
npm命令可用。 - 账号:Claude Code 需要登录 Anthropic 账号才能调用模型。你可以用 Claude 订阅(例如 Pro/Max 一类计划)登录,也可以用 Anthropic API Key 按用量计费。
- 付费门槛:工具本身免费安装,真正产生费用的是模型调用。具体的计划名称、额度和计费方式以 claude.com 与 docs.anthropic.com 登录后的实际页面为准,本文不写价格。
- 网络:Anthropic 的登录与 API 服务在国内直连通常不稳定,需要合规的网络环境才能顺利登录和调用。
这一步的判断很简单:先想清楚你用订阅登录还是用 API Key,再确认电脑上 Node.js 环境是否就绪,最后再动手装。
国内安装步骤:npm 安装、登录与首次运行
下面是一条可核验的标准路径,命令以官方 GitHub 仓库(github.com/anthropics/claude-code)与文档为准。
第一步,确认 Node.js 与 npm:
bash
node -v
npm -v如果没有输出版本号,先到 Node.js 官网安装 LTS 版本。国内 npm 下载慢,可以临时切换淘宝镜像源:
bash
npm config set registry https://registry.npmmirror.com第二步,全局安装 Claude Code:
bash
npm install -g @anthropic-ai/claude-code第三步,进入你的项目目录并启动:
bash
cd your-project
claude第四步,首次运行会引导登录。按提示用 Anthropic 账号完成授权(订阅登录或配置 API Key)。这一步需要能访问官方服务,直连超时时要先解决网络。
第五步,验证是否正常。登录后可以先让它做一个只读任务,比如“总结这个项目的目录结构和核心模块”,确认它能读到文件、正常返回,再逐步放开写文件和跑命令的权限。
安装完成后,如果你还想对照一份把“国内入口、长文写作、Claude Code”打包讲的整合指南,可以看Claude中文版国内使用指南2026:Claude官网入口、Claude Code、长文写作和镜像方案。
常用命令与交互方式速查
Claude Code 的交互分两类:一类是直接用自然语言描述任务,另一类是以 / 开头的斜杠命令。常用命令请以 /help 输出的实际列表为准,下面是典型用法速查。
| 场景 | 输入方式 | 说明 |
|---|---|---|
| 查看可用命令 | /help | 列出当前版本支持的斜杠命令 |
| 初始化项目上下文 | /init | 生成或更新项目说明,帮助它更懂你的代码库 |
| 清空当前对话上下文 | /clear | 开新任务前重置,避免旧上下文干扰 |
| 描述一个开发任务 | 自然语言 | 例如“给 user 模块加分页并写测试” |
| 让它读文件 | 自然语言 | 例如“读一下 src/api 目录,说明主要接口” |
| 退出 | /exit 或 Ctrl+C | 结束当前会话 |
交互上有几个实用习惯:任务描述越具体越好,把框架、语言版本、期望行为、验证方式都讲清楚;一次只推进一件事,改完验证再继续;不确定时先让它“列计划、说风险”,再决定是否执行。
项目工作流:读代码、改文件、跑命令的权限控制
Claude Code 的价值在于能动手,但“能动手”也意味着要管住它的权限。它在编辑文件、执行命令这类有副作用的操作前,通常会先请求你确认,这是官方设计的权限机制。合理的项目工作流是这样的:
- 先只读。让它总结结构、定位问题,不给写权限。
- 再小步改。锁定一个具体改动,让它给出方案和 diff,确认后再应用。
- 每步验证。改完立刻跑测试或构建,确认没引入新问题再继续。
- 用 Git 兜底。在干净的仓库里工作,改动前先提交或建分支,出问题能一键回滚。
一个可以直接套用的任务模板:
text
你是资深全栈工程师。请阅读下面问题并给出修复方案。
项目环境:[框架/语言/版本]
目标:[想实现什么]
报错:[完整报错信息]
关键代码:[相关片段或文件路径]
请先输出:原因分析、最小修改方案、风险点、验证命令;
我确认后你再动手改文件。这种“先计划、后执行、每步验证”的节奏,比一句“帮我把这个项目重构一下”安全得多,也更容易得到可用结果。
在 VS Code 等编辑器里配合使用
很多人习惯 IDE,Claude Code 也能和编辑器配合。最直接的方式是在 VS Code 的集成终端里运行 claude,一边看代码一边让它操作,改动会直接反映在工作区文件上,你在编辑器里就能看到 diff 和 Git 变更。
配合使用时的几个建议:
- 打开 Git 面板盯改动。让它改文件后,先在源代码管理里逐个看 diff,再决定是否保留。
- 用编辑器的搜索定位。你可以先自己找到相关文件,再把路径告诉它,减少它到处扫描的开销。
- 终端和编辑器分屏。左边代码、右边终端对话,效率更高。
具体的 IDE 集成能力(是否有官方插件、支持哪些编辑器)会随版本变化,请以 code.claude.com/docs 的最新说明为准。如果你更偏向 Codex 的 IDE 路径,可以参考本站的 Codex 相关整理来对照工作流差异。
Claude Code vs Codex vs Cursor:场景化怎么选
这是搜索里最高频的对比。三者定位不同,没有绝对优劣,关键是匹配你的场景。
| 维度 | Claude Code | Codex | Cursor |
|---|---|---|---|
| 归属 | Anthropic 官方 | OpenAI 官方 | 第三方 AI 代码编辑器 |
| 形态 | 终端 CLI 智能体 | CLI + 桌面客户端 | 集成 AI 的独立编辑器 |
| 强项 | 长上下文读代码、终端里改项目 | 贴近 GPT 生态、项目自动化 | 编辑器内联补全与对话 |
| 适合谁 | 已用 Claude、喜欢命令行的人 | 已用 GPT/ChatGPT 生态的人 | 想要“开箱即用编辑器”的人 |
| 国内网络 | 依赖 Anthropic 官方服务 | 依赖 OpenAI 官方服务 | 依赖其模型后端 |
选择建议可以这么想:
- 你已经付了 Claude 订阅、喜欢在终端里工作、要读大代码库,选 Claude Code。
- 你在 GPT/ChatGPT 生态里、想要桌面客户端加自动化,看 Codex。
- 你想要一个装好就能用、内联补全体验强的编辑器,试 Cursor。
想看更细的三方对比与国内使用差异,可以读Codex vs Cursor vs Claude Code 2026:AI编程工具怎么选?功能、场景与国内使用对比,以及从代码审查、自动 PR 角度切入的Codex vs Cursor vs Claude Code 2026:AI编程工具、代码审查、自动PR和国内使用。如果你对 Codex 本身还不熟,先看OpenAI Codex是什么?Codex官网入口、CLI、App与使用教程(2026最新)会更顺。
国内网络与登录常见问题排查
国内用户遇到的问题大多集中在网络和环境,可以按下面清单逐条排查:
- npm 安装卡住或超时:先切换国内镜像源,安装完成后再登录。安装用镜像不影响后续调用。
claude命令找不到:确认全局 npm bin 目录在系统 PATH 里,或重开终端让环境变量生效。- 登录页打不开 / 授权失败:这是访问 Anthropic 官方服务受阻,需要合规网络环境,直连经常超时。
- 登录成功但调用报错:检查账号额度是否用尽、订阅或 API Key 是否有效,再看官方状态页有无服务异常。
- Node.js 版本过低:升级到 18 及以上 LTS 版本重装。
- Windows 环境异常:优先确认在原生终端还是 WSL 里运行,两种环境的路径和权限行为可能不同。
需要提醒的是,本文提到的第三方多模型平台是对话类工具,方便在国内做 Claude/GPT 问答和长文写作,但它们不等于 Claude Code 的终端环境。真正要跑 Claude Code 的安装、登录和命令,仍然依赖 Anthropic 官方账号和服务。
安全与代码权限提醒(避坑清单)
- 不要一上来就放开全部权限。让它先只读,确认理解正确再逐步授权写文件和跑命令。
- 一定在 Git 仓库里用。改动前提交或建分支,任何批量修改、删除都能回滚。
- 谨慎对待破坏性命令。涉及删除文件、重置分支、改数据库的操作,务必人工二次确认。
- 别把敏感信息塞进对话。账号密码、私钥、API Key、合同不要贴进任何工具,包括第三方平台。
- 生产环境不直连放权。先在本地或测试环境验证,别让智能体直接操作线上系统。
- 官方渠道下载安装。只用 npm 官方包和官方文档指引,别信第三方“绿色版”“破解版”。
事实边界与信息来源
- 本文的安装命令、支持平台、账号与权限机制,依据 Anthropic 官方资料整理:产品页 claude.com/product/claude-code、文档 code.claude.com/docs、开发者文档 docs.anthropic.com 与开源仓库 github.com/anthropics/claude-code。
- 命令列表、计划名称、计费方式和 IDE 集成能力会随版本更新,请以你登录后看到的官方页面和
/help输出为准,本文不承诺具体价格或长期可用性。 - 文中第三方平台为独立服务,非 Anthropic、OpenAI、Google 或 xAI 官方产品,其型号与能力均为平台标称,可用性以实际页面为准。
- 服务是否正常可参考官方状态页,例如 OpenAI 侧的 status.openai.com 用于对照相关生态服务状态。
常见问题
问:Claude Code 是免费的吗?需要付费账号吗? 答:工具可以免费安装,但运行会消耗额度。你可以用 Claude 订阅登录,也可以用 Anthropic API Key 按用量计费,具体门槛以 claude.com 和 docs.anthropic.com 的实际页面为准。
问:Claude Code 支持 Windows 吗? 答:支持。官方文档说明覆盖 macOS、Linux 和 Windows,Windows 用户在原生终端或 WSL 里都可运行,建议先装好 Node.js 18 及以上版本再用 npm 安装。
问:Claude Code 和 Codex 有什么区别,国内该怎么选? 答:Claude Code 属于 Anthropic 生态、偏长上下文和终端智能体;Codex 是 OpenAI 生态、贴近 GPT 工作流。国内都依赖各自官方服务,选择主要看你已有订阅、团队生态和是否需要 IDE 深度集成。
问:国内装不上或登录不了怎么办? 答:先查 Node.js 与 npm 是否正常,再确认能否访问 Anthropic 登录与 API 域名。npm 慢可切镜像源,但登录和调用仍需合规网络环境,直连常超时。
问:Claude Code 会不会自动改我的代码、删文件? 答:它在写文件、跑命令前一般会请求确认。建议在 Git 仓库里使用,改动前先提交或建分支,谨慎对待批量修改和删除,不在生产环境直接放开全部权限。
问:手机上能用 Claude Code 吗? 答:Claude Code 是终端工具,主要面向桌面开发环境。手机上更适合打开 Claude 官方网站或 App 做对话问答,终端类操作还是在电脑上完成。
相关阅读
- Claude 中文版 2026:Claude 国内使用、官网入口和 Claude Code 教程:适合把国内入口和 Claude Code 一起了解。
- Codex国内怎么用?Codex国内版、中文使用、代码改造与安全指南(2026):适合继续看 Codex 的国内使用路径。