claude code本地MacOS安装

     优先阅读：由于此文档是我每进展一步，编写一些，以下文档是我思路的表现，而不是为了教学而写，所以强烈建议通读文档后，理解安装成功流程后，自己动手安装

安装方式有哪些？使用方式有哪些？如何制作标准的skills？梳理一下我想要的1、我想要制作skills，并调用成功2、我想要桌面或网页进行claude code对话3、我想要在vs code中使用claude code4、我看不懂英文文档，用浏览器翻译或者翻译软件（这点难死我了）

参考文档

1、终端安装Claude Code

https://code.claude.com/docs/zh-CN/quickstart#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%89%E8%A3%85-claude-code

2、桌面端安装指南

https://code.claude.com/docs/en/desktop-quickstart

3、桌面端下载地址

https://claude.com/download?utm_source=claude_code&utm_medium=docs&utm_content=configurator_desktop_download

4、claude开发者平台

https://platform.claude.com/dashboard

5、skills的使用、创建、调用

https://code.claude.com/docs/zh-CN/skills

6、claude 网页聊天地址

https://claude.ai/new

7、claude code 模型配置

https://code.claude.com/docs/zh-CN/model-config

8、Agent Skills 开放标准

https://agentskills.io/home

macOs终端安装/登录认证流程

终端安装/登录认证

• • 1、打开终端使用Homebrew安装brew install --cask claude-code
• • 2、Claude Code 需要账户才能使用，我是使用google账户登录的
• • 3、进入终端输入命令claude，首次使用时系统会提示您登录
• • 4、自动打开浏览器访问网址或手动点击终端提供的地址，鉴权成功会重定向至Authentication Code地址，在页面提供了code码，或取浏览器地址url上的code参数后携带的code值
• • 重定向后的url路径结构如：https://platform.claude.com/oauth/code/callback?code=J9VVTZfaL........
  
• • 5、将code值复制到第三步的终端内enter就登录成功啦
• • 6、使用命令/login切换至登录模式
  

Windows/MacOS桌面端安装/Web端网页的使用

Claude Code MAC/Windows下载地址

https://claude.com/download?utm_source=claude_code&utm_medium=docs&utm_content=configurator_desktop_download

• • 1、Mac下载dmg安装登录
  
• • 2、windows下载exe安装登录

  windows安装包下载地址

  https://claude.com/download?utm_source=claude_code&utm_medium=docs&utm_content=configurator_desktop_download

• • 3、Web端通过google登录，打开网址

• claude 网页聊天地址

  https://claude.ai/new

• • 4、vs code插件使用

• vs code插件市场安装

  https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code

• • vs code 插件模块搜索Claude Code for VS Code安装
• • 注意，安装后会读取本地终端的claude变量，如果本地终端像我一样没有额度，在这里你也用不了嗷，需要money
  • 终端可以使用，插件就可以使用了

• • 1、完了完了，还没开始就被迫结束，不充钱没法调用，没有免费额度，中道崩阻了
• • 2、哈哈与同事沟通了一下claude code无法使用其他模型问题，学会了更换模型的方法
• • 3、此处为本地成功后，后补的一项，千万不要使用brew安装，会有每次打开终端都需要重新配置问题与403问题，即便你配置正确，我也不知道为啥，建议使用npm安装

• • 4、参考下方命令

# 在 Claude Code 中接入阿里百炼模型,更换baseurlexport ANTHROPIC_BASE_URL=https://dashscope.aliyuncs.com/apps/anthropic或# 在 Claude Code 中接入kimi模型,更换baseurlexport ANTHROPIC_BASE_URL=https://api.moonshot.ai/anthropic# 你申请的大模型厂商给你的api_keyexport ANTHROPIC_API_KEY=你申请的大模型apikey# 你使用的大模型名称export ANTHROPIC_MODEL=kimi-k2.5# 设置不同场景的model使用# 用于复杂推理、架构设计等高难度任务。export ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k2.5"# 用于代码编写、功能实现等日常任务。export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k2.5"# 用于语法检查、文件搜索等简单任务。export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.5"# 启动claudeclaude# 询问，给你回答，于是你也成功更换了claude code的模型啦，到这里你就可以使用国产模型来测试claude code的skills啦

