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 文件夹)