从零搭建 Claude Code 编程助手：接入多模型 + 飞书

很多人还在用传统问答式 AI 助手，但 Agent（智能体） 时代已经到来。Claude Code 是目前最强的终端编程 Agent 之一，配合模型切换工具与 IDE 插件，你可以搭建一套 AI 编程环境——还能一句话操作飞书文档。

以下是完整教程，全程约 30 分钟。

🚀 一、这套环境能做什么？

组件 作用
Claude Code 终端里的编程 Agent，用自然语言写代码、改 Bug、重构项目
cc-switch（社区工具） 图形化切换底层模型（DeepSeek、OpenAI 等），降低成本，国内更稳定
IDE 插件 在 IntelliJ IDEA / WebStorm / PyCharm 中获得对话式编程体验
MCP 扩展 连接飞书、数据库、Jira 等外部工具，Agent 一句话即可操作

环境要求：macOS / Linux / Windows 均可，需要管理员权限安装软件。

📦 二、安装 nvm（Node 版本管理器）

nvm 用于管理多个 Node.js 版本，避免全局污染。

🍎 macOS / Linux

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

安装后必须重新加载 shell 配置：

# macOS（默认 zsh）：
source ~/.zshrc
# Linux（通常 bash）：
source ~/.bashrc

验证：

nvm --version
# 输出类似 0.39.7 即成功

🪟 Windows

前往 nvm-windows 发布页，下载 nvm-setup.exe 安装。打开 PowerShell 验证：

nvm version

常见问题：nvm: command not found → 关闭终端重新打开，或确认安装脚本已写入 shell 配置文件。

🟢 三、安装 Node.js 22（LTS）

版本选择逻辑：

  • Claude Code 官方要求 Node ≥ 18
  • 飞书 CLI（@larksuite/cli）要求 Node ≥ 20
  • Node 22 是当前 LTS 版本，兼容性最佳
nvm install 22
nvm use 22
nvm alias default 22

验证：

node -v   # v22.x.x
npm -v    # 10.x.x

提示：确保此步验证通过后，再进行后续步骤。

🤖 四、安装 Claude Code CLI

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

验证：

claude --version

首次使用需登录 Anthropic 账号或配置 API Key。如果你计划通过 cc-switch 接入第三方模型，可先跳过登录，后续在 cc-switch 中统一配置。

如果安装失败：请参考 Anthropic 官方文档 确认最新的包名和安装方式，预览版和正式版的命令可能不同。

🔀 五、安装 cc-switch，图形化切换模型

安全提示：cc-switch 是社区开发的第三方工具，非 Anthropic 官方维护。使用时请注意保护 API Key 等敏感信息。Claude Code 升级后可能需要重新适配。

📥 5.1 下载安装

  1. 前往 cc-switch 发布页，下载对应平台的可执行文件：

    • Mac Intel：cc-switch-darwin-amd64
    • Mac Apple Silicon：cc-switch-darwin-arm64
    • Windows：cc-switch-windows-amd64.exe
    • Linux：cc-switch-linux-amd64

  2. 重命名为 cc-switch（Windows 保留 .exe），放入一个目录（如 ~/bin），并将该目录加入 PATH：

    # macOS / Linux，在 ~/.zshrc 或 ~/.bashrc 中添加：
export PATH="$HOME/bin:$PATH"
source ~/.zshrc  # 或 source ~/.bashrc

⚙️ 5.2 初始化

cc-switch init

这会在 ~/.claude/ 下生成配置文件，建立 cc-switch 与 Claude Code 的关联。只需执行一次。

🖥️ 5.3 图形化配置

cc-switch gui

会打开一个本地图形界面，在其中：

  1. 添加模型提供方：填入名称、API Key、Base URL（例如 DeepSeek 的 https://api.deepseek.com）
  2. 勾选模型：界面会列出该提供方下的可用模型，打勾即可
  3. 设为默认：右键选择你想默认使用的模型

配置完成后，所有 claude 命令会自动走你选中的模型。想切换时重新打开 cc-switch gui 即可。

🔌 六、IDE 集成（IntelliJ IDEA / WebStorm / PyCharm）

🧩 方式一：使用社区 GUI 插件（推荐尝试）

  1. 打开 IDE → File → Settings → Plugins
  2. 在 Marketplace 搜索 Claude Code 相关插件（名称可能为 Claude Code GUI、CC GUI 等，以实际搜索结果为准）
  3. 安装后重启 IDE，侧边栏会出现聊天窗口

如果搜不到：说明插件可能尚未上架或名称变更，使用方式二。

💻 方式二：IDE 内置终端（始终可用）

在 IDE 中打开 Terminal 面板，直接运行：

claude

进入交互模式后，用中文描述需求即可，效果与 GUI 插件相同。

🦅 七、接入飞书 —— 让 Agent 操作你的飞书工作台

飞书 CLI 是飞书官方提供的命令行工具，它让 AI Agent 能够直接操作飞书中的各类资源（文档、日历、消息、多维表格等）。通过 MCP（Model Context Protocol）协议，Claude Code 可以调用这些工具，实现一句话操作飞书。

📲 7.1 安装飞书 CLI

方式一：手动安装（推荐）

在终端中依次执行以下命令：

