pipnpm blog

虎皮猫咖

Claude code上手与配置

69
2026-05-09

Claude Code 是 Anthropic 提供的命令行代理式编程工具(agentic coding CLI)。


与传统对话式 AI 工具不同,
它不仅能够生成文本,还可以直接访问本地代码仓库、执行 Shell 命令、编辑文件,并基于上下文完成多步骤开发任务。

在实际使用中,用户通常不再逐段编写代码后再请求模型审查,而是直接描述目标功能,由 Claude 自主完成代码分析、方案规划与实现。

以下是两种claude code 常见形态,终端与 vs code 中边栏形式,如果是写代码推荐使用ide的边栏形式,可以方便的查看代码的git diff(虽然也不会看

image.png
控制栏黑窗口形态

image.png
在 IDE 中集成形态,可类似github copilot

安装配置

具体不同平台安装指令参照:claude code官方文档

由于是从claude官方网站下载,可能会被墙,建议全程代理环境安装。

# macos/Linux 平台
curl -fsSL https://claude.ai/install.sh | bash

# window
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

此指令会执行如下内容

  • 下载 Claude Code 的独立二进制文件

  • 验证 SHA256 校验和

  • 执行该二进制的 install 命令

等待片刻,脚本安装完成。

切换到需要修改的代码工程文件路径,输入claude,即可进入claude code 的交互式会话环境。

由于cluade code默认是接入claude的官方API,如果需要接入其他模型的API,需要手动修改 /home/username/.claude/路径下的 config.json 文件或者借助 cc-switch这样的第三方工具,下文会介绍 cc-switch 工具的安装与使用。

claude 使用

推荐阅读官网的文档教程:中文文档链接。后续文章也会介绍一些个人的使用实践。

image.png

配置claude code接入其他模型

使用的工具为 CC-SWITCH

以下文本截取自项目介绍:

CC Switch 为你提供一个桌面应用来管理所有五个 CLI 工具。无需手动编辑配置文件,你将获得一个可视化界面,一键将供应商导入应用,一键在不同的供应商之间进行切换,内置 50+ 供应商预设、统一的 MCP, SKILLS 管理以及系统托盘即时切换功能——所有操作都基于可靠的 SQLite 数据库和原子写入机制,保护你的配置不被损坏。

  • 一个应用,五个 CLI 工具 — 在单一界面中管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw

  • 告别手动编辑 — 50+ 供应商预设,包括 AWS Bedrock、NVIDIA NIM 和社区中转服务;一键即可切换

  • 统一 MCP, SKILLS 管理 — 一个面板管理四个应用的 MCP, SKILLS, 支持双向同步

  • 系统托盘快速切换 — 从托盘菜单即时切换供应商,无需打开完整应用

  • 云同步 — 通过 Dropbox、OneDrive、iCloud 或 WebDAV 服务器在不同设备之间同步供应商数据

  • 跨平台 — 基于 Tauri 2 构建的原生桌面应用,支持 Windows、macOS 和 Linux

  • 小工具 - 内置了多种小工具来解决首次安装登录确认、禁止签名、插件拓展同步等多种功能

Github 地址:https://github.com/farion1231/cc-switch

CC-switch 官网:https://www.ccswitch.io/zh/

image.png
切换 API 供应商界面

我目前常用的模型是deepseek-v4-proqwen3.6-plus ,国内第一梯队模型,量大,价值实惠,为国产模型点赞👍。

image.png
添加 API 供应商

安装

软件安装指南参考这篇官方文档https://github.com/farion1231/cc-switch/releases

image.png

使用

参考这篇公众号文章https://mp.weixin.qq.com/s/0XkWwnrUNxc7Pto4SqVcpQ

如果你有多个机器配置了CC-switch,需要多个机器同步其配置文件,可以使用cc-switch的坚果云同步功能,很方便!

image.png

cc-switch cli

上面这部分安装是针对GUI界面,如果你恰好在ubuntu server此类无GUI界面的服务器终端,需要借助 cc-switch cli 工具,此工具可以终端中进行配置。

Github地址:https://github.com/saladday/cc-switch-cli

image.png

image.png

image.png

安装

# macos/linux
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash

其它平台安装请参考项目github文档,安装完成后,推荐webdav同步其它平台已经设置好的配置文件。

image.png

至此,就可以在任意终端,愉快的与大模型对话排查问题,写代码了,它可以将你计算机的环境信息如日志,代码结构通过cli 指令精确的输送给大模型,极大提升效率!

后续文章会介绍一下个人的实践技巧,敬请期待!