Claude Code 的配置、生态与内部 Harness 设计(含源码级解析)。国产模型接入与 OpenAI兼容LLM接入通用模式 同源。

国产模型接入(环境变量三件套)

ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN / ANTHROPIC_MODEL:智谱 https://open.bigmodel.cn/api/anthropic(GLM-4.7)、Kimi https://api.moonshot.cn/anthropic、火山 https://ark.cn-beijing.volces.com/api/coding;可加 DEFAULT_HAIKU/SONNET/OPUS_MODEL 全量映射;切换器 claude-code-router(ccr use kimi/glm/claude);一键配置 npx @z_ai/coding-helper。

核心工作流

  • 高频斜杠命令:/clear(保代码清上下文)、/compact(长任务定期做)、/init(生成 CLAUDE.md)、/context(token 网格)、/model、/cost、/doctor;共 45 个;
  • Plan Mode(Shift+Tab×2):复杂任务一律 Plan 起;技巧”计划先存 plan.md 再选自动执行”留底;让第二个 Claude 以 Staff Engineer 角色 review 计划;跑偏立刻切回 Plan 重规划别硬推;
  • Boris 四技巧:①角色反转”针对这些改动向我提问,通过测试前不要提交 PR”②要求自证”对比 main 和 feature 分支证明可行”③推倒重来”给更优雅实现”④先写 Spec 再动手(模糊需求=模糊代码);
  • .claude 体系:项目级 .claude/(进 git)vs ~/.claude/(个人);CLAUDE.md ≤200 行(超长遵守度反降);rules 可加 paths: 路径作用域;commands 支持 !`cmd` 预执行与 $ARGUMENTS;Commands 等召唤、Skills 看时机自己出手;agents/*.md 定义 model 与 tools 最小权限;settings.json permissions allow/deny;
  • 远程方案:/remote-control(“只出不进”安全模型:本地进程主动轮询拉消息不开入站端口+账号强绑定+临时凭证,仅 Max 会员);组合拳=Mac Mini 24h 主机 + Codex 官方远程 + UU 远程兜底图形界面(可远程启动 CLI);
  • 微信接入:官方 ClawBot 插件 + ilink 协议(getupdates 长轮询收消息/context_token 回复);Claude Code Channels(官方 research preview)--dangerously-load-development-channels。

内部 Harness 设计(源码级解析,最有分量)

  • System Prompt 动态组装:静态 7 模块 + 动态模块(memory/output_style/mcp_instructions/token_budget 等);CLAUDE.md 以 <system-reminder> 包裹插到用户消息最前面,被当高优先级用户指令;缓存分块提高 KV Cache 命中;
  • 三层渐进压缩:①MicroCompact 纯规则(只压 Bash/Read 大输出,Edit/Write 完整保留)②Session Memory Compact(token≥10K 且消息≥5 触发,上限 40K)③Full LLM Compact(9 段式模板:Primary Request/Key Concepts/Files/Errors/…,输出前先 <analysis> 推演再 <summary>);AutoCompact 水位线 13K token;
  • Memdir 四类记忆:User 偏好/Feedback 纠错/Project 架构决策/Reference 模式;检索用 Sonnet 语义判断最多只返回 5 条;
  • 六大内置子 Agent:General/Explore(只读 Haiku,最少 3 次搜索才值得动用)/Plan/Verification(红蓝对抗:“你的工作是想办法把它搞崩”;反偷懒话术”代码看起来是对的——看起来不是验证,运行它”)/Statusline/Fork(继承完整历史+共享 prompt cache 极便宜);
  • 安全:Linux bubblewrap 沙箱(只读挂载+独立 namespace);hooks 20+ 事件可返回 {"blocked":true} 熔断或动态改参脱敏;主循环 async 生成器(流式/优雅取消/prompt-too-long 自动三级压缩/网络指数退避)。

Agent Team 轮班工人模式

experimental.agent_team:true 开启;AI 不记脑内记文件:feature_list.json(JSON 工单,模型对 JSON 的破坏性远小于 Markdown)+ progress.txt(交接日志)+ CLAUDE.md(启动必读协议)+ init.sh;run_autonomy.py 循环调 CLI,失败 git 回滚;分工 Lead/@backend/@frontend/@qa(QA 不自己修,把报错甩给 Backend)。

原始素材(重点篇目)

  • 内部机制全解
  • .claude 全地图
  • 国产模型接入
  • Agent Team
  • 最佳实践仓库
  • 远程方案

相关页面

出处 · raw/articles/bookmarks/(浏览器收藏 2026-09-19,claudecode 文件夹)