Claude Code零基础入门安装使用指南
Claude Code是一个可以在终端中运行的智能编码工具,通过自然语言命令交互,帮助开发者快速完成代码生成、调试、重构等任务。
Claude Code是Anthropic公司推出的AI编程助手,它能够阅读代码库、编辑文件、执行命令,并与开发工具深度集成。与传统的代码补全工具不同,Claude Code是一个真正的代理型工具,你可以用自然语言描述任务,它会理解整个目录下的代码库,跨多个文件执行操作,直到完成任务。
对于开发人员而言,Claude Code可以帮助你:
-
自动编写测试代码
-
修复bug并验证修复效果
-
重构和优化代码
-
自动化重复性开发任务
-
连接外部工具(通过skill MCP)
前提条件
这里主要以windows系统为示例,其他系统安装也是类似。
Windows需要安装Git for Windows和node。
shell
git version
git version 2.33.1.windows.1
需要Node18或更新版本
node -v
v24.14.0

安装Claude Code
推荐使用npm全局安装:打开CMD,执行以下命令:
bash
npm install -g @anthropic-ai/claude-code
安装完成后,验证版本:
bash
claude --version
2.1.66 (Claude Code)
建议使用最新版本。
配置智谱GLM模型
使用Claude Code之前,需要先配置智谱AI的API访问调用大模型。
第一步:获取API Key
- 访问智谱AI开放平台
- 注册/登录账号
- 在个人中心创建 API Key
新注册用户会赠送一定额度的token。

第二步:手动配置
bash
# 编辑或新增 `settings.json` 文件
# MacOS & Linux 为 `~/.claude/settings.json`
# Windows 为`用户目录/.claude/settings.json`
# 新增或修改里面的 env 字段
# 注意替换里面的 `your_zhipu_api_key` 为您上一步获取到的 API Key
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
}
}
# 再编辑或新增 `.claude.json` 文件
# MacOS & Linux 为 `~/.claude.json`
# Windows 为`用户目录/.claude.json`
# 新增 `hasCompletedOnboarding` 参数
{
"hasCompletedOnboarding": true
}
配置成功后,重新打开一个新的终端窗口,以便环境配置生效。
第三步:启动验证
配置完成后,进入一个您的代码工作目录,在终端中执行 claude 命令即可开始使用 Claude Code
进入代码目录,启动Claude Code:
bash
cd your-project
claude
首次启动时,程序会询问「Do you want to use this API key」,输入 Yes 确认。

开始使用
启动后,Claude Code会询问是否信任访问当前目录的所有文件。输入 Yes 确认后,即可正常使用。
基本交互方式:直接输入你想要问的问题
bash
#输入claude
claude
# 理解代码
帮我总结下当前这个项目
# 调试代码
xxx类里代码有bug,帮我看看
# 解释代码
xxx方法,解释这个方法做了什么
切换模型
可以通过配置切换模型。如要切换到minimax的模型
编辑 ~/.claude/settings.json 文件:
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "ab4cffca052*******************bzKu",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
},
"skipDangerousModePermissionPrompt": true,
"envbak": {
"ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "sk-cp-9ExEW**********************7Sk",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"ANTHROPIC_MODEL": "MiniMax-M2.5",
"ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.5"
}
}
配置完成后,重新打开终端窗口,启动Claude Code,输入 /status 查看当前模型配置。

版本升级
检查当前版本:
bash
claude --version
升级到最新版本:
bash
claude update