Claude Code 可以在国内通过官方渠道合法使用,但需要先完成 Node.js 环境配置、npm 安装和 API 密钥设置等前置步骤。Anthropic 推出的 Claude Code 是一款命令行的 AI 编程助手,让开发者在终端中直接调用人工智能来辅助写代码、调试和项目管理。以下 6 项检查清单能帮助国内开发者快速跑通流程。
1. 检查 Node.js 版本

先确认电脑上安装的 Node.js 是否为 22 或以上版本。在终端输入 node --version 查看版本号,如果低于 22,建议通过 brew install node@22 来更新。这一步是安装 Claude Code 的前置条件。
2. 用 npm 全局安装
确保 npm 正常工作后,执行命令 npm install -g @anthropic-ai/claude-code。安装完成后,在终端输入 claude 来验证是否识别到该命令。如果提示命令未找到,检查 npm 全局包的路径是否已加入系统环境变量。
3. 获取并配置 API 密钥
国内访问 Claude Code 需要自行配置 API 密钥(一种用于身份验证的字符串)。开发者需先到 Anthropic 官方开发者平台注册账号并申请密钥,然后通过 export ANTHROPIC_API_KEY=你的密钥 设置环境变量。部分国内镜像站也提供了简化配置的方法。
4. 确认项目目录权限
首次在项目中使用 Claude Code,建议在干净的目录下运行 claude 初始化。系统会要求授予读取文件和执行命令的权限。注意不要在系统级目录或包含敏感数据的文件夹中执行,避免权限冲突。
5. 验证网络连接状态
如果 claude 启动后一直卡在连接中,检查 API 密钥是否填写正确,并确认当前网络能否访问 Anthropic 的 API 服务。有经验的开发者会通过 ping api.anthropic.com 或查看终端返回的错误码来定位问题。
6. 测试一次简单的编码会话
完成安装和配置后,输入 claude 进入交互模式,然后尝试发一条指令,比如 "写一个 Python 的斐波那契数列函数"。如果 Claude Code 能正常返回代码并解释,说明整套链路已畅通。这时就可以正式开始使用这个 AI 编程助手了。