# 1. 全局安装飞书 CLI
npm install -g @larksuite/cli

# 2. 安装 CLI Skill（必须，供 Claude Code 等 AI 工具使用）
npx -y skills add https://open.feishu.cn --skill -y

环境要求：确保已安装 Node.js（已在第三步完成），部分高级功能需要 Go v1.23+ 和 Python 3（仅源码构建时需要）。

方式二：让 Claude Code 自动安装

你也可以直接对 Claude Code 说：

帮我安装飞书 CLI：https://open.feishu.cn/document/no_class/mcp-archive/feishu-cli-installation-guide.md

Claude Code 将自动执行上述安装步骤。

🔐 7.2 配置与授权

安装完成后，需要配置应用凭证并完成用户授权。

（1）初始化应用配置

lark-cli config init --new

执行后会弹出二维码或链接，使用飞书扫码即可自动创建应用并完成基础配置。

提示：也可以使用 lark-cli config init（不加 --new）选择一个已有的飞书应用进行绑定。

（2）完成用户授权（可选，但强烈推荐）

lark-cli auth login --recommend

执行后打开终端输出的链接，在飞书中确认授权。这一步决定 Agent 的操作权限：

  • 以你的身份操作（推荐）：完成用户授权后，AI 可以访问你的个人日历、消息、文档，并以你的名义执行操作。
  • 不授权直接使用：AI 仍然可以执行发消息、创建文档等操作，但无法访问你的个人数据（如日程、私信、收件箱）。

（3）验证配置

lark-cli auth status

确认当前登录状态和权限范围正常。

（4）如何关联到 Claude Code

飞书 CLI 基于 Skills 机制与 Claude Code 集成——安装 @larksuite/cli 和 CLI Skill 后，Skill 会自动注册到 Claude Code 中。配置完成后，务必重启 Claude Code（或重启 IDE）以确保所有 Skills 完整加载。

📋 7.3 飞书 CLI 能力概览

安装完成后，你的 Claude Code 将获得以下飞书操作能力：

业务域 能做什么
消息与群组 搜索消息和群聊、发消息、回复话题、管理成员、收发文件
云文档 创建文档、读取内容、更新正文、插入附件、搜索云文档
日历 查日程、约会议、查忙闲、推荐时间、预定会议室、回复邀约
多维表格 管理数据表、字段、记录、视图、表单、仪表盘
邮箱 搜索、读取、起草、发送、回复、转发、归档邮件
知识库 查询空间、管理成员、管理文档层级
通讯录 查询用户、搜索同事、查看部门
妙记 搜索妙记、下载音视频、获取总结待办章节
审批 查询审批实例、处理审批任务

✅ 7.4 验证

重启 Claude Code（或重启 IDE）后，尝试以下指令：

  • "帮我在飞书文档里创建一个会议纪要，标题是周会，内容总结今天的讨论"
  • "查一下飞书日历，我这周有哪些会议"
  • "给团队群发一条消息，提醒明天代码评审"

MCP 生态仍在快速发展中，你还可接入数据库、GitHub、Jira 等，逐步扩展 Agent 的能力边界。

❓ 7.5 常见问题

问题 解决方案
安装后提示 lark-cli: command not found 确认 CLI 所在目录已加入系统 PATH。执行 npm root -g 查看全局目录
授权失败，提示"授权码已过期" OAuth 授权码有效期只有几分钟，超时后重新执行 lark-cli auth login
调用 API 提示权限不足 根据报错提示补充授权：lark-cli auth login --scope "<权限范围>"。应用身份调用还需在飞书开放平台后台开通对应权限
企业管理员能否控制权限 可以。CLI 创建的应用仍然遵循企业统一管控规则
是否支持国际版 Lark 支持。通过 lark-cli config init 并配置国际版 Lark 的应用即可

查看完整命令：执行 lark-cli help 查看所有可用命令，lark-cli <命令> --help 查看具体用法。

🔄 八、日常使用流程

场景 如何触发 实际示例
写代码 IDE 中唤起 Claude Code，用中文描述需求 Agent 直接修改代码文件
切换模型 终端运行 cc-switch gui，鼠标点选 DeepSeek ↔ OpenAI 等
调用工具 对话中自然语言触发 查飞书日历、跑一下单测、发消息
沉淀技能 写成 Skill / MCP 生成变更日志、一键部署测试环境

⚠️ 九、注意事项

  1. 版本锁定：生产环境建议去掉 @latest，锁定到你验证过的版本号，避免自动升级带来不兼容。
  2. API Key 安全：不要将含密钥的配置文件提交到 Git。建议在 .gitignore 中加入 .claude/mcp.json。
  3. 成本控制：使用 DeepSeek 等第三方模型时，注意调用量和费用。cc-switch 仅做路由，不负责计费。
  4. 工具更新：Claude Code、cc-switch、飞书 CLI 均在快速迭代中，如遇命令或配置变化，请以各自官方文档为准。

整个环境搭下来不到半小时。之后每一次与 Agent 的交互，都等于获得一个随时在线的资深搭档。赶紧试试，让 AI 真正帮你写代码，而不是只回答问题。

有问题欢迎留言，我会尽量帮忙排查。

posted @ 2026-06-05 10:52  丿似锦  阅读(28)  评论(0)    收藏  举报