Claude code 食用指南
文章来源|MS08067 AI安全攻防小组
作者:Taoing
Claude Code是一个智能编码工具,可以在终端中运行,通过自然语言命令交互帮助开发者快速完成代码生成、调试、重构等任务。
一、安装 Claude Code
步骤一:安装
前提条件:
-
您需要安装 Node.js 18 或更新版本环境
-
Windows 用户还需安装 Git for Windows
进入命令行界面,安装 Claude Code
npm install -g @anthropic-ai/claude-code
运行如下命令,查看安装结果,若显示版本号则表示安装成功
claude --version
注意:如果您在安装过程中遇到权限问题,请尝试使用 sudo(MacOS/Linux)或以管理员身份运行命令提示符(Windows)重新执行安装命令。 安装成功后,还需后续步骤,若您直接使用 claude 命令启动,可能由于网络或地区限制无法使用。
步骤二:配置
配置环境变量:
通过在 MacOS、Linux 或 Windows 中使用以下一种方式设置环境变量:
注意:设置环境变量时,有些命令不会返回任何输出。这是正常的,只要没有报错即代表成功。
注意:选择以下适合您操作系统的一种方式进行配置即可。
手动配置
根据您的环境选择下面一种方式即可,配置后需新建命令行窗口生效
# 编辑或新增 Claude Code 配置文件 `~/.claude/settings.json`
# 新增或修改里面的 env 字段
# 注意替换里面的 `api_key` 为您上一步获取到的 API Key
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "api_key",
"ANTHROPIC_BASE_URL": "https://xxx.xxxxxx.cn/api/anthropic",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
}
}
# 在 Cmd 中运行以下命令
# 注意替换里面的 `api_key` 为您上一步获取到的 API Key
setx ANTHROPIC_AUTH_TOKEN your_api_key
setx ANTHROPIC_BASE_URL https://xxx.xxxxxx.cn/api/anthropic
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1
# 在 PowerShell 中运行以下命令
# 注意替换里面的 `your_api_key` 为您上一步获取到的 API Key
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'your_api_key', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://xxx.xxxxxx.cn/api/anthropic', 'User')
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', '1', 'User')
步骤三:使用Claude Code
配置完成后,进入一个您的代码工作目录,在终端中执行 claude 命令即可开始使用 Claude Code
若遇到「Do you want to use this API key」选择 Yes 即可
启动后选择信任 Claude Code 访问文件夹里的文件,如下:

完毕!现在就可以正常使用 Claude Code 进行开发了。
常见问题:
如何切换使用模型
Claude Code 内部模型环境变量与模型对应关系,默认配置如下:
ANTHROPIC_DEFAULT_OPUS_MODEL:
ANTHROPIC_DEFAULT_SONNET_MODEL:
ANTHROPIC_DEFAULT_HAIKU_MODEL:
如有调整诉求,可直接通过调整配置文件的方式(位于
~/.claude/settings.json)来调整到其他模型
手工修改配置不生效
若您手动修改了 ~/.claude/settings.json 配置文件,但发现配置没有生效,参考如下排查。
-
关闭所有 Claude Code 窗口,重新打开一个新的命令行窗口,再次运行
claude启动。 -
如果问题仍然存在,您可以尝试删除
~/.claude/settings.json文件,然后重新配置环境变量,Claude Code 会自动生成一个新的配置文件。 -
确认配置文件的 JSON 格式是否正确,检查变量名称和不能少逗号或多逗号,可以使用在线 JSON 校验工具进行检查。
推荐的 Claude Code 版本
建议使用最新版本的 Claude Code,您可以通过以下命令检查当前版本和升级:
我们在 Claude Code 2.0.14 等版本验证 OK。
# 检查当前版本
claude --version
2.0.69 (Claude Code)
# 升级到最新版本
claude update

二、Claude Code IDE 插件
Claude Code 是一个智能编码工具,可以在终端中运行,也可以通过在 Vscode, Jetbrains 等 IDE 安装插件使用。
安装使用 IDE 插件:
Claude Code for VS Code 插件
Claude Code Vscode 插件支持在 Vscode 及基于 Vscode 的 IDE(如 Cursor、Trae 等)中使用。
打开 Vscode,进入扩展市场,搜索并安装「Claude Code」插件进行安装。

安装完成后,点击如下图中的右上角 Claude Code 图标,即进入 Claude Code 页面,等待几秒待其初始化完成后即可使用。

完毕!现在就可以在 IDE 中正常使用 Claude Code 进行开发了。
Claude Code for Jetbrains 插件
Claude Code Jetbrains 插件支持 Jetbrains 的系列 IDE 如 IntelliJ IDEA、PyCharm、WebStorm 等。
打开 Jetbrains IDE(如 IntelliJ IDEA、PyCharm 等),进入插件市场,搜索「Claude Code」插件并进行安装。

安装完成后,重启 IDE 即可使用 Claude Code 功能。

