Claude Code 是什么，和 ChatGPT 网页版什么区别？

Claude Code 是 Anthropic 出品的终端 AI 编程 Agent，在本地终端读取代码库、执行命令、创建/修改文件，跑完多步编码任务后交你确认。它需要 Pro / Max / Team / Enterprise / Console 订阅账号（免费 Claude 不行）。和网页版 ChatGPT 最大区别是能真正动手改文件、跑命令，本质是一个「规划-调用-观察-反思」的 Agent 循环。

在国内（中国大陆）能直接用吗？

Anthropic 对大陆地区有访问限制，直接运行 claude 会卡在初始化或提示地区不可用。最实用的办法是配置兼容端点：在 ~/.claude/settings.json（Windows 为 %USERPROFILE%/.claude/settings.json）的 env 块写入 ANTHROPIC_BASE_URL 与 ANTHROPIC_API_KEY，指向阿里云百炼、智谱 GLM、DeepSeek 等兼容 Anthropic 协议的国内服务，跳过官方 OAuth 登录。详见正文「国内访问配置」一节。

登录用 Claude 账号还是 API Key？

网络畅通且已有订阅，推荐用 Claude 账号 OAuth 登录（首次运行 claude 弹浏览器授权），数据打通、按订阅额度计费。网络受限或走程序化计费，则用 API Key：设 ANTHROPIC_API_KEY 环境变量，或在 settings.json 的 env 块配置。国内用户几乎都用后者加兼容端点。

Windows 原生能用吗，需要 WSL2 吗？

不需要 WSL2。Claude Code 支持 Windows 10 1809+ 原生运行，PowerShell 和 CMD 都能直接跑。无 Git for Windows 时走 PowerShell 工具；装了 Git for Windows 默认走 Git Bash（也可设 CLAUDE_CODE_USE_POWERSHELL_TOOL=1 切回 PowerShell）。安装用官方 irm https://claude.ai/install.ps1 | iex 或 npm i -g @anthropic-ai/claude-code。

安装或运行报错怎么排？

最常见：① Node 版本太低——v2.1.198 起需 Node.js 22+，用 node -v 核对，低了升级（npm 装完即便版本旧也能跑，因为它下载的是不依赖你 Node 的原生二进制）；② 命令找不到——全局 bin 没进 PATH，npm bin -g 看路径加进环境变量后重开终端；③ 国内网络——务必配兼容端点并把 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1，避免连接官方服务器超时；④ 权限——别 sudo npm install -g，用官方 Node 安装包（全局目录默认在用户目录）。

Claude Code 安装与配置教程：终端里的 Anthropic 编程 Agent

npm/安装脚本 · Node 22+ · OAuth 登录 · API Key · 国内兼容端点 · 首个任务 · 常见问题

核心结论：Claude Code 是 Anthropic 的终端编程 Agent，一行 npm install -g @anthropic-ai/claude-code（或官方安装脚本）就能装上。先确认 Node.js 22+，再选「Claude 账号 OAuth 登录」（推荐，需 Pro/Max 等订阅）或「API Key」认证；国内用户务必配兼容端点，否则会被地区限制挡在门外。

一、它到底是什么

Claude Code 是 Anthropic 出品的轻量终端编程 Agent，是进入「Claude 智能体能力」最直接的入口。它在本地终端读取你的代码库、执行 shell 命令、创建/修改文件，跑完多步编码任务后再把结果交给你确认——本质上就是「规划-调用-观察-反思」的 Agent 循环（详见 AI Agent 入门）。

它和网页版 ChatGPT 的最大区别是能真正动手：改文件、跑命令、跑测试，而不是只聊天。权限模型上，每次有副作用的操作前都会请你确认（可设 auto-accept 但需谨慎）。注意账号门槛：Claude Code 需要 Pro / Max / Team / Enterprise / Console 订阅账号，免费 Claude 账号无法使用。

二、环境要求

项目	要求
Node.js	v2.1.198 起需 22 或更新版本（更早版本会打 EBADENGINE 警告但不失败，因为安装的是不依赖你 Node 的原生二进制）
操作系统	macOS 13.0+ / Windows 10 1809+ 或 Windows Server 2019+ / Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+ 原生；Windows 不需要 WSL2
硬件	4GB+ RAM，x64 或 ARM64 处理器
Shell	Bash / Zsh / PowerShell / CMD
网络	需访问 Anthropic 服务；中国大陆需配置兼容端点（见第五节）

⚠ 先核对 Node：终端执行 node -v，低于 22 建议升级（推荐 nvm：nvm install 22 && nvm use 22）。npm 装完即便版本旧也能跑，但官方推荐 22+ 以获得完整的 CA 证书读取等企业网络能力。

三、四种安装方式

方式一：npm（全平台，推荐给开发者）

npm install -g @anthropic-ai/claude-code
# 升级用 @latest；不要用 npm update -g（不会跨 semver 升到最新）
npm install -g @anthropic-ai/claude-code@latest

提示npm 装的是和官方安装器相同的原生二进制（通过平台可选依赖拉取），装完 claude 命令本身不调用 Node。不要用 sudo npm install -g，权限问题请用官方 Node 安装包（全局目录默认在用户目录）。

方式二：官方原生安装脚本（推荐）

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

方式三：Homebrew（macOS / Linux）

brew install claude

方式四：WinGet（Windows）

