donglin.li

主页/Home 履历/CV 帖文/Posts 深色/Dark

🔖 · Claude Code爽用教程

Posted on 2026/1/27

    注:我用的是macOS

    1. 安装

    教程很多,官方推荐的是npm安装,但是我更喜欢homebrew

    brew install claude-code

    2. Shell环境准备

    找到bash配置文件,在/Users/<用户名>/.zshrc

    修改默认编辑器

    对于新手来说,如果不小心在设置Claude Code的时候打开了编辑器(默认是vi),直接就废了,只能关掉终端重来。建议直接替换为更加友好的编辑器,例如VS Code

    首先在VS Code中cmd+shift+p,输入shell,选择Shell Command: Install 'code' command in PATH,然后在.zshrc中添加

    export EDITOR="code --wait"

    这样每当需要编辑的时候,文档就会在VS Code中打开,编辑完成后关闭VS Code窗口即可继续后续操作

    替换DeepSeek API

    最开始尝试了claude-code-router和cc-switch。相对而言cc-switch更好用,适合需要切换不同API的用户

    但是本文的标题说的是“爽用”,所谓爽用,肯定选便宜管饱的DeepSeek API。只用DeepSeek API的话,直接在.zshrc中配置环境变量是最简单的

    DeepSeek官方支持Anthropic API格式,参考DeepSeek API文档在.zshrc中添加如下内容

    export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
    export ANTHROPIC_AUTH_TOKEN=sk-<你的DeepSeek API Key>
    export API_TIMEOUT_MS=600000
    export ANTHROPIC_MODEL=deepseek-chat
    export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat
    export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1"

    这里虽然写的是deepseek-chat,但实际上也会按需调用思考模式,即deepseek-reasoner

    3. 工具自定义

    WebSearch替换

    替换API后,Claude Code的WebSearch功能就无法使用了。受到oh-my-opencode的启发,添加了exa来实现网络搜索与文档检索功能(顺便也不用装context7了)

    claude mcp add exa --scope user --transport http "https://mcp.exa.ai/mcp?tools=web_search_exa,get_code_context_exa"

    上述命令中,--scope user是在用户级别安装(本地全局安装)。此外该命令只安装了exa的网络搜索和文档检索工具。如果默认安装的话,会额外安装一个公司调研工具,我感觉没啥用

    工具 描述
    web_search_exa 搜索网络并获取整洁的内容
    get_code_context_exa 从 GitHub 和 Stack Overflow 查找代码片段与文档

    浏览器自动化

    Browser-Use (Skill)

    Browser-Use Skill来实现浏览器自动化是目前最佳的方式,下面记录一下我的安装流程

    uv tool install browser-use
    # browser-use install   #这一步不做,直接用现有的Chrome

    然后新建技能目录

    mkdir -p ~/.claude/skills/browser-use

    在里面粘贴SKILL.md文件就可以了。

    我对SKILL.md做了一些修改,主要是让他默认使用Chrome浏览器(--browser real模式)

    Chrome DevTools (MCP)

    Chrome Devtools MCP支持更精细的操作,可以满足更专业的需求

    安装和配置比较简单

    brew install chrome-devtools-mcp
    claude mcp add chrome-devtools --scope user /opt/homebrew/bin/chrome-devtools-mcp

    上述命令最后的路径是chrome-devtools-mcp的安装路径,可以通过which chrome-devtools-mcp查看

    由于MCP比较烧token,而且大部分功能可以被browser-use代替,所以我没装

    Trae中的智能体可以选择性加载MCP,并按需调用,污染上下文。如果真的需要用Chrome DevTools的话,可以去Trae里面用。(还不用花自己的token)

    插件

    在Claude Code里面/plugin一下就能看到插件市场

    Claude Code是支持LSP的,建议把常用语言的LSP装上。我装了pyright-lsp(需要先brew install pyright

    4. 其他

    记忆

    在Claude Code中/memory,就可以手动写入记忆(也就是CLAUDE.md)。鉴于刚刚我们对修改了WebSearch的工具,所以最好在记忆中声明一下

    我是这样写的

    - 当前Claude Code使用的是DeepSeek API。该模型**没有多模态能力**- **软件/包/环境**管理工具使用优先级:**homebrew > uv > 其他**
    
    - 默认的WebSearch工具由于网络原因无法使用,**强制**使用exa中的**web_search_exa**工具来替代

    上下文自动压缩

    Claude Code 默认上下文窗口是200k,在使用了80%的时候自动压缩上下文。但是DeepSeek的上下文窗口只有128k,不做修改的话会在自动/compact之前耗尽,导致项目中断

    解决办法是在~/.zshrc中添加:

    export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=50

    这样的话会在100k左右的时候进行自动压缩,大约是DeepSeek上下文窗口的83%

    Powered by Hexo
    Theme based on Minima by Adi Sakti Jrs
    Published on GitHub