官方原文 · 截至 2026-11-12

Claude Code 用阿拉伯语:回答语言与终端从右到左显示

截至 2026-11-12,Claude Code 能用阿拉伯语回答:官方设置参考里有 language 设置项,值会逐字传给模型,当作「始终用该语言回答」的指令,而且不校验拼写;官方帮助中心另写,任何语言都能和 Claude 对话。阿拉伯语在终端里的连写与从右到左顺序由终端自己决定,下面给出各终端的官方说明与可照抄的写法。

更新于 2026-11-13

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

#language 设置项#阿拉伯语 CLAUDE.md#终端 RTL#/context 核对

四条官方要点

language

回答语言是一个设置键

Claude Code 的设置参考写:这个值会逐字传给模型,当作「始终用该语言回答」的指令。回答语言没有固定清单,模型能读的语言名都可以。值不校验,拼错也照原样送过去。同一个键也决定语音听写和自动生成的会话标题的语言;语音听写另有自己的固定支持语言清单。

200 行

阿拉伯语 CLAUDE.md 的长度

官方记忆文档写 CLAUDE.md 是纯文本、每次会话开始时读取,并建议每个文件控制在 200 行以内:文件越长占用上下文越多,遵循度越低。阿拉伯语的规则块同样受这条约束。

UAX #9

显示顺序由双向算法决定