• 5、也可以查看官方文档

• 模型配置

  https://code.claude.com/docs/zh-CN/model-config

文件与命令方式配置

配置完发现每次打开终端都需要重新配置

•  1、文件配置方式

• • 1、进入访达，找到你的mac用户根目录（File: /Users/lee）使用快捷键Shift+cmd+.显示隐藏的文件,找到 .claude.json与.claude/settings.json 文件
• • 2、打开上面的两个文件，分别修改.claude/settings.json（env变量）与.claude.json（hasCompletedOnboarding ）文件
• • 3、到这里你就可以像我一样可以正常使用

// env变量，以下字段复制到文件中{    "env": {"ANTHROPIC_AUTH_TOKEN": "sk-7ff266e6a1656667a81b1b6a8daaadd3","ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic","ANTHROPIC_MODEL": "kimi-k2.5","ANTHROPIC_SMALL_FAST_MODEL": "kimi-k2.5","ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.5","ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.5","ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k2.5","CLAUDE_CODE_SUBAGENT_MODEL": "kimi-k2.5"    }}

// .claude.json文件内`hasCompletedOnboarding`字段值改为true{"hasCompletedOnboarding": true}

• 2、命令行配置方式

• • 1、以下方法适用于以命令行方式全局执行claude code，配置anthropic的路径与apikey与模型

# 如果目录下没有，没有就创建claude文件touch .claude.json# 如果目录下没有，没有就创建目录.claude并创建settings文件mkdir -p .claude && touch .claude/.settings.json# 打开`.claude.json`并修改内容nano ~/.claude.json# 打开`settings.json`并修改内容nano ~/.claude/settings.json

• • 2、将 hasCompletedOnboarding 字段的值设置为 true 并保存文件，参考下方操作步骤
• • 1、执行命令nano ~/.claude.json
• • 2、把终端拉高，使用Ctrl+V下一页Ctrl+Y上一页，用眼力找，就是有点费眼睛
• • 3、Ctrl+W在终端内的文件内搜索hasCompletedOnboarding会自动匹配到
• • 3、将 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL 字段的值设置为对应key与模型名称 并保存文件

• • 1、执行命令nano ~/.claude/settings.json
• • 2、将以下内容进行更改或替换整体

{"env":{"ANTHROPIC_AUTH_TOKEN":"sk-7ff266e6a1656667a81b1b6a8daaadd3","ANTHROPIC_BASE_URL":"https://dashscope.aliyuncs.com/apps/anthropic","ANTHROPIC_MODEL":"kimi-k2.5","ANTHROPIC_SMALL_FAST_MODEL":"kimi-k2.5","ANTHROPIC_DEFAULT_HAIKU_MODEL":"kimi-k2.5","ANTHROPIC_DEFAULT_SONNET_MODEL":"kimi-k2.5","ANTHROPIC_DEFAULT_OPUS_MODEL":"kimi-k2.5","CLAUDE_CODE_SUBAGENT_MODEL":"kimi-k2.5"}}

• • 4、保存并退出
• • 按下 Ctrl + X（保存文件）。
• • 按下 Y 确认更改
• • Enter保存。
• • 按下 Ctrl + X 退出编辑器。

安装完成了，本文先到这里，接下来准备调试skills，可查看下一篇【Claude Code学习笔记（1-3） skills的创建、编写、使用】

卸载claude code cli

• • 1、卸载命令brew uninstall --cask claude-code
• • 2、进入用户目录/Users/lee 找到文件.claude.json与.claude移除到废纸篓

遇到问题

• • 1、文件配置后，报错403权限问题？
•       brew安装问题，改为npm安装，正确配置setting与claude文件即可解决，可参考本文内的文件与命令方式配置
• • 2、每次打开终端都需要重新配置问题

•          更改为npm安装Claude Code,舍弃brew安装