第7章 修改设置 · Codewhale 文档

修改设置大多数设置无需打开文件就能修改：在会话中用 /config，在 shell 中用 codewhale config。这一页介绍设置保存在哪里、如何修改，以及仓库能替你改什么、不能改什么。找到配置文件你的设置保存在 ~/.codewhale/config.toml。可以打印确切路径，或直接用编辑器打开：codewhale config path codewhale config edit想使用别的文件，传入 --config <路径> 或设置 CODEWHALE_CONFIG_PATH；两者同时存在时以命令行参数为准。Codewhale 曾名为 DeepSeek-TUI：如果只有旧的 ~/.deepseek/ 文件夹，仍会读取它，而新设置一律写入 ~/.codewhale/。修改设置在会话中，/config 打开设置编辑器，/settings 打开设置界面。/config audit 会列出哪些设置可以在本次会话中修改、哪些可以保存、哪些要重启后才生效——手动编辑之前先看一下。在 shell 中：codewhale config get tools codewhale config set telemetry false codewhale config unset telemetry codewhale config dump # the settings in effect, secrets redacted codewhale config doctor # unknown keys, empty secrets, malformed URLsconfig set 只处理它认识的配置项；遇到其他配置项时，它会告诉你应该去编辑哪个 TOML 表，而不会自作主张。只对一次运行试用设置--set KEY=VALUE 只在这一次启动中修改设置，不保存任何内容。它支持 provider、model、verbosity、approval_policy、sandbox_mode 和 telemetry，可以重复使用。codewhale --set model=deepseek-v4-pro --set sandbox_mode=read-only与仓库共享设置仓库可以附带 .codewhale/config.toml，为所有在其中工作的人建议一些设置。只有少数配置项会生效，而且安全相关的设置只能更严格：model这个仓库的默认模型。reasoning_effort例如为复杂的代码库设置 "high"。approval_policy, sandbox_mode只接受比你自己的设置更严格的值。allow_shellfalse 会关闭 shell 命令；true 会被忽略。max_subagents减少并行子 Agent 的数量，范围 1 到 128。notes_path把笔记保存在仓库里。密钥、服务端点、提供商选择、MCP 服务器、钩子、技能和额外的说明文件，始终来自你自己的配置，因此克隆下来的仓库无法让 Codewhale 指向它自己的服务器或文件。启动时加上 --no-project-config，可以在这一次运行中忽略仓库的配置文件。项目说明——Agent 在这个仓库里应该如何工作——请写在 AGENTS.md 中。运行 /init 即可生成一份。下一步连接模型提供商保存密钥，并查看 Codewhale 当前使用的是哪一把。设置模式与审批大多数人最先修改的设置。在事件发生时运行命令把你自己的脚本加入 [hooks] 表。