德语指令 · Claude Code / Codex

Claude Code 说德语:
language 设置与 CLAUDE.md 写法

Claude Code 的 settings 参考里有一项 language:值原样作为「一直用这种语言回答」的指令传给模型,Claude Code 不校验这个值。同一个值也决定语音听写语言和自动生成的会话标题语言。仓库层面的约定仍然写进 CLAUDE.md,Codex 那边对应的是 AGENTS.md。

更新于 2026-10-20

把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。

#CLAUDE.md#AGENTS.md#UTF-8 变音符#/context 核验

德语输出的四个关键点

language 设置

响应语言怎么设

官方 settings 参考:language 的值原样传给模型、不校验。Claude Code 的记忆页写道:这些文件用纯文本写,Claude 在每次会话开始时读取。

不校验

拼错了会怎样

官方明确写着:Claude Code 不检查这个值,拼错的语言名会原样送到模型手里而不是报错;同一个值还决定语音听写的语言(听写有固定支持列表,德语对应 de)和自动生成的会话标题语言。

一条链

Codex 如何读指令

Codex 把 AGENTS.md 描述为 "Give Codex extra instructions and context for your project",并从全局文件向下到工作目录构建一条链。

200 行

长度建议

Claude Code 文档自己的建议:"Target under 200 lines per CLAUDE.md file." 并提示 "Longer files consume more context and reduce adherence."

响应语言和仓库约定是两件事

language 设置管的是「回答用什么语言」这一件事:值原样传给模型、不校验,可以写在用户级、项目级、本地级或管理级的 settings 文件里;代码语言、标识符范围、commit 写法这些仓库约定,适合写进指令文件:CLAUDE.md 提供持久指令、每次会话开始时读取,越短越容易被遵守,Codex 侧对应的是 AGENTS.md。两个工具都把指令文件当上下文而不是强制配置,Claude Code 文档明确这么说,所以要求用德语回答这类规则和其他约定一样:简短、明确、位置靠前时才稳定,文件堆成散文墙时就会漂。可靠的写法是:一条语言规则、一处标识符范围约定、一个列出例外的位置。

德语团队最常踩的三个坑

三个反复出现的误会:第一,language 的值不校验,把语言名拼错不会报错,拼错的名字会原样送到模型那里;第二,早期版本在配置了 language 之后会把回答里的变音符(重音、变音符号、软尾符)丢掉,官方 CHANGELOG 记录这个缺陷已经修掉;第三,CLAUDE.md 里的块级 HTML 注释会在注入前被剥离,藏在注释里的规则根本到不了模型。

值得记住的三个文件

~/.claude/CLAUDE.md

跨所有项目的个人偏好 —— 写「请用德语解释」最合适的地方。

./CLAUDE.md

团队共享的项目指令,和代码一样提交、评审。

AGENTS.md

Codex 的项目指令文件,从仓库根目录逐级发现到当前工作目录。

有文档 vs 需要自己测

文档写明

Claude Code 的 settings 参考把 language 列为一处设置:作用域是 Any file —— 用户级、项目级、本地级和管理级的 settings 文件都能写;类型是任意语言名,官方示例写的是 "japanese";默认未设置,未设置时自动生成的会话标题跟随对话语言。同一个值也决定语音听写的语言,而听写有固定的支持列表,德语对应 de。指令文件这边同样有文档:CLAUDE.md 提供持久指令、在每次会话开始时读取,可用 @path/to/import 引入其他文件,块级 HTML 注释会在注入前被剥离,内容以系统提示之后的 user message 形式送达,文档建议控制在 200 行以内并指出更长的文件会降低遵守度;在未另行配置时,只有当工作目录及其上级不存在 CLAUDE.md 时 Claude Code 才会读 AGENTS.md。Codex 把 AGENTS.md 作为项目指令,从仓库根向工作目录依次合并、越靠近越优先、跳过空文件,并在 project_doc_max_bytes 定义的大小处停止加入。

官方没写死的部分 —— 请自己核对

官方把 language 的值原样当成指令交给模型,并且明说不检查这个值 —— 一个写错的名字不会报错,而是原样送到模型那里,由模型自己去读。同一个值也决定语音听写,而听写只有固定支持列表,德语对应 de,不在列表里的语言名在听写上没有对应项。模型是否始终用德语回答、这个设置在长会话里是否一直生效、ß 和变音符在标识符里怎么处理、您的文件顺序是否真的按预期加载 —— 这几件事只能用 /context 加一个小任务去验证,本页无法替您定论。

两个文件,两种职责

CLAUDE.md —— 行为规范

Claude Code 文档说得很直接:技术强制放 settings,行为规范放 CLAUDE.md。回答用什么语言本身是 settings 里的一项(language),语气、标识符范围、先解释再打补丁这类约定仍写在这里。

AGENTS.md —— Codex 的项目上下文

Codex 把 AGENTS.md 作为项目的指令与上下文读取,越靠近工作目录的文件越优先 —— 同一个把德语约定按仓库写一次的地方。

先写设置,再写规则

先在 settings.json 里定语言:打开 ~/.claude/settings.json,写成 { "language": "german" }(官方示例是 "japanese";值不校验,拼错不报错;这一项可以放在用户级、项目级或本地级 settings 文件里)。再写进仓库的那部分,建议段落:"Sprache: Antworte in Erklärungen, Plänen und Review-Kommentaren auf Deutsch. Code, Bezeichner, Dateinamen, Commit-Messages und Testnamen bleiben auf Englisch. Keine Umlaute in Bezeichnern — ae/oe/ue/ss verwenden. Halte jede Erklärung unter 10 Sätzen, bevor du fragst." 文件以 UTF-8 保存;在会话里运行 /context,确认它出现在 Memory files 列表下;再交一个真实任务,检查工具调用之后德语是否还在。

在 QCode 上

指令文件跟着 CLI 走,不跟着端点走:无论调用哪个模型,CLAUDE.md 与 AGENTS.md 都在请求发出前被工具读取。language 设置同理 —— 它写在你本机的 settings.json 里,由 CLI 读出后作为「用这种语言回答」的指令随请求发出。QCode 站内页面描述的做法是用 ANTHROPIC_BASE_URL 把 Claude Code 指向 Anthropic 兼容接口,并在 ~/.codex/config.toml 加入 QCode profile,模型清单以实时的 /models 为准 —— 因此同一份指令文件下换模型是常态,德语规则继续生效。

常见问题

有没有语言设置项?

有 —— Claude Code 的 settings 参考页里就有一项 language:它让 Claude 默认用英语以外的语言回答。官方写明这个值原样作为指令传给模型,所以任何模型读得懂的语言名都可以;而且 Claude Code 不检查这个值,拼错的名字会原样送到模型那里而不是报错。同一个值还决定语音听写的语言(听写有固定支持列表,德语对应 de)和自动生成的会话标题语言,默认未设置时标题跟随对话语言。

规则放哪里才能一直生效?

分两层:响应语言交给设置,仓库约定交给文件。在 ~/.claude/settings.json 写 { "language": "german" },它的作用域是 Any file —— 用户级的 ~/.claude/settings.json、项目级的 .claude/settings.json、项目本地的 .claude/settings.local.json 和管理级文件都能写这一项。Claude Code 把 ~/.claude/CLAUDE.md 记为跨所有项目的个人偏好,把 ./CLAUDE.md 记为团队共享的项目指令,代码语言、标识符范围这类约定就放在项目文件里。

CLAUDE.md 里写德语真的可行吗?

该文件就是纯文本 Markdown,文档在描述「每次会话开始时读取」时没有对自然语言做任何限制,所以这份文件里的德语只是普通内容。真正关键的是长度与位置:文档建议 200 行以内,并指出更长会降低遵守度。

标识符和 commit 也要用德语吗?

这是团队约定,不是厂商事实 —— 但务必明确写下来。不写就由模型每次任务自行决定,常见结果就是英文命名的代码库里混进德语标识符。标识符里不用变音符,还能避开下游的转写与编码问题。

哪些失败是无声的?

两条已文档化的行为:CLAUDE.md 的块级 HTML 注释会在注入前被剥离,藏在注释里的规则根本送不到;以及未另行配置时,只有工作目录及其上级没有 CLAUDE.md,Claude Code 才读 AGENTS.md —— 遗留的 AGENTS.md 可能被直接忽略。

换中转模型后德语还保吗?

指令文件由 CLI 在请求发出前读取,不绑定某个模型。具体模型能否稳定遵守德语是您自己的测试 —— 文档明确写着这些文件是上下文,不是强制配置。

信息来源

Claude Code:code.claude.com 的 settings 参考页(language 设置的定位、类型、默认值与作用域)、记忆页(/docs/en/memory)、settings 页、语音听写页与官方 CHANGELOG(2026-10-20 抓取)。Codex:developers.openai.com 的 AGENTS.md 与 CLI 文档(同日抓取)。QCode 一侧说法均来自站内页面。文档没说的,本页直说没说。

一份指令文件,从第一次会话起说德语

语言规则写一次,用 /context 核验,再在您实际调用的模型上过一遍。

不确定从哪开始?

先试一周

小包 ¥26($30 额度,7 天)

每天都用

体验版 ¥63/月,每天 $5 额度;每 $1 额度只要 ¥0.42,中包约 ¥0.79