完毕!现在就可以在 IDE 中正常使用 Claude Code 进行开发了。
三、skills
Skills核心特性
Skills 通过模块化、可组合的能力封装,具备以下核心特性:
模块化设计:每个skills都是独立的文件夹,包含完整的指令、脚本和资源,如文档skills
动态加载:AI Agent 可根据任务需求按需加载相应skills
专业化能力:每个skills专注于特定领域,提供深度的专业知识和操作能力
人性化交互:模拟人类专业skills的学习和应用方式
可扩展性:支持自定义skills开发,满足个性化和企业级需求
组成拆解
一个完整的 Skills 就是一个标准化的文件夹体系,每个skills由若干文件组成,用来描述功能、脚本和引用资料
my-skills/
├── skills.md (必需)
│ ├── YAML 前置元数据 (必需)
│ │ ├── name: (必需)
│ │ └── description: (必需)
│ └── Markdown 指令 (必需)
└── 捆绑资源 (可选)
├── scripts/ - 可执行代码 (Python/Bash等)
├── references/ - 参考文档
└── assets/ - 输出文件 (模板、图标、字体等)
当然我们还可以进行封装引用的Tools(工具)、Knowledge(知识库)
Skills教程
claude-plugins-official:https://github.com/anthropics/claude-plugins-official
anthropics/skillsSkills技能市场:https://skillsmp.com/zh
专为中国用户优化的 AI Skills:https://skillhub.tencent.com/
Skills(技能),官方的解释是:使用 Skills 可以提升执行特定任务的能力。
Skills官方集合
智普
AI & 媒体处理技能
VLM - 视觉语言模型:图像理解、图像分析
TTS - 文本转语音:将文本转换为自然语音
LLM - 大语言模型:对话、文本生成、聊天机器人
ASR - 语音识别:语音转文字、音频转录
Image-Generation - AI图像生成:从文本描述生成图像
Video-Generation - AI视频生成:从文本或图像生成视频内容
通用技能
Web-Search - 网络搜索:搜索和检索网络信息
Web-Reader - 网页阅读:提取网页内容、抓取文章
文档与内容技能
Docx - Word文档:创建、编辑Word文档
Pptx - PowerPoint演示文稿:创建、编辑幻灯片
Xlsx - Excel电子表格:创建、编辑数据表
Pdf - PDF文档:创建、编辑PDF、填写表单
以上:openai-skills、智普skills 寻找客服获取。
小编力荐Skills
Agent Browser
专为AI Agent 设计的浏览器自动化CLI,力荐
安装:npx skills add vercel-labs/agent-browser
Ralph Loop
Ralph Loop是一种基于“永不放弃”理念的AI编程新技术
然后在Claude Code里跑这条命令安装插件:
/plugin install ralph-wiggum@anthropics
安装完之后可以用/plugin命令确认一下,你应该能在列表里看到Ralph插件

装完后你会得到三个命令:
/ralph-wiggum:ralph-loop用来启动一个Loop
/ralph-wiggum:cancel-ralph用来中止正在运行的Loop
/ralph-wiggum:help用来看帮助文档。
基本用法
Ralph Loop的命令结构长这样:
/ralph-wiggum:ralph-loop "<你的任务>" --completion-promise "DONE" --max-iterations 10
三个关键参数:任务描述是你要Claude干什么;completion-promise是完成标记,Claude输出这个词就算完成;max-iterations是最大迭代次数,防止无限循环。
跑一个简单的试试:
/ralph-wiggum:ralph-loop "创建一个Python邮箱校验函数。要处理各种边界情况,写5个测试用例。完成后输出DONE。" --completion-promise "DONE" --max-iterations 5
你会看到Claude开始工作,写完代码想退出,被拦住,继续审视自己的代码,补充遗漏的情况,再跑一遍测试,发现问题修复……直到真正做完。
关于完成标记:Claude要用特定格式输出才算完成——<promise>DONE</promise>。只要它没输出这个,Loop就会继续。
四、MCP
联网搜索 MCP使用示例
联网搜索 MCP Server 是一个基于模型上下文协议 (Model Context Protocol) 的搜索能力实现,为 Claude Code兼容 MCP 的客户端提供智谱的强大搜索能力,包括网络搜索、实时信息获取等功能。
手动配置编辑 Claude Code 的配置文件, 位于用户目录下 .claude.json 的 MCP 部分:
{
"mcpServers": {
"web-search-prime": {
"type": "http",
"url": "https://open.bigmodel.cn/api/mcp/web_search_prime/mcp",
"headers": {
"Authorization": "xxxx.xxxxxx"
}
}
}
}


扫码进入AI交流群


— 关于我们 —
镇江刺掌信息科技有限公司成立于2020年,公司旗下MS08067安全实验室,专注于网络安全领域教育、培训、认证产品及服务提供商。近两年,线上培训人数近10万人次,培养网络安全人才近6000名。
公司被认定为国家高新技术企业、国家科技型中小企业、江苏省创新性中小企业、江苏省民营科技企业、江苏省软件企业。并荣获机械工业出版社“年度最佳合作伙伴”、电子工业出版社-博文视点“优秀合作伙伴”、镇江市企业发展服务中心优质合作伙伴、镇江市网络安全应急支撑服务单位等荣誉称号。

如果喜欢我们
欢迎 在看丨留言丨分享至朋友圈 三连

更多推荐



所有评论(0)