Unicode 双向算法(UAX #9)规定含从右到左字符的文本如何定位与按行重排;W3C 的国际化文章写,一段文字里夹进反方向短语时最容易出问题,URL、文件名与路径正是常见例子。

默认开

iTerm2 的 RTL 选项

iTerm2 官方文档列了一个「Enable support for right-to-left scripts」选项:开启后阿拉伯语、波斯语按 bidi 重排、字母连写,而不是按从左到右画成普通文本;官方写它默认开启。

回答语言和显示方向是两件事

截至 2026-11-12,答案分两层。第一层是模型说什么语言:Claude Code 的 language 设置项把值逐字交给模型当指令,所以写 arabic 就按这条指令用阿拉伯语回答;官方帮助中心也写,任何语言都能和 Claude 对话。第二层是终端和编辑器怎么画:阿拉伯字母要从右往左排、相邻字母要连写,这一步由终端模拟器或编辑器自己的 bidi 与字形处理决定,Claude Code 管不到。所以同一段阿拉伯语回答,在 iTerm2 里可能正常,在还没有 RTL 支持的终端里就会顺序颠倒或字母断开。

先设语言,再处理显示

官方 changelog 里有几条与阿拉伯语直接相关:2.1.280 修了清理不可见字符时误删波斯语和阿拉伯语用的零宽不连字符;2.1.295 修了含制表符或双向控制符的文本在屏幕边缘丢尾巴、压到相邻行;2.1.290 修了「You should know」提示无视 language 设置只写英文。粘贴带双向控制符的文本时,Claude Code 会在按 Enter 时清掉这些不可见字符再发送,但保留波斯语与印度系文字用的连接符。

官方记录里的几个节点

2017-06-13

xterm.js 开出 issue #701「Support RTL languages」,至今 open;VS Code 的集成终端就用它,issue 里写明 RTL 字符当时被按从左到右反向渲染。

2019-05-07

Windows Terminal 开出 issue #538「Support Right to Left (RTL) text」,至今 open;复现步骤是先打英文再打阿拉伯语,RTL 文本会跑进前面的英文里。

2020-01-28

kitty 0.16.0 加了 force_ltr 选项,可以把 RTL 文字按从右到左的显示关掉;更早的 0.10.0 对阿拉伯语渲染做过部分修复,官方说至少可读。

已确认 vs 需要你自己验证

已确认(官方原文)

① 回答语言:设置参考写 language 的值逐字传给模型、不校验、回答语言无固定清单,默认未设时会话标题跟随对话语言。② 任意语言对话:帮助中心写改不改语言设置都可以用任何语言和 Claude 对话。③ CLAUDE.md:纯文本、会话开始读取、建议 200 行以内、块级 HTML 注释注入前被去掉、可用 @path/to/import 引入文件。④ 不可见字符:粘贴带入的双向控制符与零宽空格会在按 Enter 时清掉,波斯语与印度系文字的连接符保留。⑤ 终端:iTerm2 有默认开启的 RTL 选项;kitty 有 force_ltr;Windows Terminal 与 xterm.js 的 RTL issue 仍 open。

官方没写、要你自己试的部分

Claude Code 文档没有说明它自己的终端界面在阿拉伯语下的排版规则,也没有承诺某个终端一定显示正确;iTerm2 把 RTL 选项放在实验性设置里。同一段阿拉伯语回答在某个终端里是否连写、标点是否落在正确一侧,取决于该终端的 bidi 与字形实现,以及所用字体是否含阿拉伯字形。把这些跑一遍再决定团队用哪个终端,比照着截图猜更可靠。

终端怎么选

想开箱就能看阿拉伯语

按 iTerm2 官方文档,它的 RTL 选项默认开启:阿拉伯语和波斯语会按 bidi 重排、字母连写。macOS 上想少折腾,就先从这一项核对。

已经在别的终端里

先看该终端的官方说明:kitty 有 force_ltr,可以关掉 RTL 顺序;Windows Terminal 与 xterm.js(VS Code 集成终端)的 RTL issue 仍是 open。显示不对时,把命令和路径放进反引号或代码块,让它们单独成行,能少踩 bidi 的坑;不订阅直接用 API 的做法见 /claude-code-without-subscription。

怎么设:语言、CLAUDE.md、显示

① 设回答语言:在 ~/.claude/settings.json 里写 {"language": "arabic"}。官方例子用小写语言名(japanese、spanish、french),值不校验,写错也不报错,会原样送给模型;language 的作用域是任意 settings 文件,也可以写进项目或 local 设置。② 写阿拉伯语规则:在仓库根目录的 CLAUDE.md 里写一行语言要求,例如「اكتب كل الشرح بالعربية. اكتب الكود وأسماء الملفات والأوامر بالإنجليزية.」——第一句要求用阿拉伯语解释,第二句让代码、文件名与命令保持英文。CLAUDE.md 是纯文本,会话开始时读取,官方建议控制在 200 行以内。③ 核对与显示:会话里跑 /context all,在 Memory files 下确认文件已加载;重开一个会话用阿拉伯语提一个真实任务,看终端是否连写、顺序是否正确。想快速核对,可以让 Claude 回复一个词 مرحبا(你好):能正确处理阿拉伯语的终端里,字母连成一体,م 是最右边的字母。显示不对就换终端,或按该终端的官方说明调整。

在 QCode 上

QCode 支持 claude-fable-5-2 等 Claude 型号:在 Claude Code 里把 ANTHROPIC_BASE_URL 设为 https://api.qcode.cc/api,model 填 claude-fable-5-2,阿拉伯语设置与 CLAUDE.md 都留在本机,换模型不用改它们。一把 QCode key 同时提供 Anthropic 与 OpenAI 两种兼容接口,其中 Claude 模型只走 Anthropic 接口。QCode 按 token 计费,各模型单价见 /models。不想包月,可以看按量包 /pay-as-you-go:一次买一笔额度。

常见问题

Claude Code 支持阿拉伯语吗?

支持。官方设置参考写 language 的值会逐字传给模型,当作「始终用该语言回答」的指令,回答语言没有固定清单,模型能读的语言名都可以;帮助中心也写,任何语言都能和 Claude 对话,Claude 会用你使用的语言回答。

怎么让它默认用阿拉伯语回答?

在 ~/.claude/settings.json 里加 {"language": "arabic"}。值不校验,拼写照原样送给模型;作用域是任意 settings 文件,也可以写进项目或 local 设置;默认未设时会话标题跟随对话语言。想连仓库约定一起固定,再在 CLAUDE.md 写一行阿拉伯语要求。

终端里阿拉伯字母不连写、顺序反了怎么办?

这是终端的 bidi 与字形处理,不是模型输出。iTerm2 官方文档的 RTL 选项默认开启,会做 bidi 重排与字母连写;kitty 有 force_ltr 可以关掉 RTL 顺序;Windows Terminal 与 xterm.js(VS Code 集成终端)的 RTL issue 仍是 open。显示不对时优先换一个官方写明支持 RTL 的终端,并把命令、路径放进反引号或代码块。

CLAUDE.md 能用阿拉伯语写吗?

能。官方写 CLAUDE.md 是纯文本、每次会话开始时读取,没有对自然语言的限制;建议每个文件 200 行以内,越长越容易被忽略;块级 HTML 注释在注入前会被去掉,所以规则别写在注释里。用 /context all 可以确认文件确实加载。

回答里夹着英文路径和命令,标点跑到行首怎么办?

阿拉伯语里夹英文属于双向文本:Unicode 双向算法按字符方向重排,W3C 写 URL、文件名与路径这类反方向短语最容易出问题,括号等镜像字符的形状也随方向变。实际做法是让这些片段单独成行或放进反引号 / 代码块,别让它们紧贴阿拉伯语句子。

代码、标识符、提交信息用哪种语言?

这是团队约定,不是厂商规定。常见做法是解释、计划、评审意见用阿拉伯语,代码、标识符、文件名、提交信息保持英文,避免标识符里出现阿拉伯字母带来的转写与编码麻烦;把它写进 CLAUDE.md,写清哪一层用哪种语言,比每次口头交代可靠。

来源

Claude Code 官方文档:设置参考(language 条目)、settings、memory(CLAUDE.md)、interactive-mode(不可见字符)、官方 changelog(2.1.280 / 2.1.290 / 2.1.295 / 2.1.300)。Anthropic 帮助中心:How to use Claude in your preferred language。终端与编辑器:iTerm2 官方文档、kitty 官方 changelog、Windows Terminal 与 xterm.js、VS Code 的官方仓库 issue;Unicode UAX #9 与 W3C 的双向文本文章。QCode:qcode.cc/models 与 docs.qcode.cc 的接入点页。以上均于 2026-11-12 抓取。

准备好让 Claude Code 说阿拉伯语了?

创建一把 QCode key,把 Claude Code 指向它,按 token 计费。不想包月?按量包 ¥26 起,一次买一笔额度、7 天内用完;已有个人套餐的用户额度不够时买加油包。

不确定从哪开始?

先试一周

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

每天都用

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