Skip to content

利用 AI 大模型和自动化工作流,根据主题或关键词一键生成高清短视频。Generate HD short videos from a topic or keyword with an automated AI workflow.

fix(llm): isolate claude_code auth and configuration, accept numeric timeout

fred-ngb20f0a8bb220
diff --git a/app/services/llm.py b/app/services/llm.py
index 30fc43d0..c8f1ec8a 100644
--- a/app/services/llm.py
+++ b/app/services/llm.py
@@ -1,6 +1,11 @@
import json
import logging
+import math
+import os
import re
+import shutil
+import subprocess
+import tempfile
from time import perf_counter
from typing import List
@@ -49,12 +54,79 @@ CLAUDE_CODE_SYSTEM_PROMPT = (
"You are a concise copywriter. Follow the user's instructions and output "
"format exactly, and output nothing else."
)
-# 文案生成是一次纯文本请求,不需要任何工具。显式禁用可以避免 CLI 在容器里
-# 尝试读写文件或联网,从而让每次调用都是确定的单轮生成。
-CLAUDE_CODE_DISALLOWED_TOOLS = (
- "Bash Read Write Edit NotebookEdit Glob Grep WebFetch WebSearch Task"
-)
CLAUDE_CODE_DEFAULT_TIMEOUT = 300.0
+# `--tools ""` 关闭全部内置工具,`--safe-mode` 关闭 CLAUDE.md、skills、hooks、
+# plugins、MCP 等所有用户级定制,同时保持鉴权、模型选择和权限正常工作。
+# 二者需要较新的 CLI;低版本会以 "unknown option" 退出,由调用处转成明确提示。
+CLAUDE_CODE_MIN_CLI_VERSION = "2.1.260"
+# 这些环境变量会让 CLI 改用 API Key 或第三方供应商,从而绕过订阅登录并产生
+# 额外计费。claude_code Provider 的前提是「只用订阅」,所以调用前必须剔除。
+CLAUDE_CODE_CONFLICTING_ENV_VARS = (
+ "ANTHROPIC_API_KEY",
+ "ANTHROPIC_AUTH_TOKEN",
+ "ANTHROPIC_BASE_URL",
+ "ANTHROPIC_CUSTOM_HEADERS",
+ "ANTHROPIC_MODEL",
+ "ANTHROPIC_SMALL_FAST_MODEL",
+ "ANTHROPIC_DEFAULT_HAIKU_MODEL",
+ "ANTHROPIC_DEFAULT_SONNET_MODEL",
+ "ANTHROPIC_DEFAULT_OPUS_MODEL",
+ "CLAUDE_CODE_USE_BEDROCK",
+ "CLAUDE_CODE_USE_VERTEX",
+ "AWS_BEARER_TOKEN_BEDROCK",
+)
+
+
+def coerce_claude_code_timeout(value, config_key: str = "claude_code_timeout"):
+ """
+ 把配置里的超时值解析成正的有限秒数。
+
+ TOML 既可能写成 `claude_code_timeout = 300`(int/float),也可能写成
+ `"300"`(字符串),因此不能直接调用 `strip()`。nan / inf 会让
+ `subprocess.run(timeout=...)` 永久阻塞,这里一并拒绝。
+ """
+ if value is None:
+ return CLAUDE_CODE_DEFAULT_TIMEOUT
+
+ if isinstance(value, bool):
+ # bool 是 int 的子类,但 True 秒显然不是用户想要的超时配置。
+ raise ValueError(f"{config_key} must be a number of seconds, got {value!r}")
+
+ if isinstance(value, str):
+ text = value.strip()
+ if not text:
+ return CLAUDE_CODE_DEFAULT_TIMEOUT
+ try:
+ seconds = float(text)
+ except ValueError:
+ raise ValueError(
+ f"{config_key} must be a number of seconds, got {value!r}"
+ ) from None
+ elif isinstance(value, (int, float)):
+ seconds = float(value)
+ else:
+ raise ValueError(f"{config_key} must be a number of seconds, got {value!r}")
+
+ if not math.isfinite(seconds):
+ raise ValueError(f"{config_key} must be a finite number, got {value!r}")
+ if seconds <= 0:
+ raise ValueError(f"{config_key} must be greater than 0, got {value!r}")
+ return seconds
+
+
+def build_claude_code_env(base_env=None):
+ """
+ 构造只依赖订阅登录的子进程环境。
+
+ 返回 (环境变量字典, 被剔除的变量名列表)。剔除的是会切换鉴权方式或供应商
+ 的变量,`CLAUDE_CODE_OAUTH_TOKEN` 必须保留:容器内没有 keychain,CLI 只能
+ 靠它完成订阅鉴权。
+ """
+ env = dict(os.environ if base_env is None else base_env)
+ removed = [name for name in CLAUDE_CODE_CONFLICTING_ENV_VARS if name in env]
+ for name in removed:
+ env.pop(name, None)
+ return env, removed
def _normalize_text_response(content, llm_provider: str) -> str:
@@ -373,11 +445,6 @@ def _generate_response(prompt: str, app_config=None) -> str:
# Claude Code 官方客户端自己使用。这里不直接请求 Anthropic API,
# 而是以 headless 模式调用本机已登录的 claude CLI(`claude -p`),
# 由 CLI 完成鉴权,脚本生成只消费它返回的文本。
- import os
- import shutil
- import subprocess
- import tempfile
-
configured_cli = (extra_values.get("cli_path") or "").strip() or "claude"
cli_path = shutil.which(configured_cli)
if not cli_path and os.path.isfile(configured_cli):
@@ -389,23 +456,12 @@ def _generate_response(prompt: str, app_config=None) -> str:
f"{provider.config_key('cli_path')} in the config.toml file."
)
- configured_timeout = (extra_values.get("timeout") or "").strip()
try:
- timeout_seconds = (
- float(configured_timeout)
- if configured_timeout
- else CLAUDE_CODE_DEFAULT_TIMEOUT
- )
- except ValueError:
- raise ValueError(
- f"{llm_provider}: {provider.config_key('timeout')} must be a "
- f"number of seconds, got '{configured_timeout}'."
- )
- if timeout_seconds <= 0:
- raise ValueError(
- f"{llm_provider}: {provider.config_key('timeout')} must be "
- "greater than 0."
+ timeout_seconds = coerce_claude_code_timeout(
+ extra_values.get("timeout"), provider.config_key("timeout")
)
+ except ValueError as timeout_error:
+ raise ValueError(f"{llm_provider}: {timeout_error}") from None
command = [
cli_path,
@@ -415,15 +471,26 @@ def _generate_response(prompt: str, app_config=None) -> str:
"json",
"--system-prompt",
CLAUDE_CODE_SYSTEM_PROMPT,
- "--disallowed-tools",
- CLAUDE_CODE_DISALLOWED_TOOLS,
- "--strict-mcp-config",
+ # 关闭全部内置工具,保证只做文本生成。
+ "--tools",
+ "",
+ # 关闭 CLAUDE.md、skills、hooks、plugins、MCP 等用户级定制;
+ # 鉴权与模型选择不受影响(不能用 --bare,它会禁用 OAuth)。
+ "--safe-mode",
]
# 模型名留空时沿用 CLI 自己的默认模型,避免这里硬编码的模型 ID
# 随订阅可用模型变化而失效。
if model_name:
command += ["--model", model_name]
+ cli_env, removed_env = build_claude_code_env()
+ if removed_env:
+ # 只记录变量名,不记录取值,避免把密钥写进日志。
+ logger.warning(
+ f"{llm_provider}: ignoring conflicting environment variables "
+ f"so the subscription login is used: {', '.join(removed_env)}"
+ )
+
logger.info(f"invoking claude cli, model: {model_name or 'cli default'}")
# CLI 会读取工作目录下的 CLAUDE.md 和项目设置,这些内容会污染
# 文案结果,因此固定在一个临时空目录中执行。
@@ -435,6 +502,7 @@ def _generate_response(prompt: str, app_config=None) -> str:
text=True,
timeout=timeout_seconds,
cwd=work_dir,
+ env=cli_env,
)
except subprocess.TimeoutExpired:
raise Exception(
@@ -453,6 +521,12 @@ def _generate_response(prompt: str, app_config=None) -> str:
if payload is None:
detail = (completed.stderr or stdout or "").strip()
+ if "unknown option" in detail.lower():
+ raise Exception(
+ f"[{llm_provider}] the installed claude CLI does not support "
+ f"the required isolation flags; upgrade to "
+ f"{CLAUDE_CODE_MIN_CLI_VERSION} or newer: {detail[:300]}"
+ )
if completed.returncode != 0:
raise Exception(
f"[{llm_provider}] claude cli exited with code "
diff --git a/config.example.toml b/config.example.toml
index 40dec699..5255e0a4 100644
--- a/config.example.toml
+++ b/config.example.toml
@@ -356,10 +356,12 @@ ollama_model_name = ""
# CLAUDE_CODE_OAUTH_TOKEN (needed for Docker)
# Leave model_name empty to use the CLI's current default model, or set one such
# as "claude-opus-5" / "claude-sonnet-5". Leave cli_path empty to resolve
-# `claude` from PATH. Calls count against your Claude subscription usage limits.
+# `claude` from PATH. Leave timeout empty to use the 300s default.
+# Calls use your Claude subscription usage limits; conflicting ANTHROPIC_* and
+# CLAUDE_CODE_USE_* environment variables are removed before the CLI runs.
claude_code_model_name = ""
claude_code_cli_path = ""
-claude_code_timeout = "300"
+claude_code_timeout = ""
# OneAPI. Use the token, Base URL, and model ID from your OneAPI deployment.
# Project: https://github.com/songquanpeng/one-api
diff --git a/test/services/test_llm.py b/test/services/test_llm.py
index 028b883f..58cf831c 100644
--- a/test/services/test_llm.py
+++ b/test/services/test_llm.py
@@ -177,9 +177,7 @@ class TestScriptPromptOptions(unittest.TestCase):
with patch.object(
llm, "_generate_response", side_effect=fake_generate_response
):
- result = llm.generate_script(
- video_subject="savings tips", language="en-US"
- )
+ result = llm.generate_script(video_subject="savings tips", language="en-US")
# Each bracket / paren group should be gone, but the surrounding words
# must survive.
@@ -374,6 +372,7 @@ class TestLiteLLMProvider(unittest.TestCase):
"evolink",
"openrouter",
"ollama",
+ "claude_code",
"oneapi",
"litellm",
"groq",
@@ -477,9 +476,7 @@ class TestLiteLLMProvider(unittest.TestCase):
default_model=provider.default_model,
default_base_url=provider.effective_default_base_url,
model_docs_url=(
- default_endpoint.model_docs_url
- if default_endpoint
- else ""
+ default_endpoint.model_docs_url if default_endpoint else ""
),
docker_hint="",
**{
@@ -538,9 +535,7 @@ class TestLiteLLMProvider(unittest.TestCase):
default_model=provider.default_model,
default_base_url=provider.effective_default_base_url,
model_docs_url=(
- default_endpoint.model_docs_url
- if default_endpoint
- else ""
+ default_endpoint.model_docs_url if default_endpoint else ""
),
docker_hint="",
**{
@@ -1609,6 +1604,289 @@ class TestLiteLLMProvider(unittest.TestCase):
self.assertIn("unsupported llm provider", result)
+class TestClaudeCodeProvider(unittest.TestCase):
+ """claude_code Provider 通过本机 claude CLI 调用订阅账号,不走 HTTP API。"""
+
+ def setUp(self):
+ self.original_app_config = dict(config.app)
+ config.app["llm_provider"] = "claude_code"
+ config.app["claude_code_model_name"] = ""
+ config.app["claude_code_cli_path"] = ""
+ config.app["claude_code_timeout"] = ""
+
+ def tearDown(self):
+ config.app.clear()
+ config.app.update(self.original_app_config)
+
+ @staticmethod
+ def _completed(stdout="", stderr="", returncode=0):
+ return types.SimpleNamespace(
+ stdout=stdout, stderr=stderr, returncode=returncode
+ )
+
+ @staticmethod
+ def _cli_payload(result, is_error=False):
+ return json.dumps(
+ {
+ "type": "result",
+ "subtype": "success",
+ "is_error": is_error,
+ "result": result,
+ }
+ )
+
+ # ------------------------------------------------------------- success
+ def test_successful_generation_returns_cli_result_text(self):
+ """CLI 返回的 JSON 中只有 result 是正文,其余字段不应泄漏到脚本里。"""
+ with (
+ patch.object(llm.shutil, "which", return_value="/usr/bin/claude"),
+ patch.object(
+ llm.subprocess,
+ "run",
+ return_value=self._completed(stdout=self._cli_payload("Hello world")),
+ ) as run,
+ ):
+ self.assertEqual(llm._generate_response("write something"), "Hello world")
+
+ command = run.call_args.args[0]
+ self.assertEqual(command[0], "/usr/bin/claude")
+ self.assertIn("-p", command)
+ self.assertEqual(
+ run.call_args.kwargs["timeout"], llm.CLAUDE_CODE_DEFAULT_TIMEOUT
+ )
+
+ def test_generation_disables_tools_and_user_customizations(self):
+ """纯文本生成必须关闭全部工具和用户级定制,避免读写文件或加载 skills。"""
+ with (
+ patch.object(llm.shutil, "which", return_value="/usr/bin/claude"),
+ patch.object(
+ llm.subprocess,
+ "run",
+ return_value=self._completed(stdout=self._cli_payload("ok")),
+ ) as run,
+ ):
+ llm._generate_response("write something")
+
+ command = run.call_args.args[0]
+ self.assertIn("--tools", command)
+ self.assertEqual(command[command.index("--tools") + 1], "")
+ self.assertIn("--safe-mode", command)
+ self.assertIn("--system-prompt", command)
+ self.assertEqual(
+ command[command.index("--system-prompt") + 1],
+ llm.CLAUDE_CODE_SYSTEM_PROMPT,
+ )
+
+ def test_model_name_is_only_passed_when_configured(self):
+ """模型名留空时应沿用 CLI 默认模型,而不是硬编码一个可能失效的 ID。"""
+ with (
+ patch.object(llm.shutil, "which", return_value="/usr/bin/claude"),
+ patch.object(
+ llm.subprocess,
+ "run",
+ return_value=self._completed(stdout=self._cli_payload("ok")),
+ ) as run,
+ ):
+ llm._generate_response("write something")
+ self.assertNotIn("--model", run.call_args.args[0])
+
+ config.app["claude_code_model_name"] = "claude-opus-5"
+ llm._generate_response("write something")
+ command = run.call_args.args[0]
+ self.assertEqual(command[command.index("--model") + 1], "claude-opus-5")
+
+ # ------------------------------------------------- credential isolation
+ def test_conflicting_credentials_are_removed_from_subprocess_env(self):
+ """环境里的 API Key 会让 CLI 绕过订阅登录并产生 API 计费,必须剔除。"""
+ polluted = {
+ "PATH": "/usr/bin",
+ "ANTHROPIC_API_KEY": "sk-ant-api03-should-not-be-used",
+ "ANTHROPIC_BASE_URL": "https://proxy.example.com",
+ "CLAUDE_CODE_USE_BEDROCK": "1",
+ "CLAUDE_CODE_OAUTH_TOKEN": "sk-ant-oat01-subscription",
+ }
+ env, removed = llm.build_claude_code_env(polluted)
+
+ self.assertNotIn("ANTHROPIC_API_KEY", env)
+ self.assertNotIn("ANTHROPIC_BASE_URL", env)
+ self.assertNotIn("CLAUDE_CODE_USE_BEDROCK", env)
+ # 订阅令牌是容器内唯一的鉴权方式,必须保留。
+ self.assertEqual(env["CLAUDE_CODE_OAUTH_TOKEN"], "sk-ant-oat01-subscription")
+ self.assertEqual(env["PATH"], "/usr/bin")
+ self.assertCountEqual(
+ removed,
+ ["ANTHROPIC_API_KEY", "ANTHROPIC_BASE_URL", "CLAUDE_CODE_USE_BEDROCK"],
+ )
+
+ def test_clean_environment_is_left_unchanged(self):
+ env, removed = llm.build_claude_code_env({"PATH": "/usr/bin"})
+ self.assertEqual(env, {"PATH": "/usr/bin"})
+ self.assertEqual(removed, [])
+
+ def test_subprocess_receives_sanitized_environment(self):
+ """适配器必须真的把清理后的环境传给子进程,而不只是计算一遍。"""
+ with (
+ patch.object(llm.shutil, "which", return_value="/usr/bin/claude"),
+ patch.dict(
+ os.environ, {"ANTHROPIC_API_KEY": "sk-ant-api03-x"}, clear=False
+ ),
+ patch.object(
+ llm.subprocess,
+ "run",
+ return_value=self._completed(stdout=self._cli_payload("ok")),
+ ) as run,
+ ):
+ llm._generate_response("write something")
+
+ self.assertNotIn("ANTHROPIC_API_KEY", run.call_args.kwargs["env"])
+
+ # ------------------------------------------------------- timeout config
+ def test_timeout_accepts_numeric_and_string_values(self):
+ """TOML 里 300 是 int,"300" 是 str,两种写法都必须支持。"""
+ self.assertEqual(llm.coerce_claude_code_timeout(300), 300.0)
+ self.assertEqual(llm.coerce_claude_code_timeout(300.5), 300.5)
+ self.assertEqual(llm.coerce_claude_code_timeout("300"), 300.0)
+ self.assertEqual(llm.coerce_claude_code_timeout(" 300 "), 300.0)
+ self.assertEqual(
+ llm.coerce_claude_code_timeout(""), llm.CLAUDE_CODE_DEFAULT_TIMEOUT
+ )
+ self.assertEqual(
+ llm.coerce_claude_code_timeout(None), llm.CLAUDE_CODE_DEFAULT_TIMEOUT
+ )
+
+ def test_timeout_rejects_non_finite_and_invalid_values(self):
+ """nan / inf 会让 subprocess 永久阻塞,必须在配置阶段就拒绝。"""
+ for invalid in (
+ float("nan"),
+ float("inf"),
+ float("-inf"),
+ "nan",
+ "inf",
+ "-inf",
+ 0,
+ -5,
+ "abc",
+ True,
+ [300],
+ ):
+ with self.subTest(invalid=invalid):
+ with self.assertRaises(ValueError):
+ llm.coerce_claude_code_timeout(invalid)
+
+ def test_integer_timeout_in_config_is_accepted(self):
+ """回归测试:int 超时曾触发 'int' object has no attribute 'strip'。"""
+ config.app["claude_code_timeout"] = 30
+ with (
+ patch.object(llm.shutil, "which", return_value="/usr/bin/claude"),
+ patch.object(
+ llm.subprocess,
+ "run",
+ return_value=self._completed(stdout=self._cli_payload("ok")),
+ ) as run,
+ ):
+ self.assertEqual(llm._generate_response("write something"), "ok")
+ self.assertEqual(run.call_args.kwargs["timeout"], 30.0)
+
+ def test_invalid_timeout_reports_configuration_error(self):
+ config.app["claude_code_timeout"] = "soon"
+ with patch.object(llm.shutil, "which", return_value="/usr/bin/claude"):
+ response = llm._generate_response("write something")
+ self.assertIn("claude_code_timeout", response)
+ self.assertTrue(response.startswith("Error:"), response)
+
+ # -------------------------------------------------------- failure modes
+ def test_missing_cli_reports_actionable_error(self):
+ with (
+ patch.object(llm.shutil, "which", return_value=None),
+ patch.object(llm.os.path, "isfile", return_value=False),
+ ):
+ response = llm._generate_response("write something")
+ self.assertIn("claude CLI not found", response)
+
+ def test_missing_login_reports_setup_token_hint(self):
+ """容器内无法执行交互式 /login,错误提示必须给出可用的替代方式。"""
+ payload = self._cli_payload("Not logged in · Please run /login", is_error=True)
+ with (
+ patch.object(llm.shutil, "which", return_value="/usr/bin/claude"),
+ patch.object(
+ llm.subprocess,
+ "run",
+ return_value=self._completed(stdout=payload, returncode=1),
+ ),
+ ):
+ response = llm._generate_response("write something")
+ self.assertIn("Not logged in", response)
+ self.assertIn("setup-token", response)
+ self.assertIn("CLAUDE_CODE_OAUTH_TOKEN", response)
+
+ def test_exhausted_quota_surfaces_cli_message(self):
+ """用量耗尽同样是 is_error + 非零退出码,需要原样透出可读原因。"""
+ payload = self._cli_payload(
+ "Claude usage limit reached. Your limit will reset at 5pm.", is_error=True
+ )
+ with (
+ patch.object(llm.shutil, "which", return_value="/usr/bin/claude"),
+ patch.object(
+ llm.subprocess,
+ "run",
+ return_value=self._completed(stdout=payload, returncode=1),
+ ),
+ ):
+ response = llm._generate_response("write something")
+ self.assertIn("usage limit reached", response)
+
+ def test_timeout_is_reported_with_configured_seconds(self):
+ config.app["claude_code_timeout"] = 12
+ with (
+ patch.object(llm.shutil, "which", return_value="/usr/bin/claude"),
+ patch.object(
+ llm.subprocess,
+ "run",
+ side_effect=llm.subprocess.TimeoutExpired(cmd="claude", timeout=12),
+ ),
+ ):
+ response = llm._generate_response("write something")
+ self.assertIn("timed out after 12s", response)
+
+ def test_malformed_output_is_reported_instead_of_crashing(self):
+ with (
+ patch.object(llm.shutil, "which", return_value="/usr/bin/claude"),
+ patch.object(
+ llm.subprocess,
+ "run",
+ return_value=self._completed(stdout="not json at all"),
+ ),
+ ):
+ response = llm._generate_response("write something")
+ self.assertIn("invalid response", response)
+
+ def test_empty_output_is_reported(self):
+ with (
+ patch.object(llm.shutil, "which", return_value="/usr/bin/claude"),
+ patch.object(
+ llm.subprocess, "run", return_value=self._completed(stdout=" ")
+ ),
+ ):
+ response = llm._generate_response("write something")
+ self.assertTrue(response.startswith("Error:"), response)
+
+ def test_unsupported_cli_version_reports_upgrade_hint(self):
+ """旧版 CLI 没有 --tools / --safe-mode,应提示升级而不是丢出裸 stderr。"""
+ with (
+ patch.object(llm.shutil, "which", return_value="/usr/bin/claude"),
+ patch.object(
+ llm.subprocess,
+ "run",
+ return_value=self._completed(
+ stderr="error: unknown option '--safe-mode'", returncode=1
+ ),
+ ),
+ ):
+ response = llm._generate_response("write something")
+ self.assertIn("upgrade", response.lower())
+ self.assertIn(llm.CLAUDE_CODE_MIN_CLI_VERSION, response)
+
+
class TestRuntimeEnvironmentDetection(unittest.TestCase):
def test_container_detection_ignores_plain_linux_cgroup_file(self):
"""
@@ -1881,9 +2159,7 @@ class TestRetryWarningBoundary(unittest.TestCase):
def _trying_again_count(self, mock_logger: object, fragment: str) -> int:
return sum(
- 1
- for call in mock_logger.warning.call_args_list
- if fragment in str(call)
+ 1 for call in mock_logger.warning.call_args_list if fragment in str(call)
)
def test_generate_script_no_spurious_warning_on_last_attempt(self):
diff --git a/webui/i18n/en.json b/webui/i18n/en.json
index 5897d2c6..6af172eb 100644
--- a/webui/i18n/en.json
+++ b/webui/i18n/en.json
@@ -422,7 +422,7 @@
"llm_provider_endpoint.moonshot.global": "Global",
"llm_provider_authentication_error.moonshot": "Authentication failed. Make sure the API Key matches the selected Kimi platform. China uses platform.kimi.com with api.moonshot.cn; Global uses platform.kimi.ai with api.moonshot.ai. Current Base URL: {base_url}. Provider response: {error}",
"llm_provider_tips.ollama": "##### Ollama Configuration\n- **API Key**: not required\n- **Base Url**: usually `http://localhost:11434/v1` for local runs or `http://host.docker.internal:11434/v1` for Docker{docker_hint}\n- **Model Name**: required; run `ollama list` and enter an installed model, such as `qwen:7b`",
- "llm_provider_tips.claude_code": "##### Claude Code Configuration\n- **API Key**: not required; the local `claude` CLI authenticates with your Claude subscription (Pro / Max / Team)\n- **Model Name**: optional; leave empty to use the CLI default, or set `claude-opus-5` / `claude-sonnet-5`\n- **Claude CLI Path**: optional; leave empty to resolve `claude` from PATH\n- Requires the CLI to be installed and logged in where MoneyPrinterTurbo runs. In Docker, pass a `claude setup-token` token as `CLAUDE_CODE_OAUTH_TOKEN`\n- Requests count against your Claude subscription usage limits, not API credit",
+ "llm_provider_tips.claude_code": "##### Claude Code Configuration\n- **API Key**: not required; the local `claude` CLI authenticates with your Claude subscription (Pro / Max / Team)\n- **Base Url**: not required\n- **Model Name**: optional; leave empty to use the CLI default, or set `claude-opus-5` / `claude-sonnet-5`\n- **Claude CLI Path**: optional; leave empty to resolve `claude` from PATH\n- Requires the CLI to be installed and logged in where MoneyPrinterTurbo runs. In Docker, pass a `claude setup-token` token as `CLAUDE_CODE_OAUTH_TOKEN`\n- Requests use your Claude subscription usage limits. Conflicting `ANTHROPIC_*` / `CLAUDE_CODE_USE_*` environment variables are stripped before the CLI runs, so an API key in the environment cannot silently bill your API account",
"llm_provider_tips.ollama.docker_hint": "\n > Container environment detected. If Base Url is empty, `http://host.docker.internal:11434/v1` is used by default.\n",
"llm_provider_tips.openai": "##### OpenAI Configuration\n- **API Key**: create one on the [OpenAI Platform]({api_key_url})\n- **Base Url**: defaults to `{default_base_url}`; enter another endpoint when using a compatible service\n- **Model Name**: defaults to `{default_model}`; you can also enter another model ID available to your account\n> Accessing the official service may require a network proxy in some regions",
"llm_provider_tips.anthropic": "##### Anthropic Claude Configuration\n- **API Key**: create one in the [Claude Console]({api_key_url})\n- **Base Url**: defaults to `{default_base_url}`, the OpenAI-compatible endpoint provided by Anthropic\n- **Model Name**: defaults to `{default_model}`; you can also enter another Claude model ID available to your account",
diff --git a/webui/i18n/zh.json b/webui/i18n/zh.json
index 92957425..0af3ed4f 100644
--- a/webui/i18n/zh.json
+++ b/webui/i18n/zh.json
@@ -422,7 +422,7 @@
"llm_provider_endpoint.moonshot.global": "国际站",
"llm_provider_authentication_error.moonshot": "鉴权失败。请确认 API Key 与所选 Kimi 平台一致:中国站使用 platform.kimi.com 和 api.moonshot.cn,国际站使用 platform.kimi.ai 和 api.moonshot.ai。当前 Base URL:{base_url}。平台返回:{error}",
"llm_provider_tips.ollama": "##### Ollama 配置说明\n- **API Key**: 无需填写\n- **Base Url**: 本机运行时通常为 `http://localhost:11434/v1`;Docker 部署时通常为 `http://host.docker.internal:11434/v1`{docker_hint}\n- **Model Name**: 必填;运行 `ollama list` 查看本机已安装的模型,例如 `qwen:7b`",
- "llm_provider_tips.claude_code": "##### Claude Code 配置说明\n- **API Key**:不需要;由本机 `claude` CLI 使用你的 Claude 订阅(Pro / Max / Team)完成鉴权\n- **Model Name**:可选;留空则使用 CLI 默认模型,也可填写 `claude-opus-5` / `claude-sonnet-5`\n- **Claude CLI Path**:可选;留空则从 PATH 中查找 `claude`\n- 运行 MoneyPrinterTurbo 的环境中必须已安装并登录 CLI;Docker 环境需将 `claude setup-token` 生成的令牌通过 `CLAUDE_CODE_OAUTH_TOKEN` 传入\n- 调用消耗的是 Claude 订阅额度,不消耗 API 余额",
+ "llm_provider_tips.claude_code": "##### Claude Code 配置说明\n- **API Key**:不需要;由本机 `claude` CLI 使用你的 Claude 订阅(Pro / Max / Team)完成鉴权\n- **Base Url**:不需要\n- **Model Name**:可选;留空则使用 CLI 默认模型,也可填写 `claude-opus-5` / `claude-sonnet-5`\n- **Claude CLI Path**:可选;留空则从 PATH 中查找 `claude`\n- 运行 MoneyPrinterTurbo 的环境中必须已安装并登录 CLI;Docker 环境需将 `claude setup-token` 生成的令牌通过 `CLAUDE_CODE_OAUTH_TOKEN` 传入\n- 调用消耗 Claude 订阅额度。执行前会剔除 `ANTHROPIC_*` / `CLAUDE_CODE_USE_*` 等冲突环境变量,避免环境中的 API Key 意外产生 API 计费",
"llm_provider_tips.ollama.docker_hint": "\n > 检测到容器环境,未配置 Base Url 时会默认使用 `http://host.docker.internal:11434/v1`\n",
"llm_provider_tips.openai": "##### OpenAI 配置说明\n- **API Key**: 在 [OpenAI Platform]({api_key_url}) 创建\n- **Base Url**: 默认 `{default_base_url}`;使用兼容服务时可填写对应地址\n- **Model Name**: 默认 `{default_model}`;也可以填写当前账号支持的其它模型 ID\n> 部分地区访问官方服务时可能需要配置网络代理",
"llm_provider_tips.anthropic": "##### Anthropic Claude 配置说明\n- **API Key**: 在 [Claude Console]({api_key_url}) 创建\n- **Base Url**: 默认 `{default_base_url}`,即 Anthropic 提供的 OpenAI 兼容端点\n- **Model Name**: 默认 `{default_model}`;也可以填写当前账号支持的其它 Claude 模型 ID",