乐于分享
好东西不私藏

Claude Code零基础入门安装使用指南

Claude Code零基础入门安装使用指南

Claude Code是一个可以在终端中运行的智能编码工具,通过自然语言命令交互,帮助开发者快速完成代码生成、调试、重构等任务。

Claude Code是Anthropic公司推出的AI编程助手,它能够阅读代码库、编辑文件、执行命令,并与开发工具深度集成。与传统的代码补全工具不同,Claude Code是一个真正的代理型工具,你可以用自然语言描述任务,它会理解整个目录下的代码库,跨多个文件执行操作,直到完成任务。

对于开发人员而言,Claude Code可以帮助你:

  • 自动编写测试代码
  • 修复bug并验证修复效果
  • 重构和优化代码
  • 自动化重复性开发任务
  • 连接外部工具(通过skill MCP)

前提条件

这里主要以windows系统为示例,其他系统安装也是类似。

Windows需要安装Git for Windows和node。

  1. git version
  2. git version 2.33.1.windows.1
  3. 需要Node18或更新版本
  4. node -v
  5. v24.14.0

安装Claude Code

推荐使用npm全局安装:打开CMD,执行以下命令:

  1. npm install -@anthropic-ai/claude-code

安装完成后,验证版本:

  1. claude --version
  2. 2.1.66(ClaudeCode)

建议使用最新版本。

配置智谱GLM模型

使用Claude Code之前,需要先配置智谱AI的API访问调用大模型。

第一步:获取API Key

  1. 访问智谱AI开放平台
  2. 注册/登录账号
  3. 在个人中心创建 API Key

新注册用户会赠送一定额度的token。

第二步:手动配置

  1. # 编辑或新增 `settings.json` 文件
  2. # MacOS & Linux 为 `~/.claude/settings.json`
  3. # Windows 为`用户目录/.claude/settings.json`
  4. # 新增或修改里面的 env 字段
  5. # 注意替换里面的 `your_zhipu_api_key` 为您上一步获取到的 API Key
  6. {
  7. "env":{
  8. "ANTHROPIC_AUTH_TOKEN":"your_zhipu_api_key",
  9. "ANTHROPIC_BASE_URL":"https://open.bigmodel.cn/api/anthropic",
  10. "API_TIMEOUT_MS":"3000000",
  11. "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":1
  12. }
  13. }
  14. # 再编辑或新增 `.claude.json` 文件
  15. # MacOS & Linux 为 `~/.claude.json`
  16. # Windows 为`用户目录/.claude.json`
  17. # 新增 `hasCompletedOnboarding` 参数
  18. {
  19. "hasCompletedOnboarding": true
  20. }

配置成功后,重新打开一个新的终端窗口,以便环境配置生效。

第三步:启动验证

配置完成后,进入一个您的代码工作目录,在终端中执行 claude 命令即可开始使用 Claude Code

进入代码目录,启动Claude Code:

  1. cd your-project
  2. claude

首次启动时,程序会询问「Do you want to use this API key」,输入 Yes 确认。

开始使用

启动后,Claude Code会询问是否信任访问当前目录的所有文件。输入 Yes 确认后,即可正常使用。

基本交互方式:直接输入你想要问的问题

  1. #输入claude
  2. claude
  3. # 理解代码
  4. 帮我总结下当前这个项目
  5. # 调试代码
  6. xxx类里代码有bug,帮我看看
  7. # 解释代码
  8. xxx方法,解释这个方法做了什么

切换模型

可以通过配置切换模型。如要切换到minimax的模型

编辑 ~/.claude/settings.json 文件:

  1. {
  2. "env":{
  3. "ANTHROPIC_AUTH_TOKEN":"ab4cffca052*******************bzKu",
  4. "ANTHROPIC_BASE_URL":"https://open.bigmodel.cn/api/anthropic",
  5. "API_TIMEOUT_MS":"3000000",
  6. "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":"1",
  7. "ANTHROPIC_DEFAULT_HAIKU_MODEL":"glm-4.5-air",
  8. "ANTHROPIC_DEFAULT_SONNET_MODEL":"glm-4.7",
  9. "ANTHROPIC_DEFAULT_OPUS_MODEL":"glm-4.7"
  10. },
  11. "skipDangerousModePermissionPrompt":true,
  12. "envbak":{
  13. "ANTHROPIC_BASE_URL":"https://api.minimaxi.com/anthropic",
  14. "ANTHROPIC_AUTH_TOKEN":"sk-cp-9ExEW**********************7Sk",
  15. "API_TIMEOUT_MS":"3000000",
  16. "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":"1",
  17. "ANTHROPIC_MODEL":"MiniMax-M2.5",
  18. "ANTHROPIC_SMALL_FAST_MODEL":"MiniMax-M2.5",
  19. "ANTHROPIC_DEFAULT_SONNET_MODEL":"MiniMax-M2.5",
  20. "ANTHROPIC_DEFAULT_OPUS_MODEL":"MiniMax-M2.5",
  21. "ANTHROPIC_DEFAULT_HAIKU_MODEL":"MiniMax-M2.5"
  22. }
  23. }

配置完成后,重新打开终端窗口,启动Claude Code,输入 /status 查看当前模型配置。

版本升级

检查当前版本:

  1. claude --version

升级到最新版本:

  1. claude update

参考链接:https://docs.bigmodel.cn/cn/coding-plan/tool/claude