1. 为什么你的 Claude Code 总是“差点意思”Claude Code 是 Anthropic 推出的终端 AI 编码代理能读文件、跑命令、改代码、走 Git 流程适合已经习惯命令行、又想让 AI 深度参与日常开发的工程师。但很多人装完之后发现它好像没那么神——改错文件、忘记项目规范、每次都要重新解释一遍背景、上下文一长就开始胡言乱语。问题往往不在模型本身而在于你没有把“项目记忆、代码诊断、工具接入、Git 工作流”这四件事配好。这篇围绕四条主线展开CLAUDE.md 项目记忆、LSP 代码诊断、MCP 工具接入、Git worktree 并行开发并给出可直接复制的settings.json与config.toml骨架。同时演示如何通过 TaoToken 统一 Key/API 通道完成接入让 Claude Code 的请求走一条稳定、可复用的通道而不是每次手动改环境变量。全文按“能跟做”的标准写命令、参数、报错排查都给到位。2. 前置用 TaoToken 统一 Key 与 API 通道Claude Code 默认读ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL两个环境变量。如果你同时用多个 AI 工具每个工具配一套 Key 会非常乱。TaoToken 的做法是给你一个统一入口把模型调用收敛到一条通道上Claude Code、Coding Plan、模型对话都从这里走。官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址不带 UTMhttps://taotoken.net/api你需要先拿到一个 API Key。进入控制台创建控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建后复制 Key形如sk-xxxx。接下来把它写进 shell 配置而不是每次临时 export。以 zsh 为例编辑~/.zshrc# TaoToken 统一通道 export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的Key # 顺手加个别名后面所有技巧都用 cc 启动 alias ccclaude保存后source ~/.zshrc。这一步同时解决了技巧 1cc 别名和通道配置。注意ANTHROPIC_BASE_URL只写到/api不要自己拼/v1Claude Code 会按协议补路径多写反而 404。注意Key 不要提交进 Git。建议在项目.gitignore里加上.env、.claude/settings.local.json这类本地文件。3. 可复制配置CLAUDE.md、settings.json 与 config.toml3.1 CLAUDE.md 项目记忆骨架CLAUDE.md 是 Claude Code 每次会话自动读取的项目记忆文件。放在仓库根目录用/init可以自动生成初版但自动生成的往往太泛建议手动补上“规范、命令、禁区”三块。下面是我常用的骨架# 项目xxx-service ## 技术栈 - Node.js 20 TypeScript 5.4 - 框架Fastify - 测试Vitest - 包管理pnpm ## 常用命令 - 安装pnpm install - 开发pnpm dev - 测试pnpm test - 类型检查pnpm tsc --noEmit - Lintpnpm lint --fix ## 代码规范 - 禁止 any用 unknown 类型守卫 - 所有导出函数必须有 JSDoc - 错误统一走 src/errors/AppError.ts ## 目录约定 - src/routes/ 路由 - src/services/ 业务逻辑 - src/db/ 数据访问 ## 禁区 - 不要改 pnpm-lock.yaml - 不要动 migrations/ 下已合并的文件 - 提交前必须跑 pnpm test有了它你就不用每次重复“我们用 pnpm 不用 npm”“别用 any”。实测下来这一条对减少返工最明显。3.2 settings.json 配置骨架Claude Code 的项目级配置放在.claude/settings.json权限、环境变量、MCP 都在这里。骨架如下{ permissions: { allow: [ Bash(pnpm test:*), Bash(pnpm lint:*), Bash(git status), Bash(git diff:*), Read(src/**), Edit(src/**) ], deny: [ Bash(rm -rf:*), Bash(git push:*), Read(.env) ] }, env: { ANTHROPIC_BASE_URL: https://taotoken.net/api }, mcpServers: { filesystem: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, ./src] } } }allow里放你信任的高频命令减少每次确认deny把危险操作和敏感文件挡掉。mcpServers先放一个文件系统 MCP 试水后面第 5 节展开。3.3 config.toml 配置骨架如果你用支持 TOML 的客户端或自建网关config.toml可以这样写把通道和模型映射集中管理[provider] name taotoken base_url https://taotoken.net/api api_key_env ANTHROPIC_API_KEY [models] default claude-sonnet-4-5 fast claude-haiku-4-5 [claude_code] worktree true lsp true auto_init trueapi_key_env指向环境变量而不是硬编码 Key这样配置文件可以进仓库Key 留在本地。worktree true对应第 6 节的并行开发。4. LSP 与 MCP让 Claude Code 真正“看懂”代码4.1 装语言专用 LSPClaude Code 本身不内置语言智能靠 LSP 提供补全、跳转、诊断。装对应语言的 server 后它才能准确定位符号、理解类型。常用组合语言LSP Server安装命令TypeScripttypescript-language-serverpnpm add -g typescript-language-server typescriptPythonpyrightpip install pyrightRustrust-analyzerrustup component add rust-analyzerGogoplsgo install golang.org/x/tools/goplslatest装完后在settings.json里确认 LSP 开启部分版本默认开。验证方式让 Claude Code 分析一个跨文件函数调用比如“src/auth.ts里的verifyToken被哪些文件引用”如果它能准确列出说明 LSP 生效了。没装 LSP 时它只能靠文本搜索容易漏。4.2 MCP 工具接入MCPModel Context Protocol是标准化的工具接入协议让 Claude Code 能操作文件系统、查数据库、调 API、跑浏览器自动化。原则是“按需接入”别一次装一堆。除了上面的 filesystem再给一个数据库查询的例子{ mcpServers: { postgres: { command: npx, args: [ -y, modelcontextprotocol/server-postgres, postgresql://readonly_userlocalhost:5432/mydb ] } } }注意数据库 MCP 一定用只读账号别把生产库的写权限交出去。这是踩过的坑查询类工具给只读权限就够了。接入后重启 Claude Code用/mcp查看已加载的 server 列表确认状态是 connected。5. 验证请求确认通道与工具都通了配置写完必须验证否则后面出问题分不清是通道还是工具。分三步。第一步验证 TaoToken 通道。在终端直接发一个最小请求curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: $ANTHROPIC_API_KEY \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-5, max_tokens: 64, messages: [{role: user, content: 回复 OK 两个字母}] }返回里带content字段且文本是 OK说明 Key 和通道没问题。如果返回 401检查 Key 是否复制完整返回 404检查 base_url 是否多写了/v1。第二步验证 Claude Code 能读到 CLAUDE.md。启动cc输入“这个项目用什么包管理器”它应该答 pnpm。答错说明 CLAUDE.md 没被读到检查文件是否在仓库根目录、文件名大小写是否正确。第三步验证 MCP。输入“列出 src 目录下的文件”如果它调用了 filesystem MCP 并返回真实文件列表说明工具链通了。想快速对比模型输出可以打开模型对话页面手动测同一问题模型对话https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content6. 常见错排查与 Git worktree 并行开发6.1 高频报错对照现象原因处理401 UnauthorizedKey 错误或未加载echo $ANTHROPIC_API_KEY确认重开终端404 Not Foundbase_url 多写路径只保留https://taotoken.net/apiMCP 显示 failednpx 拉包失败手动跑一次npx -y modelcontextprotocol/server-filesystem ./src看报错读不到 CLAUDE.md文件位置或权限放仓库根目录检查permissions.allow是否含 ReadLSP 不生效server 未装或未在 PATHwhich typescript-language-server确认上下文混乱历史信息干扰执行/clear清空再开新任务6.2 Git worktree 并行开发Claude Code 支持--worktree参数底层是 Git worktree同一个仓库同时检出多个分支到不同目录互不干扰。适合“一边修 bug 一边开发新功能”。用法# 为当前任务创建独立 worktree cc --worktree feature/login # 另开一个终端处理紧急修复 cc --worktree hotfix/token-expire每个 worktree 有独立工作目录和上下文Claude Code 在各自目录里改代码不会互相覆盖。合并时按正常 Git 流程走。这样避免了频繁git stash和分支切换导致的上下文丢失。如果你长期跑编码任务、Agent 自动化建议用 Coding Plan 把额度集中管理Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content6.3 几个提效小动作直接贴完整报错堆栈别转述成“这里报了个类型错误”堆栈里的文件路径和行号是精确定位的关键。任务无关时执行/clear保持上下文干净。复杂任务先用计划模式让它列步骤确认后再动手。指定文件时给明确路径比如“分析src/auth.ts和src/middleware/jwt.ts”比“帮我看看代码”准确得多也省 token。接入文档和 API Keys 都在下面配置卡住时对照检查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content把 CLAUDE.md 写扎实、LSP 装齐、MCP 按需接、worktree 用起来再让所有请求走 TaoToken 统一通道这套环境基本可以稳定复用。剩下的就是根据自己项目往里填规范越用越顺。
