Add settings option to ClaudeCodeOptions (anthropics#100)

- Add `settings` field to `ClaudeCodeOptions` to expose the `--settings`
CLI flag
- Allow SDK users to specify custom settings configuration path

- Added `settings: str | None = None` field to `ClaudeCodeOptions`
dataclass
- Added CLI argument conversion logic in `SubprocessCLITransport` to
pass `--settings` flag to Claude Code CLI

- [x] All existing tests pass
- [x] Linting passes (`python -m ruff check`)
- [x] Type checking passes (`python -m mypy src/`)

🤖 Generated with [Claude Code](https://claude.ai/code)

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: 2 people

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.0.18
+
+- Add `ClaudeCodeOptions.settings` for `--settings`
+
+## 0.0.17
+
+- Remove dependency on asyncio for Trio compatibility
+
 ## 0.0.16
 
 - Introduce ClaudeSDKClient for bidirectional streaming conversation

src/claude_code_sdk/_internal/transport/subprocess_cli.py

@@ -128,6 +128,9 @@ def _build_command(self) -> list[str]:
         if self._options.resume:
             cmd.extend(["--resume", self._options.resume])
 
+        if self._options.settings:
+            cmd.extend(["--settings", self._options.settings])
+
         if self._options.mcp_servers:
             cmd.extend(
                 ["--mcp-config", json.dumps({"mcpServers": self._options.mcp_servers})]

src/claude_code_sdk/types.py

@@ -126,4 +126,5 @@ class ClaudeCodeOptions:
     disallowed_tools: list[str] = field(default_factory=list)
     model: str | None = None
     permission_prompt_tool_name: str | None = None
-    cwd: str | Path | None = None
+    cwd: str | Path | None = None
+    settings: str | None = None