利器 Claude Code 新手安装使用指南

sphinx30(大强同学) · 2026年01月06日 · 30 次阅读

这几天,Claude Code 彻底火了,网上都在夸赞这个由 Anthropic 出品的命令行 AI 编码工具。不同于那些花哨的 AI 插件,Claude Code 直接住进你的终端,像个老司机一样帮你写代码、修 bug、重构项目。

我也测试了一圈下来,确实牛批!免费、不限量、速度快,关键是它真的能理解你的整个项目结构。

今天,我就给大家整理一份保姆级教程,让你 5 分钟上手 Claude Code。

一.准备工作

  1. Node.js 18 或更高版本

请前往 Node.js 官方网站安装最新 LTS 版本,确保 Claude Code 能正常运行。

https://nodejs.org/en/download/

  1. Git(Windows 用户必需)

如果你使用 Windows,请提前安装 Git for Windows,否则后续依赖安装可能失败。

https://git-scm.com/install/windows

二.安装 Claude Code

安装命令

npm install -g @anthropic-ai/claude-code

安装完后,输入以下命令查看是否安装成功。能看到版本号,就表示已经就绪:

claude --version

重新打开一个新的终端窗口,进入你的 test 项目,依次运行如下命令

cd test
claude

三.配置 Claude Code 的 API

启动后会要求你授权,我自己是通过接入 API 的方法使用,你可以订阅智谱 GLM Coding Lite,然后将 API 通过 CC-switch 进行管理启动,供 Claude Code 使用,当然你有 gemini pro 会员,也可以借助 Antigravity Tools 反代 API,通过 CC-switch 进行管理启动供 Claude Code 使用。

1.购买 API key

这里推荐智谱的 API,我订阅的 GLM Coding Lite,3 个月只要 48.6

优惠购买地址

https://www.bigmodel.cn/glm-coding?ic=PUCQNADSPM

2.创建 API key

3.配置 API key

我自己使用的工具是CC-switch进行 AIPI 管理启动,供 Claude Code 使用,顺便提及下 CC-switch,不仅可以管理你的多个 API,一键切换,还可以,进行 MCP 服务器管理、Claude Code 提示词管理、Claude Skills 管理

CC-switch 开源地址

https://github.com/farion1231/cc-switch

四.上手 claude Skills

Skills 是给 Claude 装的"专业技能包"。你可以这样理解,一个 Skill 让 Claude 在特定领域变成专家。Skills 是打包好的指令、脚本和资源,Claude 会自动发现并按需加载,让它在特定任务上表现更好。

目前 skills 支持在 Claude.ai、Claude Code 以及 API 中使用,Skills 有两个位置

~/.claude/skills/              # 全局 Skills  (所有项目可用)
project/.claude/skills/        # 项目 skills (仅当前项目,可 git 共享)

理解 CLAUDE.md

理解 Slash Commands

Slash Commands 即自定义斜杠命令。

比如我创建一个/search-web 命令用来搜索资料用

具体的配置流程如下

mkdir -p ~/.claude/commands
touch ~/.claude/commands/search-web.md

search-web.md 内容

---
allowed-tools: Bash(*)
description: 使用 Gemini CLI 搜索特定站点并进行 UltraThink 总结
argument-hint: [搜索关键词]
---

# 任务目标
在互联网上搜索关于 "$ARGUMENTS" 的内容,并挖掘最靠谱、最能解答疑问的信息。

# 搜索要求
1. **限定范围**:重点关注以下站点的资料和动态:
   - anthropic.com
   - x.com
   - reddit.com
   - linux.do
2. **时效性**:搜索当前月份(!`date "+%Y年%m月"`)的最新消息 [1]。
3. **执行工具**:必须调用本地的 `gemini cli` 工具,并利用其 `GoogleSearch` 功能执行查询。
4. **并行处理**:请启动多个并行的子任务(同时调用多次 Bash 工具)分别检索上述不同站点,以加快执行速度。
5. **总结逻辑**:在给出最终回复前,请开启 **UltraThink (Extended Thinking)** 模式。深度分析各方资料的冲突、真实性和深度,最后提供一份结构严密的总结。

# 搜索指令示例(供你参考执行)
- `gemini search "site:linux.do $ARGUMENTS"`
- `gemini search "site:anthropic.com $ARGUMENTS"`

使用示例

/search-web  Claude Code上手教程

六.常见问题

1.PowerShell 运行不了命令

以管理员身份运行 PowerShell,执行:Set-ExecutionPolicy RemoteSigned(该策略允许运行本地签名脚本、远程可信签名脚本),按提示输入Y确认。

2.启动各种报错

一般是由于 win 系统下的 cmd 默认不支持魔法,需要在环境变量进行配置

sysdm.cpl 进入配置环境变量,

系统变量 --- 新建

变量名:http_proxy    变量值:http://127.0.0.1:端口号
变量名:https_proxy   变量值:http://127.0.0.1:端口号

七.写在最后

Claude Code 确实是目前最好用的 AI 编程工具之一,它不像其他工具那样花哨,而是专注于真正提升你的编程效率。当然,一些简单的任务基本用不到 AI,反而会拖累你的效率,日常可以根据自己的实际情况,是否使用 AI 辅助。以上,既然看到这里了,如果觉得不错,随手点个赞、在看、转发三连吧,如果想第一时间收到推送,也可以给我个星标⭐~

谢谢你看我的文章,我们,下次再见。

PS.如有网络不便下载,回复暗号「ClaudeCode」获取报错解决脚本。

暂无回复。
需要 登录 后方可回复, 如果你还没有账号请 注册新账号