winget install Anthropic.ClaudeCode

装完验证：

claude --version
# 更详细的安装/配置诊断：
claude doctor

Windows 原生运行（无需 WSL2）

Claude Code 支持 Windows 10 1809+ 原生运行，PowerShell 和 CMD 都能直接跑，不需要 WSL2。行为细节：

没装 Git for Windows 时，Claude Code 通过 PowerShell 工具执行 shell 命令；装了则默认走 Git Bash。
想强制用 PowerShell 工具：设 CLAUDE_CODE_USE_POWERSHELL_TOOL=1。
Git Bash 找不到时，在 settings.json 指定路径：{ "env": { "CLAUDE_CODE_GIT_BASH_PATH": "C:/Program Files/Git/bin/bash.exe" } }。

四、登录认证（两种二选一）

方式	适合谁	额度来源
Claude 账号 OAuth（推荐，网络畅通）	有 Pro/Max/Team/Enterprise/Console 订阅	按订阅额度计费
API Key	网络受限、走程序化计费、国内用户	ANTHROPIC_API_KEY（官方或兼容端点）

Claude 账号 OAuth 登录

# 首次运行会弹出浏览器授权页，点 Allow 即可
claude
# 无图形界面/CI 环境：
claude login

API Key 登录

# 直接传环境变量后运行（官方账号）
export ANTHROPIC_API_KEY=sk-ant-...
claude

密钥安全：API Key 等同你的「印钞权」，切勿写进前端或提交到仓库。前端需要智能能力时，应走你自己的后端代理（详见 API Key 安全管理）。

五、国内访问配置（中国大陆必看）

Anthropic 对大陆地区有访问限制，直接 claude 会卡在初始化或提示地区不可用。解决办法是跳过官方 OAuth、改用兼容端点：把 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 指向任意兼容 Anthropic 协议的国内服务，Claude Code 就会透明地把请求发给它。

步骤一：跳过初始化引导

在用户主目录新建/编辑 .claude.json（注意是主目录下的 .claude.json，不是 .claude 文件夹内）：

# Windows: C:/Users/{用户名}/.claude.json
# macOS / Linux: ~/.claude.json
{ "hasCompletedOnboarding": true }

步骤二：配置兼容端点

编辑 settings.json：

# Windows: %USERPROFILE%/.claude/settings.json
# macOS / Linux: ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_API_KEY": "你的兼容端点API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

⚠ 常见国内兼容端点：阿里云百炼 https://dashscope.aliyuncs.com/apps/anthropic、智谱 GLM https://open.bigmodel.cn/api/anthropic、DeepSeek https://api.deepseek.com/anthropic，以及各类 API 中转服务。密钥去对应控制台申请，按量或订阅计费。具体地址以服务商文档为准。

不要再用 claude login 走官方账号——它会尝试路由到 api.anthropic.com，在大陆必然失败。配置好环境变量后直接 claude 即可。npm 安装若卡在墙外，先切镜像：npm config set registry https://registry.npmmirror.com。

六、跑通第一个任务

进入项目：切到任意项目目录，Claude Code 会读取当前目录代码。
启动：运行 claude 进入交互式会话。
下指令：先用低风险任务试探，例如「帮我看一下这个项目的目录结构，指出最可能出 bug 的模块」。
让它改文件：明确描述改动，例如「把 src/utils/format.js 里的日期格式从 YYYY-MM-DD 改成 YYYY/MM/DD，并确认所有引用点正常」。

cd /path/to/your-project
claude
# 在输入框里输入：
# 帮我看一下这个项目的目录结构，并指出最可能存在 bug 的模块

⚠ 权限确认：Claude Code 直接改文件、跑命令，每次有副作用的操作前都会请你确认。把它当「待审副驾」，改完一定 review 再提交。可用 /model 或 /debug 在会话内确认当前模型。

七、进阶配置

1. 用 CLAUDE.md 给项目立规矩

在项目根目录放一个 CLAUDE.md，写下编码规范、命令约定、注意事项，Claude Code 每次会话会自动读取，相当于给 Agent 的「项目说明书」。

2. 接 MCP 工具

通过 MCP 让 Claude Code 连接外部系统（数据库、Figma 等）。示例：claude mcp add github，按提示授权后即连。

3. 工程化配置

权限、环境变量、模型偏好等都可在 settings.json 的 env / permissions 块集中管理；团队可提交 .mcp.json 共享 MCP 配置。

八、常见问题

Claude Code 默认用哪个模型？

默认走你订阅账号对应的 Claude 模型（如 Opus / Sonnet 系列），也可用 /model 在会话内切换。通过兼容端点时，实际模型由端点服务商决定（如 GLM-5.1、DeepSeek 等）。

免费 Claude 账号能用吗？

不能。Claude Code 需要 Pro / Max / Team / Enterprise / Console 订阅。免费账号运行 claude 会提示需要升级。国内走兼容端点时，额度来自端点服务商的订阅/按量套餐，与 Anthropic 免费账号无关。

公司代码会不会被拿去训练？

用订阅账号登录走 Anthropic 的企业数据处理政策隔离；走兼容/私有端点时数据完全不出你的控制域。敏感行业建议用合规端点或私有化部署。

AI 编程助手评测 » · AI Agent 入门 » · 函数/工具调用实战 » · API Key 安全管理 » · Codex CLI 安装教程 » · 返回 AI 技术文档 »