cloude code 设计架构

windows + cc + ds

可以直接看 deepseek 官网的链接: https://api-docs.deepseek.com/zh-cn/guides/anthropic_api

安装后遇到无法启动的问题

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
D:\code\open\ruoYiAI\ruoyi-ai>claude
Welcome to Claude Code v2.1.86
…………………………………………………………………………………………………………………………………………………………

* █████▓▓░
* ███▓░ ░░
░░░░░░ ███▓░
░░░ ░░░░░░░░░░ ███▓░
░░░░░░░░░░░░░░░░░░░ * ██▓░░ ▓
░▓▓███▓▓░
* ░░░░
░░░░░░░░
░░░░░░░░░░░░░░░░
█████████ *
██▄█████▄██ *
█████████ *
…………………█ █ █ █………………………………………………………………………………………………………………

Unable to connect to Anthropic services

Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

Please check your internet connection and network settings.

Note: Claude Code might not be available in your country. Check supported countries at
https://anthropic.com/supported-countries

执行下面的命令,跳过引导流程,直接进入主界面

1
powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

修改 .claude.json 文件,添加 deepseek 模型配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "api-key",
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-flash[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash[1m]",
"CLAUDE_CODE_SUBAGENT_MODEL":"deepseek-v4-flash[1m]",
"ANTHROPIC_MODEL": "deepseek-v4-flash[1m]",
"API_TIMEOUT_MS": "600000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": 500000
},
"includeCoAuthoredBy": false,
"effortLevel": "medium",
"language": "chinese"
}

2026.04.24: deepseek 支持 1M 上下文,更新下相关配置,相关信息参考官网链接:https://api-docs.deepseek.com/zh-cn/news/news260424

harness 架构

harness: 马具,用来指导 llm 进行正确的工具调用和上下文管理的设计模式

agent 的上下文通过文件来管理,不同的文件对应不同的上下文类型,如需求文档、设计文档、代码文件等,llm 按需读取对应的文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
AGENTS.md
ARCHITECTURE.md
docs/
├── design-docs/
│ ├── index.md
│ ├── core-beliefs.md
│ └── ...
├── exec-plans/
│ ├── active/
│ ├── completed/
│ └── tech-debt-tracker.md
├── generated/
│ └── db-schema.md
├── product-specs/
│ ├── index.md
│ ├── new-user-onboarding.md
│ └── ...
├── references/
│ ├── design-system-reference-llms.txt
│ ├── nixpacks-llms.txt
│ ├── uv-llms.txt
│ └── ...
├── DESIGN.md
├── FRONTEND.md
├── PLANS.md
├── PRODUCT_SENSE.md
├── QUALITY_SCORE.md
├── RELIABILITY.md
└── SECURITY.md

参考连接: