德语指令 · Claude Code / Codex

让 Claude Code 与 Codex 用德语回答
真正能生效的 CLAUDE.md 与 AGENTS.md 写法

我们核查的两个工具文档页面都没有语言或 locale 设置项 —— 有的是指令文件。Claude Code 在每次会话开始时读取 CLAUDE.md;Codex 从 AGENTS.md 构建一条指令链。所以德语输出是一件写下来的事,不是一个开关。

更新于 2026-10-01

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

决定结果的四个机制

每次会话

CLAUDE.md 何时被读

Claude Code 的记忆页写道:"You write these files in plain text; Claude reads them at the start of every session."

user message

文本如何送达

同一页面说明:CLAUDE.md 内容作为系统提示之后的 user message 送达,而不是系统提示本身的一部分。

一条链

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."

为什么语言规则必须写下来

两个工具都把指令文件当上下文而不是强制配置 —— Claude Code 文档明确这么说。因此要求用德语回答这类规则和其他约定一样:简短、明确、位置靠前时才稳定;文件堆成散文墙时就会漂。可靠的写法是:一条语言规则、一处标识符范围约定、一个列出例外的位置。

德语团队最常踩的三个坑

反复出现的错误有三个:把规则藏在注释里(CLAUDE.md 的块级 HTML 注释在注入前会被剥离);没有规定代码语言,于是标识符被顺手改成德语;以及让文件长到规则不再被遵守。三条都是文档里写明的行为,不是传言。

值得记住的三个文件

~/.claude/CLAUDE.md

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

./CLAUDE.md

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

AGENTS.md

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

有文档 vs 需要自己测

文档写明

CLAUDE.md 提供持久指令、在每次会话开始时读取;可用 @path/to/import 引入其他文件;块级 HTML 注释会在注入前被剥离;内容以系统提示之后的 user message 形式送达;文档建议控制在 200 行以内并指出更长的文件会降低遵守度;在未另行配置时,只有当工作目录及其上级不存在 CLAUDE.md 时 Claude Code 才会读 AGENTS.md。Codex 把 AGENTS.md 作为项目指令,从仓库根向工作目录依次合并、越靠近越优先、跳过空文件,并在 project_doc_max_bytes 定义的大小处停止加入。

无文档 —— 请在自己仓库测

我们核查的 Claude Code 与 Codex 页面上都没有回答语言或 locale 开关,因此本页不承诺存在「打开德语」的设置项。长工具链会话中德语能保持多久、ß 和变音符在标识符里怎么处理、您的文件顺序是否真的按预期加载 —— 这三件事只能用 /context 加一个小任务去验证,本页无法替您定论。

两个文件,两种职责

CLAUDE.md —— 行为规范

Claude Code 文档说得很直接:技术强制放 settings,行为规范放 CLAUDE.md;语言、语气、先解释再打补丁都写在这里。

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

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

一段可直接粘贴的德语规则

保持短而明确。建议段落:"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 都在请求发出前被工具读取。QCode 站内页面描述的做法是用 ANTHROPIC_BASE_URL 把 Claude Code 指向 Anthropic 兼容接口,并在 ~/.codex/config.toml 加入 QCode profile,模型清单以实时的 /models 为准 —— 因此同一份指令文件下换模型是常态,德语规则继续生效。

常见问题

有没有语言设置项?

核查过的页面没有 —— Claude Code 的 settings 与环境变量参考都未列出回答语言或 locale 选项,Codex 的指令文档也没有。文档化的是指令文件,所以语言是写下来而不是配置出来。

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

放个人文件: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 的记忆页("How Claude remembers your project")、settings 页与环境变量参考(2026-10-01 抓取)。Codex:developers.openai.com 的 AGENTS.md 与 CLI 文档(同日抓取)。QCode 一侧说法均来自站内页面。文档没说的,本页直说没说。

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

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

相关阅读

两个厂商的工具文档都会变;本页引用的行为均读自 2026-10-01 的官方页面。模型对德语输出的表现不是厂商承诺,请在您的仓库上验证。

先体验,再决定

不确定选哪档?先买体验版(¥60/月),满意再升级,旧套餐剩余价值按比例退回余额。